---
title: "FastAPI loglamayı kur ve hataları yönet stack trace'i kaybetmeden"
description: "Loglamayı ayarlayana kadar FastAPI hiç info logu yazdırmadı, 500 hatasının stack trace'ini de sadece uvicorn yazdırdı. Loglama kurulumu, hata handler'ları ve LogBrew, FastAPI 0.165 üzerinde test edildi."
canonical: "https://logbrew.co/tr/guides/fastapi-logging"
last_updated: "2026-11-21"
---

# FastAPI loglamayı kur ve hataları yönet stack trace'i kaybetmeden

Loglamayı ayarlayana kadar FastAPI hiç `info` logu yazdırmadı, 500 hatasının stack trace'ini de sadece uvicorn yazdırdı. Loglama kurulumu, hata handler'ları ve LogBrew, FastAPI 0.165 üzerinde test edildi.

21 Kasım 2026 tarihinde Python 3.13.5, FastAPI 0.165.0, uvicorn 0.54.0, logbrew-sdk 0.1.29, logbrew-fastapi 0.1.14 ve logbrew CLI 0.1.96 ile test edildi

[Furkan Erday](https://github.com/furkanerday) tarafından. Furkan Erday, LogBrew'un kurucusu. LogBrew'u her gün Claude Code ve Codex ile geliştiriyor.

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

## FastAPI'nin ayarsız yazdırdıkları ve LogBrew'e gelenler

| Olay | Ayarsız yazdırılan | LogBrew'deki sorun ya da log |
| --- | --- | --- |
| `logger.debug()` | Atıldı | `INFO` seviyesinde atıldı |
| `logger.info()` | Atıldı | `info` logu |
| `logger.warning()` | Sadece mesaj | `warning` logu |
| Rotada `ValueError` | uvicorn stack trace'i | Sorun |
| Sayı olmayan yol değeri, 422 | Sadece erişim satırı | Span, sorun yok |
| `HTTPException`, 404 | Sadece erişim satırı | Span, sorun yok |

uvicorn 0.54.0 ile FastAPI 0.165.0 üzerinde 6 olay, sonra aynıları `basicConfig()` ve logbrew-fastapi 0.1.14 ile.

## Bir FastAPI uygulamasından logla

### FastAPI'nin ayarsız ne yazdırdığına bak

Uygulamamızda `taproom` adlı 1 logger ve 3 rota var. Onu `uvicorn main:app` ile başlattık. uvicorn sadece kendi logger'larını ayarlar, bu yüzden Python `warning` ve üstünü düz metin olarak yazdırdı, `debug` ve `info` satırlarını attı.

```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")
```

Çıktı

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

### Uygulamayı oluşturmadan önce basicConfig() çağır

`logging.basicConfig()` kök logger'a bir seviye ve bir format verir. Artık `taproom` satırları seviyeyi gösterir ve `info` görünür. uvicorn kendi formatını korur.

```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")
```

Çıktı

```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
```

### Seviyeyi ortam değişkeninden oku

Yukarıdaki `basicConfig()` çağrısı `LOG_LEVEL` değerini okur. uvicorn'u `LOG_LEVEL=DEBUG` ile başlat, kodu değiştirmeden `debug` satırı görünür.

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

Çıktı

```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
```

## FastAPI'de hataları yönet

### Yakalanmamış bir hatanın ne yazdırdığına bak

İstemci 500 durum koduyla `Internal Server Error` aldı. uvicorn `Exception in ASGI application` ve stack trace'i yazdırdı. `/kegs/abc` yolu bir `detail` listesiyle 422 döndürdü, `HTTPException` da kendi `detail` değerini 404 ile döndürdü. İkisi de stack trace yazdırmadı. uvicorn, Starlette ve FastAPI'den gelen 27 frame'i kestik.

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

Çıktı

```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
```

### `Exception` için bir exception handler ekle

Handler hatayı loglar ve kendi JSON'unu döndürür, istemci de `{"error":"internal"}` aldı. uvicorn yine de stack trace'i yazdırdı, çünkü Starlette yanıtını gönderdikten sonra hatayı tekrar fırlatır. Bu yüzden stack trace 2 kez göründü.

```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)
```

Çıktı

```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
```

## FastAPI log ve hatalarını LogBrew'e gönder

### Paketi kur

`logbrew-fastapi`, `logbrew-sdk` paketini de kurar. LogBrew projenden bir sunucu anahtarı kullan.

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

### Uygulamayı oluşturduktan sonra init_logbrew() çağır

`init_logbrew()` her istek için bir span, her yakalanmamış hata için bir sorun kaydeder. `logbrew.logging_handler` logger'ının kayıtlarını gönderir. Biz yerel bir LogBrew sunucusuna gönderdik, bu yüzden kopyamız ayrıca bir `transport` verdi.

```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)
```

### Sorunu ve logları geri oku

Aynı 4 isteği tekrar gönderdik ve projeyi bir okuma anahtarıyla okuduk. 500 hatası, rota şablonunun adıyla 1 sorun oldu. `/taps/ipa` isteğinden gelen 4 log aynı trace ID'yi taşıyor. 422 ve 404 hiç sorun oluşturmadı.

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

Çıktı

```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]
```

### Sorunun ne sakladığına bak

Sorun, hata türünü, rotayı ve 21 stack frame'i saklar ama mesajı saklamaz. LogBrew mesajın yerine `Unhandled exception` yazar.

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

Çıktı

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

### Mesajı kendi exception handler'ınla sakla

Yukarıdaki exception handler ile LogBrew sorunu yine kaydetti, `request failed` logu da sorunun dışarıda bıraktığı mesajı sakladı.

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

Çıktı

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

## Test ederken gördüklerimiz

Python 3.13.5 üzerinde uvicorn 0.54.0 ile 1 FastAPI 0.165.0 uygulaması çalıştırdık, her rotayı curl ile çağırdık ve sunucu çıktısını okuduk. Sonra logbrew-fastapi 0.1.14 ekledik ve yerel bir LogBrew sunucusunun ne sakladığını okuduk.

uvicorn, handler olsa da olmasa da her yakalanmamış hatanın stack trace'ini yazdırdı. FastAPI'nin yanıta çevirdiği hatalar, örneğin bir 422 ya da bir `HTTPException`, sadece erişim satırını verdi.

| İstek | `status_code` | Yazdırılan stack trace | LogBrew'deki sorun |
| --- | --- | --- | --- |
| `/kegs/7` | `500` | Evet | Evet |
| `/kegs/abc` | `422` | Hayır | Hayır |
| `/missing` | `404` | Hayır | Hayır |

## FastAPI log seviyeleri ve uvicorn çıktısı

Python'un 5 seviyesi var, `DEBUG`, `INFO`, `WARNING`, `ERROR` ve `CRITICAL`. Ayar yoksa kök logger `WARNING` altındaki her kaydı atar.

uvicorn erişim satırlarını ve hataları kendi formatında yazdırır, `basicConfig()` bunu değiştirmedi. LogBrew `warning`, `error` ve `critical` seviyelerini olduğu gibi tutar, `DEBUG` ve `INFO` seviyelerini `info` olarak saklar.

|  | Ayar olmadan | `basicConfig()` | LogBrew |
| --- | --- | --- | --- |
| `logger.debug()` | Hayır | `LOG_LEVEL=DEBUG` ile | Hayır |
| `logger.info()` | Hayır | Evet | `info` |
| `logger.warning()` | Evet | Evet | `warning` |
| `logger.error()` | Evet | Evet | `error` |
| `logger.critical()` | Evet | Evet | `critical` |

## LogBrew neleri kaydeder

`init_logbrew()` her istek için rota şablonunun adıyla 1 span kaydeder, örneğin `GET /kegs/{keg_id}`. Yakalanmamış bir hata, hata türü, `fastapi.middleware` mekanizması, `handled: false` ve stack frame'leriyle bir sorun ekler.

Bir istek sırasında yazılan log, o isteğin trace ID'sini taşır. 422 ve 404 istekleri hatasız span oluşturdu.

- `init_logbrew()`
  - Sorun: `GET /kegs/{keg_id} failed`
  - `exception.type`: `ValueError`
  - `mechanism`: `fastapi.middleware`
  - `handled`: `false`
  - Stack frame'leri: 21
- `logbrew.logging_handler`
  - Mesaj: `request failed`
  - `exceptionName`: `ValueError`
  - `exceptionMessage`: `keg 7 is empty`

## Sık sorulan sorular

### FastAPI'de loglamayı nasıl ayarlarım?

`main.py` dosyasının başında 1 kez `logging.basicConfig()` çağır, sonra her modülde `logging.getLogger()` kullan. Ayar yoksa Python `info` ve `debug` satırlarını atar.

### FastAPI'de tüm hataları nasıl yönetirim?

`@app.exception_handler(Exception)` ekle ve kendi yanıtını döndür. İstemci senin yanıtını alır, uvicorn yine de stack trace'i yazdırır.

### FastAPI neden 422 döndürüyor?

Yol, sorgu ya da gövdedeki bir değer türüyle eşleşmedi. `/kegs/abc`, `keg_id: int` kontrolünü geçemedi, bu yüzden FastAPI `detail` listesini 422 durum koduyla döndürdü.

### `Exception in ASGI application` ne anlama gelir?

Bir hata rotandan dışarı çıktı ve onu hiçbir handler durdurmadı. uvicorn hatayı stack trace ile loglar, istemci de 500 durum koduyla `Internal Server Error` alır.

## Her FastAPI hatasını rotasıyla birlikte gör

logbrew-fastapi her yakalanmamış hatayı rota şablonunun adıyla bir sorun olarak kaydeder ve loglarını isteklerinin trace'iyle birlikte gönderir. Cömert ücretsiz katmanla başla, kart gerekmez.

[Ücretsiz başla](https://logbrew.co/tr)

## Kaynaklar

- [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)

## Ajanlar, Python, Node.js ve React için diğer rehberler

- [Claude Code ve Codex'e MCP sunucusu ekle](https://logbrew.co/tr/guides/mcp-server-claude-code-codex)
- [Claude Code ve Codex'te AGENTS.md kullan](https://logbrew.co/tr/guides/agents-md)
- [Claude overloaded 529 ve rate limit 429 hatalarını çöz](https://logbrew.co/tr/guides/claude-overloaded-rate-limit-error)
- [Python logging'i doğru log seviyeleri ve istisna yakalamayla kur](https://logbrew.co/tr/guides/python-logging)
- [Structured logging ile alana göre arayabileceğin log formatı ve log seviyeleri](https://logbrew.co/tr/guides/structured-logging)
- [Node.js loglamayı Pino ya da Winston ile kur ve hiçbir hatayı kaçırma](https://logbrew.co/tr/guides/node-logging)
- [Django loglamayı kur ve her 500 hatasının stack trace'ini sakla](https://logbrew.co/tr/guides/django-logging)
- [React'te bir error boundary ekle ve onun kaçırdığı hataları logla](https://logbrew.co/tr/guides/react-error-boundary)
- [Trace ID ve span ID farkı, gerçek bir traceparent başlığıyla](https://logbrew.co/tr/guides/trace-id)
- [Hata, log, trace, metrik ve sürüm rehberleri](https://logbrew.co/tr/guides)
