---
title: "أعدّ سجلات Django واحفظ تتبّع المكدّس لكل خطأ 500"
description: "مع DEBUG = False ودون LOGGING، لم يطبع Django أي تتبّع للمكدّس عند خطأ 500. إليك إعداد LOGGING ومستويات السجل وطريقة إرسال الأخطاء إلى LogBrew، من اختبار على Django 6.1."
canonical: "https://logbrew.co/ar/guides/django-logging"
last_updated: "2026-11-21"
---

# أعدّ سجلات Django واحفظ تتبّع المكدّس لكل خطأ 500

مع `DEBUG = False` ودون `LOGGING`، لم يطبع Django أي تتبّع للمكدّس عند خطأ 500. إليك إعداد `LOGGING` ومستويات السجل وطريقة إرسال الأخطاء إلى LogBrew، من اختبار على Django 6.1.

اختُبر في 21 نوفمبر 2026 باستخدام 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، ويبني LogBrew كل يوم باستخدام Claude Code وCodex.

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

## ما يطبعه Django دون `LOGGING`، وما يصل إلى LogBrew

| الحدث | المطبوع دون `LOGGING` | مشكلة أو سجل في LogBrew |
| --- | --- | --- |
| `logger.debug()` | أُسقط | أُسقط عند `INFO` |
| `logger.info()` | أُسقط | سجل `info` |
| `logger.warning()` | الرسالة فقط | سجل `warning` |
| `logger.exception()` | الرسالة وتتبّع المكدّس | سجل مع الاستثناء |
| `ValueError` في دالة عرض | سطر الوصول فقط | مشكلة |
| `Http404` | سطر الوصول فقط | Span، دون مشكلة |

6 أحداث في Django 6.1.3 مع `DEBUG = False`، ثم الأحداث نفسها مع قاموس `LOGGING` الخاص بنا وlogbrew-django 0.1.12.

## اضبط سجلات Django

### شاهد ما يطبعه Django دون LOGGING

في تطبيقنا مسجّل واحد اسمه `taproom` و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
```

### أضف قاموس LOGGING إلى settings.py

وجّه المسجّل الجذري إلى الطرفية، واترك `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` أعلاه القيمة `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` عنصر Span لكل طلب، وتسجّل كل خطأ غير معالَج في دالة عرض على أنه مشكلة. تحتوي `logbrew-sdk` على العميل ومعالج السجلات. استخدم مفتاح خادم من مشروعك في LogBrew.

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

### أضف الوسيط والمعالج إلى settings.py

ضع هذه الشيفرة بعد `MIDDLEWARE` و`LOGGING`. يجب أن يأتي `LogBrewDjangoMiddleware` أولًا في `MIDDLEWARE`. يرسل `LogBrewLoggingHandler` كل سجل من المسجّل `taproom`. أرسلنا إلى خادم LogBrew محلي، لذلك مرّرت نسختنا `endpoint=` إلى `HttpTransport()`.

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

### اقرأ المشكلة والسجلات من جديد

استدعينا دوال العرض الأربع مجددًا وقرأنا المشروع بمفتاح قراءة. أصبح خطأ 500 مشكلة واحدة تحمل اسم المسار. حافظت سجلات `taproom` على مستوياتها، وبقي `debug` خارجها لأن المستوى الجذري كان `INFO`. لم يُنشئ 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
}
```

## ما رأيناه في الاختبار

شغّلنا تطبيق Django 6.1.3 واحدًا على Python 3.13.5 عبر `runserver` مع `DEBUG = False`، واستدعينا 4 دوال عرض عبر curl، وقرأنا مخرجات الخادم. ثم أضفنا 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 الخمسة، `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

يسجّل الوسيط عنصر Span واحدًا لكل طلب، ويسمّيه باسم قالب المسار، مثل `GET /kegs/<int:keg_id>/`. ويضيف الاستثناء في دالة العرض مشكلة تحمل نوع الاستثناء والآلية `django.middleware` و`handled: false`.

لا تحفظ المشكلة رسالة الاستثناء. لحفظها، سجّل الخطأ عبر `logger.exception()` كما تفعل دالة العرض `pay`.

يحمل السجل المكتوب أثناء طلب معرّف التتبّع لذلك الطلب. تُنشئ `Http404` واستثناءات 4xx الأخرى عنصر Span بحالتها، دون أي مشكلة.

- `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` فيه معالج للطرفية على المسجّل الجذري لطباعتها.

### كيف أضبط مستوى السجل في Django؟

اضبط `level` على المسجّل الجذري في `LOGGING`. اقرأ القيمة من متغيّر بيئة مثل `LOG_LEVEL` لتغييرها دون تعديل الشيفرة.

### كيف أسجّل استثناءً مع تتبّع المكدّس في Django؟

استدعِ `logger.exception()` داخل `except`. يسجّل بالمستوى `ERROR` ويضيف تتبّع المكدّس.

### ما وظيفة disable_existing_loggers؟

مع `True`، تتوقف مسجّلات Django نفسها عند تطبيق `LOGGING` الخاص بك، فلا يطبع `django.request` أي شيء. اتركه على `False`.

## شاهد كل خطأ في Django مع طلبه

تسجّل logbrew-django كل خطأ غير معالَج في دالة عرض على أنه مشكلة تحمل اسم مساره، وترسل سجلاتك مع تتبّع طلبها. ابدأ بخطة مجانية سخية دون بطاقة.

[ابدأ مجانًا](https://logbrew.co/ar)

## المصادر

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

- [أضف خادم MCP إلى Claude Code وCodex](https://logbrew.co/ar/guides/mcp-server-claude-code-codex)
- [استخدم AGENTS.md في Claude Code وCodex](https://logbrew.co/ar/guides/agents-md)
- [أصلح خطأ Claude overloaded 529 وخطأ rate limit 429](https://logbrew.co/ar/guides/claude-overloaded-rate-limit-error)
- [إعداد Python logging بمستويات السجل الصحيحة والتقاط الاستثناءات](https://logbrew.co/ar/guides/python-logging)
- [التسجيل المنظّم بتنسيق سجل ومستويات سجل يمكنك البحث فيها حسب الحقل](https://logbrew.co/ar/guides/structured-logging)
- [إعداد السجلات في Node.js باستخدام Pino أو Winston دون أن تفقد أي خطأ](https://logbrew.co/ar/guides/node-logging)
- [أعدّ سجلات FastAPI وعالج الأخطاء دون فقدان تتبّع المكدّس](https://logbrew.co/ar/guides/fastapi-logging)
- [أضف حدًّا للأخطاء في React وسجّل الأخطاء التي تفوته](https://logbrew.co/ar/guides/react-error-boundary)
- [الفرق بين Trace ID وSpan ID من ترويسة traceparent حقيقية](https://logbrew.co/ar/guides/trace-id)
- [أدلة للأخطاء والسجلات والتتبّعات والمقاييس والإصدارات](https://logbrew.co/ar/guides)
