---
title: "Django 로깅을 설정하고 모든 500 오류의 트레이스백 남기기"
description: "DEBUG = False이고 LOGGING이 없으면 Django는 500 오류의 트레이스백을 출력하지 않았어요. LOGGING 설정, 로그 레벨, 오류를 LogBrew로 보내는 방법을 Django 6.1에서 직접 테스트해 정리했어요."
canonical: "https://logbrew.co/ko/guides/django-logging"
last_updated: "2026-11-21"
---

# Django 로깅을 설정하고 모든 500 오류의 트레이스백 남기기

`DEBUG = False`이고 `LOGGING`이 없으면 Django는 500 오류의 트레이스백을 출력하지 않았어요. `LOGGING` 설정, 로그 레벨, 오류를 LogBrew로 보내는 방법을 Django 6.1에서 직접 테스트해 정리했어요.

Python 3.13.5, Django 6.1.3, logbrew-sdk 0.1.29, logbrew-django 0.1.12 및 logbrew CLI 0.1.96 환경에서 2026년 11월 21일에 테스트

글 [Furkan Erday](https://github.com/furkanerday). LogBrew 창업자 Furkan Erday. 매일 Claude Code와 Codex로 LogBrew를 만들어요.

Canonical: https://logbrew.co/ko/guides/django-logging

## `LOGGING` 없이 Django가 출력하는 내용과 LogBrew에 도착하는 내용

| 이벤트 | `LOGGING` 없이 출력된 내용 | LogBrew의 이슈 또는 로그 |
| --- | --- | --- |
| `logger.debug()` | 버려짐 | `INFO`에서 버려짐 |
| `logger.info()` | 버려짐 | `info` 로그 |
| `logger.warning()` | 메시지만 | `warning` 로그 |
| `logger.exception()` | 메시지와 트레이스백 | 예외가 담긴 로그 |
| 뷰의 `ValueError` | 접근 로그 한 줄만 | 이슈 |
| `Http404` | 접근 로그 한 줄만 | 스팬만, 이슈 없음 |

`DEBUG = False`인 Django 6.1.3에서 이벤트 6개를 일으키고, 같은 이벤트를 저희 `LOGGING` dict와 logbrew-django 0.1.12로 다시 일으켰어요.

## Django 로깅 설정하기

### LOGGING이 없을 때 Django가 출력하는 내용 보기

예제 앱에는 `taproom`이라는 로거 1개와 뷰 4개가 있어요. `DEBUG = False`이고 `LOGGING` 설정이 없으면 Django는 `warning` 이상을 일반 텍스트로 출력하고 `debug`와 `info`는 버렸어요. 500 오류는 트레이스백 없이 접근 로그 한 줄만 남겼어요.

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

출력

```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에 LOGGING dict 추가하기

루트 로거를 콘솔로 보내고, Django 자체 로거가 계속 동작하도록 `disable_existing_loggers`를 `False`로 두세요. 이제 `django.request`가 500 오류를 트레이스백과 함께 `ERROR`로, 404를 `WARNING`으로 출력했어요.

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

출력

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

### 환경 변수에서 레벨 읽기

위의 `LOGGING` dict는 `LOG_LEVEL`을 읽어요. `LOG_LEVEL=DEBUG`로 서버를 시작하면 코드를 바꾸지 않아도 `debug` 줄이 나와요.

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

출력

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

### 잡은 예외를 logger.exception()으로 기록하기

`except` 안에서 `logger.exception()`을 호출하면 `ERROR`로 기록하고 트레이스백을 덧붙여요. `pay` 뷰는 402 응답도 반환해서 `django.request`가 `Payment Required`를 `WARNING`으로 기록했어요.

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

출력

```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 로그와 오류를 LogBrew로 보내기

### 패키지 설치하기

`logbrew-django`는 요청마다 스팬을 만들고, 뷰에서 처리되지 않은 오류를 각각 이슈로 기록해요. `logbrew-sdk`에는 클라이언트와 로깅 핸들러가 들어 있어요. LogBrew 프로젝트의 서버 키를 사용하세요.

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

### settings.py에 미들웨어와 핸들러 추가하기

이 코드를 `MIDDLEWARE`와 `LOGGING` 뒤에 두세요. `LogBrewDjangoMiddleware`는 `MIDDLEWARE`의 맨 앞에 있어야 해요. `LogBrewLoggingHandler`는 `taproom` 로거의 각 레코드를 보내요. 저희는 로컬 LogBrew 서버로 보냈기 때문에 저희 코드에서는 `HttpTransport()`에 `endpoint=`를 넘겼어요.

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

### 이슈와 로그 다시 읽기

뷰 4개를 다시 호출하고 읽기 키로 프로젝트를 읽었어요. 500 오류는 라우트 이름이 붙은 이슈 1개가 됐어요. `taproom` 로그는 레벨을 그대로 유지했고, 루트 레벨이 `INFO`라서 `debug`는 빠졌어요. 404는 이슈를 만들지 않았어요.

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

출력

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

### 이슈와 로그에 남는 내용 확인하기

이슈에는 예외 타입과 라우트가 남지만 메시지는 남지 않아요. LogBrew는 그 자리에 `Unhandled exception`을 적어요. `logger.exception()` 로그에는 예외 이름과 메시지, 파일, 함수, 줄 번호가 남아요.

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

출력

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

## 직접 테스트해 보니

Python 3.13.5에서 `runserver`와 `DEBUG = False`로 Django 6.1.3 앱 1개를 실행하고, curl로 뷰 4개를 호출해 서버 출력을 읽었어요. 그다음 logbrew-django 0.1.12를 추가하고 로컬 LogBrew 서버에 저장된 내용을 읽었어요.

`DEBUG = True`이고 `LOGGING`이 없으면 Django는 500 오류의 트레이스백도 출력했어요. 그래서 개발 중에는 트레이스백을 출력하던 앱이 프로덕션에서는 아무것도 출력하지 않을 수 있어요.

|  | `LOGGING` 없음 | `LOGGING` 있음 |
| --- | --- | --- |
| `logger.debug()` | 아니요 | `LOG_LEVEL=DEBUG`로 실행 |
| `logger.info()` | 아니요 | 예 |
| `logger.warning()` | 예 | 예 |
| 500 오류의 트레이스백 | 아니요 | 예 |
| 404 줄 | 아니요 | 예 |

## Django 로그 레벨과 django.request 로거

Django는 Python의 5개 레벨 `DEBUG`, `INFO`, `WARNING`, `ERROR`, `CRITICAL`을 사용해요. `LOGGING`의 루트 레벨보다 낮은 레코드는 모두 버려져요.

`django.request`는 5xx 응답을 `ERROR`로, 4xx 응답을 `WARNING`으로 기록해요. 트레이스백이 붙은 것은 예외로 생긴 500뿐이었어요.

LogBrew는 `warning`, `error`, `critical`을 그대로 두고, `DEBUG`와 `INFO`는 `info`로 저장해요.

| 응답 | `django.request` | 트레이스백 |
| --- | --- | --- |
| `500` | `ERROR` | 예 |
| `404` | `WARNING` | 아니요 |
| `402` | `WARNING` | 아니요 |

## LogBrew가 기록하는 내용

미들웨어는 요청마다 스팬 1개를 기록하고, `GET /kegs/<int:keg_id>/`처럼 라우트 템플릿 이름을 붙여요. 뷰에서 예외가 나면 예외 타입, 메커니즘 `django.middleware`, `handled: false`가 담긴 이슈가 추가돼요.

이슈에는 예외 메시지가 남지 않아요. 메시지를 남기려면 `pay` 뷰처럼 `logger.exception()`으로 오류를 기록하세요.

요청 중에 쓴 로그에는 그 요청의 트레이스 ID가 붙어요. `Http404`와 다른 4xx 예외는 해당 상태 코드로 스팬을 만들고 이슈는 만들지 않아요.

- `LogBrewDjangoMiddleware`
  - 이슈: `GET /kegs/<int:keg_id>/ failed`
  - `exception.type`: `ValueError`
  - `mechanism`: `django.middleware`
  - `handled`: `false`
  - 스택 프레임: 2
- `LogBrewLoggingHandler`
  - 메시지: `payment failed`
  - `exceptionName`: `CardDeclined`
  - `exceptionMessage`: `card declined`
  - `lineNumber`: `34`

## 자주 묻는 질문

### Django가 500 오류를 로그로 남기지 않는 이유는 뭔가요?

`DEBUG = False`이면 기본 설정은 `django.request` 오류를 `mail_admins`로만 보내고, 이 핸들러가 `ADMINS`에게 메일을 보내요. 출력하려면 루트 로거에 콘솔 핸들러가 있는 `LOGGING` dict를 추가하세요.

### Django에서 로그 레벨은 어떻게 설정하나요?

`LOGGING`의 루트 로거에 `level`을 설정하세요. `LOG_LEVEL` 같은 환경 변수에서 값을 읽으면 코드를 바꾸지 않고도 바꿀 수 있어요.

### Django에서 예외를 트레이스백과 함께 기록하려면 어떻게 하나요?

`except` 안에서 `logger.exception()`을 호출하세요. `ERROR`로 기록하고 트레이스백을 덧붙여요.

### disable_existing_loggers는 무슨 역할을 하나요?

`True`이면 `LOGGING`이 적용될 때 Django 자체 로거가 멈춰서 `django.request`가 아무것도 출력하지 않아요. `False`로 두세요.

## Django 오류를 요청과 함께 확인하세요

logbrew-django는 뷰에서 처리되지 않은 오류를 각각 라우트 이름이 붙은 이슈로 기록하고, 로그를 해당 요청의 트레이스와 함께 보내요. 넉넉한 무료 요금제로 시작하세요. 카드 등록은 필요 없어요.

[무료로 시작](https://logbrew.co/ko)

## 출처

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

## 에이전트, Python, Node.js, React 가이드 더 보기

- [Claude Code와 Codex에 MCP 서버 추가하기](https://logbrew.co/ko/guides/mcp-server-claude-code-codex)
- [Claude Code와 Codex에서 AGENTS.md 쓰기](https://logbrew.co/ko/guides/agents-md)
- [Claude overloaded 529 오류와 rate limit 429 오류 해결하기](https://logbrew.co/ko/guides/claude-overloaded-rate-limit-error)
- [Python logging을 올바른 로그 레벨과 예외 기록까지 설정하기](https://logbrew.co/ko/guides/python-logging)
- [필드로 검색할 수 있는 로그 포맷과 로그 레벨로 구조화 로깅하기](https://logbrew.co/ko/guides/structured-logging)
- [Node.js 로깅을 Pino나 Winston으로 오류 하나 놓치지 않게 설정하기](https://logbrew.co/ko/guides/node-logging)
- [FastAPI 로깅을 설정하고 트레이스백을 잃지 않고 오류 처리하기](https://logbrew.co/ko/guides/fastapi-logging)
- [React에 error boundary를 추가하고 놓치는 오류까지 기록하기](https://logbrew.co/ko/guides/react-error-boundary)
- [트레이스 ID와 스팬 ID 차이, 실제 traceparent 헤더로 해석하기](https://logbrew.co/ko/guides/trace-id)
- [오류, 로그, 트레이스, 메트릭, 릴리스 가이드](https://logbrew.co/ko/guides)
