---
title: "Django のログを設定してすべての 500 エラーのトレースバックを残す"
description: "DEBUG = False で LOGGING がないと、Django は 500 エラーのトレースバックを出力しませんでした。LOGGING の設定、ログレベル、LogBrew へのエラー送信を、Django 6.1 で検証してまとめました。"
canonical: "https://logbrew.co/ja/guides/django-logging"
last_updated: "2026-11-21"
---

# Django のログを設定してすべての 500 エラーのトレースバックを残す

`DEBUG = False` で `LOGGING` がないと、Django は 500 エラーのトレースバックを出力しませんでした。`LOGGING` の設定、ログレベル、LogBrew へのエラー送信を、Django 6.1 で検証してまとめました。

2026年11月21日 に Python 3.13.5、Django 6.1.3、logbrew-sdk 0.1.29、logbrew-django 0.1.12、logbrew CLI 0.1.96 で検証

執筆 [Furkan Erday](https://github.com/furkanerday). Furkan Erday は LogBrew の創業者です。毎日 Claude Code と Codex を使って LogBrew を開発しています。

Canonical: https://logbrew.co/ja/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 を追加する

ルートロガーをコンソールに出力し、`disable_existing_loggers` を `False` のままにして、Django 自身のロガーを有効に保ちます。これで `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/ja)

## 出典

- [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/ja/guides/mcp-server-claude-code-codex)
- [Claude Code と Codex で AGENTS.md を使う](https://logbrew.co/ja/guides/agents-md)
- [Claude の overloaded エラー 529 とレート制限エラー 429 を解決する](https://logbrew.co/ja/guides/claude-overloaded-rate-limit-error)
- [Python logging を正しいログレベルと例外の記録つきで設定する](https://logbrew.co/ja/guides/python-logging)
- [構造化ログ（structured logging）でフィールドから検索できるログの書式とログレベルを整える](https://logbrew.co/ja/guides/structured-logging)
- [Node.js のログを Pino か Winston でエラーを失わずに設定する](https://logbrew.co/ja/guides/node-logging)
- [FastAPI のログを設定してトレースバックを失わずにエラーを処理する](https://logbrew.co/ja/guides/fastapi-logging)
- [React にエラーバウンダリを追加してそれが見逃すエラーも記録する](https://logbrew.co/ja/guides/react-error-boundary)
- [トレース ID とスパン ID の違いを実際の traceparent ヘッダーで解読](https://logbrew.co/ja/guides/trace-id)
- [エラー、ログ、トレース、メトリクス、リリースのガイド](https://logbrew.co/ja/guides)
