---
title: "Django loglamayı kur ve her 500 hatasının stack trace'ini sakla"
description: "DEBUG = False ve LOGGING olmadan Django, bir 500 hatası için hiç stack trace yazdırmadı. LOGGING kurulumu, log seviyeleri ve hataları LogBrew'e gönderme, Django 6.1 üzerinde test edildi."
canonical: "https://logbrew.co/tr/guides/django-logging"
last_updated: "2026-11-21"
---

# Django loglamayı kur ve her 500 hatasının stack trace'ini sakla

`DEBUG = False` ve `LOGGING` olmadan Django, bir 500 hatası için hiç stack trace yazdırmadı. `LOGGING` kurulumu, log seviyeleri ve hataları LogBrew'e gönderme, Django 6.1 üzerinde test edildi.

21 Kasım 2026 tarihinde Python 3.13.5, Django 6.1.3, logbrew-sdk 0.1.29, logbrew-django 0.1.12 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/django-logging

## Django'nun `LOGGING` olmadan yazdırdıkları ve LogBrew'e gelenler

| Olay | `LOGGING` olmadan 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 |
| `logger.exception()` | Mesaj ve stack trace | Hata bilgili log |
| View'da `ValueError` | Sadece erişim satırı | Sorun |
| `Http404` | Sadece erişim satırı | Span, sorun yok |

`DEBUG = False` ile Django 6.1.3 üzerinde 6 olay, sonra aynıları bizim `LOGGING` dict'imiz ve logbrew-django 0.1.12 ile.

## Django loglamayı kur

### LOGGING olmadan Django'nun ne yazdırdığına bak

Uygulamamızda `taproom` adlı 1 logger ve 4 view var. `DEBUG = False` ve `LOGGING` olmadan Django, `warning` ve üstünü düz metin olarak yazdırdı, `debug` ve `info` satırlarını attı. 500 hatası stack trace olmadan sadece erişim satırını verdi.

```bash
import logging

from django.http import Http404, JsonResponse
from django.urls import path

logger = logging.getLogger("taproom")


class CardDeclined(Exception):
    pass


def pour(request, tap):
    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 JsonResponse({"tap": tap})


def keg(request, keg_id):
    raise ValueError(f"keg {keg_id} is empty")


def missing(request):
    raise Http404("no such tap")


def pay(request):
    try:
        raise CardDeclined("card declined")
    except CardDeclined:
        logger.exception("payment failed")
        return JsonResponse({"error": "card declined"}, status=402)


urlpatterns = [
    path("taps/<str:tap>/", pour),
    path("kegs/<int:keg_id>/", keg),
    path("missing/", missing),
    path("pay/", pay),
]
```

Çıktı

```text
keg below 10%
keg empty
cooler offline
[21/Nov/2026 00:41:16] "GET /taps/ipa/ HTTP/1.1" 200 14
[21/Nov/2026 00:41:16] "GET /kegs/7/ HTTP/1.1" 500 145
[21/Nov/2026 00:41:16] "GET /missing/ HTTP/1.1" 404 179
payment failed
Traceback (most recent call last):
  File "urls.py", line 32, in pay
    raise CardDeclined("card declined")
urls.CardDeclined: card declined
[21/Nov/2026 00:41:16] "GET /pay/ HTTP/1.1" 402 26
```

### settings.py dosyasına bir LOGGING dict'i ekle

Kök logger'ı konsola yönlendir ve `disable_existing_loggers` değerini `False` bırak, böylece Django'nun kendi logger'ları çalışmaya devam eder. Artık `django.request` 500 hatasını stack trace ile `ERROR` seviyesinde, 404'ü de `WARNING` seviyesinde yazdırdı.

```bash
LOGGING = {
    "version": 1,
    "disable_existing_loggers": False,
    "formatters": {
        "plain": {"format": "{levelname} {name} {message}", "style": "{"},
    },
    "handlers": {
        "console": {"class": "logging.StreamHandler", "formatter": "plain"},
    },
    "root": {
        "handlers": ["console"],
        "level": os.environ.get("LOG_LEVEL", "INFO"),
    },
}
```

Çıktı

```text
INFO taproom tap ipa opened
WARNING taproom keg below 10%
ERROR taproom keg empty
CRITICAL taproom cooler offline
[21/Nov/2026 00:41:20] "GET /taps/ipa/ HTTP/1.1" 200 14
ERROR django.request Internal Server Error: /kegs/7/
Traceback (most recent call last):
  File "django/core/handlers/exception.py", line 56, in inner
    response = get_response(request)
  File "django/core/handlers/base.py", line 199, in _get_response
    response = wrapped_callback(request, *callback_args, **callback_kwargs)
  File "urls.py", line 23, in keg
    raise ValueError(f"keg {keg_id} is empty")
ValueError: keg 7 is empty
[21/Nov/2026 00:41:20] "GET /kegs/7/ HTTP/1.1" 500 145
WARNING django.request Not Found: /missing/
[21/Nov/2026 00:41:20] "GET /missing/ HTTP/1.1" 404 179
ERROR taproom payment failed
Traceback (most recent call last):
  File "urls.py", line 32, in pay
    raise CardDeclined("card declined")
urls.CardDeclined: card declined
WARNING django.request Payment Required: /pay/
[21/Nov/2026 00:41:20] "GET /pay/ HTTP/1.1" 402 26
```

### Seviyeyi ortam değişkeninden oku

Yukarıdaki `LOGGING` dict'i `LOG_LEVEL` değerini okur. Sunucuyu `LOG_LEVEL=DEBUG` ile başlat, kodu değiştirmeden `debug` satırı görünür.

```bash
LOG_LEVEL=DEBUG python manage.py runserver
```

Çı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
[21/Nov/2026 00:41:21] "GET /taps/ipa/ HTTP/1.1" 200 14
```

### Yakalanan bir hatayı logger.exception() ile logla

`except` bloğu içinde `logger.exception()`, `ERROR` seviyesinde loglar ve stack trace'i ekler. `pay` view'ımız ayrıca 402 yanıtı döndürdü, bu yüzden `django.request` de `WARNING` seviyesinde `Payment Required` logladı.

```bash
def pay(request):
    try:
        raise CardDeclined("card declined")
    except CardDeclined:
        logger.exception("payment failed")
        return JsonResponse({"error": "card declined"}, status=402)
```

Çıktı

```text
ERROR taproom payment failed
Traceback (most recent call last):
  File "urls.py", line 32, in pay
    raise CardDeclined("card declined")
urls.CardDeclined: card declined
WARNING django.request Payment Required: /pay/
```

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

### Paketleri kur

`logbrew-django` her istek için bir span oluşturur ve bir view'daki her yakalanmamış hatayı sorun olarak kaydeder. `logbrew-sdk` istemciyi ve logging handler'ı sağlar. LogBrew projenden bir sunucu anahtarı kullan.

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

### settings.py dosyasına middleware ve handler ekle

Bunu `MIDDLEWARE` ve `LOGGING` tanımlarının arkasına koy. `LogBrewDjangoMiddleware`, `MIDDLEWARE` listesinde ilk sırada olmalı. `LogBrewLoggingHandler`, `taproom` logger'ının her kaydını gönderir. Biz yerel bir LogBrew sunucusuna gönderdik, bu yüzden kopyamız `HttpTransport()` çağrısına `endpoint=` verdi.

```bash
import logging
import os

from logbrew_django import configure_logbrew
from logbrew_sdk import HttpTransport, LogBrewClient, LogBrewLoggingHandler

MIDDLEWARE = ["logbrew_django.LogBrewDjangoMiddleware", *MIDDLEWARE]

client = LogBrewClient.create(api_key=os.environ["LOGBREW_SERVER_API_KEY"])
logging.getLogger("taproom").addHandler(LogBrewLoggingHandler(client))
configure_logbrew(
    client=client, transport=HttpTransport(), service_name="taproom"
)
```

### Sorunu ve logları geri oku

4 view'ı tekrar çağırdık ve projeyi bir okuma anahtarıyla okuduk. 500 hatası, rota adıyla 1 sorun oldu. `taproom` logları seviyelerini korudu, kök seviye `INFO` olduğu için `debug` dışarıda kaldı. 404 hiç sorun oluşturmadı.

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

Çıktı

```text
Issues (1)
- 4ca6e2fb-76d2-57d9-879a-5a4410756489 unresolved error priority=medium GET /kegs/<int:keg_id>/ failed occurrences=1 users=unknown last_seen=2026-11-21T06:44:49.579Z service=taproom trace=980168dd9976432da150838cb57f0f04 assignee=unassigned [unversioned / production]
Logs (5)
- error payment failed service=taproom trace=430c4481db414e84bec813f60aa9aa93 [unversioned / production]
- critical cooler offline service=taproom trace=a407e883564e4ab486dd9a4921971ad4 [unversioned / production]
- info tap ipa opened service=taproom trace=a407e883564e4ab486dd9a4921971ad4 [unversioned / production]
- warning keg below 10% service=taproom trace=a407e883564e4ab486dd9a4921971ad4 [unversioned / production]
- error keg empty service=taproom trace=a407e883564e4ab486dd9a4921971ad4 [unversioned / production]
```

### Sorunun ve logun ne sakladığına bak

Sorun, hata türünü ve rotayı saklar ama mesajı saklamaz. LogBrew mesajın yerine `Unhandled exception` yazar. `logger.exception()` logu ise hatanın adını ve mesajını, dosyayı, fonksiyonu ve satırı saklar.

```bash
logbrew issues --since 1h --json | jq '.[0].attributes | {
  message, exception,
  route: .metadata.routeTemplate,
  frames: (.stackFrames | length)
}'
logbrew read logs --since 1h --severity error --search payment --json |
  jq '.[0].attributes.metadata | {
    exceptionName, exceptionMessage, fileName, functionName, lineNumber
  }'
```

Çıktı

```text
{
  "message": "Unhandled exception",
  "exception": {
    "mechanism": {
      "handled": false,
      "type": "django.middleware"
    },
    "type": "ValueError"
  },
  "route": "/kegs/<int:keg_id>/",
  "frames": 2
}
{
  "exceptionName": "CardDeclined",
  "exceptionMessage": "card declined",
  "fileName": "urls.py",
  "functionName": "pay",
  "lineNumber": 34
}
```

## Test ederken gördüklerimiz

Python 3.13.5 üzerinde `runserver` ve `DEBUG = False` ile 1 Django 6.1.3 uygulaması çalıştırdık, 4 view'ı curl ile çağırdık ve sunucu çıktısını okuduk. Sonra logbrew-django 0.1.12 ekledik ve yerel bir LogBrew sunucusunun ne sakladığını okuduk.

`DEBUG = True` ve `LOGGING` olmadan Django 500 hatasının stack trace'ini de yazdırdı. Yani geliştirmede stack trace yazdıran bir uygulama canlı ortamda hiç yazdırmayabilir.

|  | `LOGGING` olmadan | `LOGGING` ile |
| --- | --- | --- |
| `logger.debug()` | Hayır | `LOG_LEVEL=DEBUG` ile |
| `logger.info()` | Hayır | Evet |
| `logger.warning()` | Evet | Evet |
| 500 hatasının stack trace'i | Hayır | Evet |
| 404 satırı | Hayır | Evet |

## Django log seviyeleri ve django.request logger'ı

Django, Python'un 5 seviyesini kullanır, `DEBUG`, `INFO`, `WARNING`, `ERROR` ve `CRITICAL`. `LOGGING` içindeki kök seviye, altındaki her kaydı atar.

`django.request`, 5xx yanıtını `ERROR`, 4xx yanıtını `WARNING` seviyesinde loglar. Sadece bir hatadan gelen 500 stack trace taşıdı.

LogBrew `warning`, `error` ve `critical` seviyelerini olduğu gibi tutar, `DEBUG` ve `INFO` seviyelerini `info` olarak saklar.

| Yanıt | `django.request` | Stack trace |
| --- | --- | --- |
| `500` | `ERROR` | Evet |
| `404` | `WARNING` | Hayır |
| `402` | `WARNING` | Hayır |

## LogBrew neleri kaydeder

Middleware her istek için rota şablonunun adıyla 1 span kaydeder, örneğin `GET /kegs/<int:keg_id>/`. Bir view'daki hata, hata türü, `django.middleware` mekanizması ve `handled: false` ile bir sorun ekler.

Sorun, hatanın mesajını saklamaz. Mesajı saklamak için hatayı `pay` view'ındaki gibi `logger.exception()` ile logla.

Bir istek sırasında yazılan log, o isteğin trace ID'sini taşır. `Http404` ve diğer 4xx hataları kendi durum koduyla bir span oluşturur, sorun oluşturmaz.

- `LogBrewDjangoMiddleware`
  - Sorun: `GET /kegs/<int:keg_id>/ failed`
  - `exception.type`: `ValueError`
  - `mechanism`: `django.middleware`
  - `handled`: `false`
  - Stack frame'leri: 2
- `LogBrewLoggingHandler`
  - Mesaj: `payment failed`
  - `exceptionName`: `CardDeclined`
  - `exceptionMessage`: `card declined`
  - `lineNumber`: `34`

## Sık sorulan sorular

### Django neden 500 hatalarını loglamıyor?

`DEBUG = False` ile varsayılan ayar `django.request` hatalarını sadece `mail_admins` handler'ına gönderir, o da onları `ADMINS` listesine e-postayla yollar. Bunları yazdırmak için kök logger'da konsol handler'ı olan bir `LOGGING` dict'i ekle.

### Django'da log seviyesini nasıl ayarlarım?

`LOGGING` içinde kök logger'a `level` ver. Kodu değiştirmeden ayarlamak için değeri `LOG_LEVEL` gibi bir ortam değişkeninden oku.

### Django'da bir hatayı stack trace ile nasıl loglarım?

`except` bloğu içinde `logger.exception()` çağır. `ERROR` seviyesinde loglar ve stack trace'i ekler.

### disable_existing_loggers ne işe yarar?

`True` olursa senin `LOGGING` ayarın devreye girdiğinde Django'nun kendi logger'ları durur ve `django.request` hiçbir şey yazdırmaz. `False` bırak.

## Her Django hatasını isteğiyle birlikte gör

logbrew-django bir view'daki her yakalanmamış hatayı rota 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

- [Django docs, Configuring logging](https://docs.djangoproject.com/en/6.0/topics/logging/#configuring-logging)
- [Django docs, Default logging configuration](https://docs.djangoproject.com/en/6.0/ref/logging/#django-s-default-logging-configuration)
- [Django docs, django.request](https://docs.djangoproject.com/en/6.0/ref/logging/#django-request)
- [django/django, django/utils/log.py](https://github.com/django/django/blob/main/django/utils/log.py)

## 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)
- [FastAPI loglamayı kur ve hataları yönet stack trace'i kaybetmeden](https://logbrew.co/tr/guides/fastapi-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)
