---
title: "Setup logging FastAPI dan tangani error tanpa kehilangan traceback"
description: "FastAPI tidak mencetak log info apa pun sampai kami mengatur logging, dan hanya uvicorn yang mencetak traceback error 500. Ini setup-nya, handler error, dan LogBrew, diuji di FastAPI 0.165."
canonical: "https://logbrew.co/id/guides/fastapi-logging"
last_updated: "2026-11-21"
---

# Setup logging FastAPI dan tangani error tanpa kehilangan traceback

FastAPI tidak mencetak log `info` apa pun sampai kami mengatur logging, dan hanya uvicorn yang mencetak traceback error 500. Ini setup-nya, handler error, dan LogBrew, diuji di FastAPI 0.165.

Diuji pada 21 November 2026 dengan Python 3.13.5, FastAPI 0.165.0, uvicorn 0.54.0, logbrew-sdk 0.1.29, logbrew-fastapi 0.1.14, dan logbrew CLI 0.1.96

Oleh [Furkan Erday](https://github.com/furkanerday). Furkan Erday adalah pendiri LogBrew. Setiap hari ia membangun LogBrew dengan Claude Code dan Codex.

Canonical: https://logbrew.co/id/guides/fastapi-logging

## Apa yang dicetak FastAPI tanpa setup, dan apa yang diterima LogBrew

| Event | Dicetak tanpa setup | Masalah atau log di LogBrew |
| --- | --- | --- |
| `logger.debug()` | Dibuang | Dibuang di `INFO` |
| `logger.info()` | Dibuang | Log `info` |
| `logger.warning()` | Hanya pesan | Log `warning` |
| `ValueError` di rute | Traceback dari uvicorn | Masalah |
| Nilai path bukan angka, 422 | Hanya baris akses | Span, tanpa masalah |
| `HTTPException`, 404 | Hanya baris akses | Span, tanpa masalah |

6 event di FastAPI 0.165.0 dengan uvicorn 0.54.0, lalu yang sama dengan `basicConfig()` dan logbrew-fastapi 0.1.14.

## Catat log dari aplikasi FastAPI

### Lihat apa yang dicetak FastAPI tanpa setup

Aplikasi kami punya 1 logger bernama `taproom` dan 3 rute. Kami menjalankannya dengan `uvicorn main:app`. uvicorn hanya mengatur logger miliknya sendiri, jadi Python mencetak `warning` ke atas sebagai teks polos, lalu membuang `debug` dan `info`.

```bash
import logging

from fastapi import FastAPI, HTTPException

app = FastAPI()
logger = logging.getLogger("taproom")


@app.get("/taps/{tap}")
def pour(tap: str):
    logger.debug("keg pressure read")
    logger.info("tap %s opened", tap)
    logger.warning("keg below 10%")
    logger.error("keg empty")
    logger.critical("cooler offline")
    return {"tap": tap}


@app.get("/kegs/{keg_id}")
def keg(keg_id: int):
    raise ValueError(f"keg {keg_id} is empty")


@app.get("/missing")
def missing():
    raise HTTPException(status_code=404, detail="no such tap")
```

Output

```text
keg below 10%
keg empty
cooler offline
INFO:     127.0.0.1:51421 - "GET /taps/ipa HTTP/1.1" 200 OK
```

### Panggil basicConfig() sebelum membuat aplikasi

`logging.basicConfig()` memberi root logger sebuah level dan format. Baris `taproom` sekarang menampilkan level-nya, dan `info` muncul. uvicorn tetap memakai format miliknya.

```bash
import logging
import os

from fastapi import FastAPI, HTTPException

logging.basicConfig(
    level=os.environ.get("LOG_LEVEL", "INFO"),
    format="%(levelname)s %(name)s %(message)s",
)

app = FastAPI()
logger = logging.getLogger("taproom")
```

Output

```text
INFO taproom tap ipa opened
WARNING taproom keg below 10%
ERROR taproom keg empty
CRITICAL taproom cooler offline
INFO:     127.0.0.1:51428 - "GET /taps/ipa HTTP/1.1" 200 OK
```

### Baca level dari variabel lingkungan

Panggilan `basicConfig()` di atas membaca `LOG_LEVEL`. Jalankan uvicorn dengan `LOG_LEVEL=DEBUG`, dan baris `debug` muncul tanpa mengubah kode.

```bash
LOG_LEVEL=DEBUG uvicorn main:app
```

Output

```text
DEBUG taproom keg pressure read
INFO taproom tap ipa opened
WARNING taproom keg below 10%
ERROR taproom keg empty
CRITICAL taproom cooler offline
INFO:     127.0.0.1:51442 - "GET /taps/ipa HTTP/1.1" 200 OK
```

## Tangani error di FastAPI

### Lihat apa yang dicetak exception yang tidak tertangani

Klien menerima `Internal Server Error` dengan status 500. uvicorn mencetak `Exception in ASGI application` dan traceback. Path `/kegs/abc` mengembalikan 422 dengan daftar `detail`, dan `HTTPException` mengembalikan `detail` miliknya dengan 404. Keduanya tidak mencetak traceback. Kami memotong 27 frame dari uvicorn, Starlette, dan FastAPI.

```bash
curl localhost:8000/kegs/7
curl localhost:8000/kegs/abc
curl localhost:8000/missing
```

Output

```text
INFO:     127.0.0.1:51422 - "GET /kegs/7 HTTP/1.1" 500 Internal Server Error
ERROR:    Exception in ASGI application
Traceback (most recent call last):
  …
  File "main.py", line 21, in keg
    raise ValueError(f"keg {keg_id} is empty")
ValueError: keg 7 is empty
INFO:     127.0.0.1:51423 - "GET /kegs/abc HTTP/1.1" 422 Unprocessable Content
INFO:     127.0.0.1:51424 - "GET /missing HTTP/1.1" 404 Not Found
```

### Tambahkan exception handler untuk Exception

Handler mencatat error dan mengembalikan JSON milikmu sendiri, dan klien menerima `{"error":"internal"}`. uvicorn tetap mencetak traceback, karena Starlette melempar exception itu lagi setelah mengirim respons kamu. Jadi traceback muncul 2 kali.

```bash
from fastapi import Request
from fastapi.responses import JSONResponse


@app.exception_handler(Exception)
async def on_error(request: Request, exc: Exception):
    logger.exception("request failed")
    return JSONResponse({"error": "internal"}, status_code=500)
```

Output

```text
ERROR taproom request failed
Traceback (most recent call last):
  …
  File "main.py", line 34, in keg
    raise ValueError(f"keg {keg_id} is empty")
ValueError: keg 7 is empty
INFO:     127.0.0.1:51436 - "GET /kegs/7 HTTP/1.1" 500 Internal Server Error
ERROR:    Exception in ASGI application
Traceback (most recent call last):
  …
  File "main.py", line 34, in keg
    raise ValueError(f"keg {keg_id} is empty")
ValueError: keg 7 is empty
```

## Kirim log dan error FastAPI ke LogBrew

### Pasang paketnya

`logbrew-fastapi` juga memasang `logbrew-sdk`. Pakai kunci server dari proyek LogBrew kamu.

```bash
python3 -m pip install logbrew-sdk logbrew-fastapi
```

### Panggil init_logbrew() setelah membuat aplikasi

`init_logbrew()` mencatat span untuk tiap permintaan dan mencatat tiap error yang tidak tertangani sebagai masalah. `logbrew.logging_handler` mengirim record dari logger kamu. Kami mengirim ke server LogBrew lokal, jadi salinan kami juga memberikan `transport`.

```bash
import logging
import os

from fastapi import FastAPI, HTTPException
from logbrew_fastapi import init_logbrew

logging.basicConfig(
    level=os.environ.get("LOG_LEVEL", "INFO"),
    format="%(levelname)s %(name)s %(message)s",
)

app = FastAPI()
logbrew = init_logbrew(
    app, api_key=os.environ["LOGBREW_API_KEY"], service_name="taproom"
)
logger = logging.getLogger("taproom")
logger.addHandler(logbrew.logging_handler)
```

### Baca kembali masalah dan log-nya

Kami mengirim 4 permintaan yang sama lagi lalu membaca proyek dengan kunci baca. Error 500 menjadi 1 masalah yang diberi nama sesuai template rute. Ke-4 log dari `/taps/ipa` memakai 1 trace ID yang sama. 422 dan 404 tidak membuat masalah.

```bash
logbrew issues --since 1h
logbrew read logs --since 1h
```

Output

```text
Issues (1)
- b100cd3d-f932-57c7-8f23-38067f1c87d7 unresolved error priority=medium GET /kegs/{keg_id} failed occurrences=1 users=unknown last_seen=2026-11-21T06:44:18.663Z service=taproom trace=6b642297fc5d4259b1f17f2bf83b1abb assignee=unassigned [unversioned / production]
Logs (4)
- error keg empty service=taproom trace=fcc0eaf7997f4e0796c0b76e0678b455 [unversioned / production]
- warning keg below 10% service=taproom trace=fcc0eaf7997f4e0796c0b76e0678b455 [unversioned / production]
- critical cooler offline service=taproom trace=fcc0eaf7997f4e0796c0b76e0678b455 [unversioned / production]
- info tap ipa opened service=taproom trace=fcc0eaf7997f4e0796c0b76e0678b455 [unversioned / production]
```

### Cek apa yang disimpan masalah

Masalah menyimpan tipe exception, rute, dan 21 frame stack, tapi tidak menyimpan pesannya. LogBrew menulis `Unhandled exception` sebagai gantinya.

```bash
logbrew issues --since 1h --json | jq '.[0].attributes | {
  message, exception,
  route: .metadata.routeTemplate,
  frames: (.stackFrames | length)
}'
```

Output

```text
{
  "message": "Unhandled exception",
  "exception": {
    "mechanism": {
      "handled": false,
      "type": "fastapi.middleware"
    },
    "type": "ValueError"
  },
  "route": "/kegs/{keg_id}",
  "frames": 21
}
```

### Simpan pesannya dengan exception handler kamu

Dengan exception handler dari atas, LogBrew tetap mencatat masalahnya, dan log `request failed` menyimpan pesan yang tidak disimpan masalah.

```bash
logbrew read logs --since 1h --severity error \
  --search "request failed" --json | jq '.[0] | {
  message,
  exceptionName: .attributes.metadata.exceptionName,
  exceptionMessage: .attributes.metadata.exceptionMessage
}'
```

Output

```text
{
  "message": "request failed",
  "exceptionName": "ValueError",
  "exceptionMessage": "keg 7 is empty"
}
```

## Hasil pengujian kami

Kami menjalankan 1 aplikasi FastAPI 0.165.0 dengan uvicorn 0.54.0 di Python 3.13.5, memanggil tiap rute dengan curl, lalu membaca output server. Setelah itu kami menambahkan logbrew-fastapi 0.1.14 dan membaca apa yang disimpan server LogBrew lokal.

uvicorn mencetak traceback tiap exception yang tidak tertangani, dengan atau tanpa handler. Error yang diubah FastAPI menjadi respons, seperti 422 atau `HTTPException`, hanya mencetak baris akses.

| Permintaan | `status_code` | Traceback dicetak | Masalah di LogBrew |
| --- | --- | --- | --- |
| `/kegs/7` | `500` | Ya | Ya |
| `/kegs/abc` | `422` | Tidak | Tidak |
| `/missing` | `404` | Tidak | Tidak |

## Level log FastAPI dan output uvicorn

Python punya 5 level, `DEBUG`, `INFO`, `WARNING`, `ERROR`, dan `CRITICAL`. Tanpa setup, root logger membuang tiap record di bawah `WARNING`.

uvicorn mencetak baris akses dan error-nya dalam format miliknya sendiri, dan `basicConfig()` tidak mengubahnya. LogBrew menyimpan `warning`, `error`, dan `critical` apa adanya, lalu menyimpan `DEBUG` dan `INFO` sebagai `info`.

|  | Tanpa setup | `basicConfig()` | LogBrew |
| --- | --- | --- | --- |
| `logger.debug()` | Tidak | Dengan `LOG_LEVEL=DEBUG` | Tidak |
| `logger.info()` | Tidak | Ya | `info` |
| `logger.warning()` | Ya | Ya | `warning` |
| `logger.error()` | Ya | Ya | `error` |
| `logger.critical()` | Ya | Ya | `critical` |

## Apa yang dicatat LogBrew

`init_logbrew()` mencatat 1 span per permintaan, diberi nama sesuai template rute, misalnya `GET /kegs/{keg_id}`. Exception yang tidak tertangani menambahkan masalah dengan tipe exception, mekanisme `fastapi.middleware`, `handled: false`, dan frame stack.

Log yang ditulis selama permintaan membawa trace ID permintaan itu. Permintaan 422 dan 404 membuat span tanpa error.

- `init_logbrew()`
  - Masalah: `GET /kegs/{keg_id} failed`
  - `exception.type`: `ValueError`
  - `mechanism`: `fastapi.middleware`
  - `handled`: `false`
  - Frame stack: 21
- `logbrew.logging_handler`
  - Pesan: `request failed`
  - `exceptionName`: `ValueError`
  - `exceptionMessage`: `keg 7 is empty`

## Pertanyaan yang sering diajukan

### Bagaimana cara mengatur logging di FastAPI?

Panggil `logging.basicConfig()` sekali di bagian atas `main.py`, lalu pakai `logging.getLogger()` di tiap modul. Tanpa setup, Python membuang `info` dan `debug`.

### Bagaimana cara menangani semua exception di FastAPI?

Tambahkan `@app.exception_handler(Exception)` dan kembalikan respons milikmu sendiri. Klien menerima respons kamu, dan uvicorn tetap mencetak traceback.

### Kenapa FastAPI mengembalikan 422?

Nilai path, query, atau body tidak cocok dengan tipenya. `/kegs/abc` gagal di pengecekan `keg_id: int`, jadi FastAPI mengembalikan daftar `detail` dengan status 422.

### Apa arti Exception in ASGI application?

Sebuah exception keluar dari rute kamu dan tidak ada handler yang menghentikannya. uvicorn mencatatnya beserta traceback, dan klien menerima `Internal Server Error` dengan status 500.

## Lihat tiap error FastAPI beserta rutenya

logbrew-fastapi mencatat tiap error yang tidak tertangani sebagai masalah dengan nama template rute, dan mengirim log kamu beserta trace permintaannya. Mulai dengan paket gratis yang lega, tanpa perlu kartu.

[Mulai gratis](https://logbrew.co/id)

## Sumber

- [FastAPI docs, Install custom exception handlers](https://fastapi.tiangolo.com/tutorial/handling-errors/#install-custom-exception-handlers)
- [FastAPI docs, Use HTTPException](https://fastapi.tiangolo.com/tutorial/handling-errors/#use-httpexception)
- [fastapi/fastapi#14071](https://github.com/fastapi/fastapi/discussions/14071)

## Panduan lain untuk agen, Python, Node.js, dan React

- [Tambahkan server MCP ke Claude Code dan Codex](https://logbrew.co/id/guides/mcp-server-claude-code-codex)
- [Pakai AGENTS.md di Claude Code dan Codex](https://logbrew.co/id/guides/agents-md)
- [Atasi error Claude overloaded 529 dan rate limit 429](https://logbrew.co/id/guides/claude-overloaded-rate-limit-error)
- [Siapkan Python logging dengan level log yang tepat dan penangkapan exception](https://logbrew.co/id/guides/python-logging)
- [Logging terstruktur dengan format log dan level log yang bisa dicari per field](https://logbrew.co/id/guides/structured-logging)
- [Siapkan logging Node.js dengan Pino atau Winston tanpa kehilangan satu error pun](https://logbrew.co/id/guides/node-logging)
- [Setup logging Django dan simpan traceback tiap error 500](https://logbrew.co/id/guides/django-logging)
- [Tambahkan error boundary React dan catat error yang lolos darinya](https://logbrew.co/id/guides/react-error-boundary)
- [Trace ID vs span ID, diurai dari header traceparent sungguhan](https://logbrew.co/id/guides/trace-id)
- [Panduan error, log, trace, metrik, dan rilis](https://logbrew.co/id/guides)
