{"title":"Logáil","version":"6.0","locale":"ga","docname":"ref/logging","url":"/ga/6.0/ref/logging/","canonical":"https://djangodocs.dev/ga/6.0/ref/logging/","summary":"See also Conas logáil a chumrú agus a úsáid :ref: ` Forbhreathnú logála Django ` Leathnaíonn modúl logála Django tógáil Python: mod: loging.…","html":"

LogáilLink to this heading#

\n\n

Leathnaíonn modúl logála Django tógáil Python: mod: loging.

\n

Cumraítear logáil mar chuid den fheidhm ghinearálta django: func: django.setup, mar sin tá sé ar fáil i gcónaí mura bhfuil sé míchumasaithe go sainráite.

\n
\n

Cumraíocht logála réamhshocraithe DjangoLink to this heading#

\n

<logging-config-dictschema>De réir réamhshocraithe, úsáideann Django formáid Python: Ref: `Logging.config.dictConfig `.

\n
\n

Coinníollacha logála réamhshocLink to this heading#

\n

Is iad an tacar iomlán coinníollacha logála réamhshocraithe:

\n

Nuair: Socrú: Is é DEBUG True:

\n
    \n

  • Seolann an logálaí django ``teachtaireachtaí san ordlathas ``django (seachas django.server) ag an leibhéal INFO nó níos airde chuig an gconsól.

    • \n
\n

Nuair: Socrú: Is é DEBUG False:

\n
    \n

  • Seolann an logálaí django teachtaireachtaí san ordlathas django (seachas django.server) le leibhéal ERROR nó CRITICAL go dt:class: AdminEmailHandler.

    • \n
\n

Neamhspleách ar luach: socrú: DEBUG:

\n
    \n

  • Seolann logger:ref: django-server-logger teachtaireachtaí ag an leibhéal ``INFO ``nó níos airde chuig an gconsól.

    • \n
\n

Déanann gach logger seachas: ref: django-server-logger iomadú logáil chuig a dtuismitheoirí, suas go dtí an logger fréimhe django. Tá na láimhseálaithe console agus mail_admins ceangailte leis an logálaí fréimhe chun an t-iompar a thuairiscítear thuas a sholáthar.

\n

Seolann réamhshocraithe Python féin taifid ar leibhéal ``RABHADH ``agus níos airde chuig an gconsól.

\n
\n
\n

Sainmhíniú logála réamhLink to this heading#

\n

Oidhreann cumraíocht logála réamhshocraithe Django réamhshocraithe réamhshocraithe Python. Tá sé ar fáil mar django.utils.log.default_logging agus sainithe in:source: django/utils/log.py:

\n
Code
{\n    "version": 1,\n    "disable_existing_loggers": False,\n    "filters": {\n        "require_debug_false": {\n            "()": "django.utils.log.RequireDebugFalse",\n        },\n        "require_debug_true": {\n            "()": "django.utils.log.RequireDebugTrue",\n        },\n    },\n    "formatters": {\n        "django.server": {\n            "()": "django.utils.log.ServerFormatter",\n            "format": "[{server_time}] {message}",\n            "style": "{",\n        }\n    },\n    "handlers": {\n        "console": {\n            "level": "INFO",\n            "filters": ["require_debug_true"],\n            "class": "logging.StreamHandler",\n        },\n        "django.server": {\n            "level": "INFO",\n            "class": "logging.StreamHandler",\n            "formatter": "django.server",\n        },\n        "mail_admins": {\n            "level": "ERROR",\n            "filters": ["require_debug_false"],\n            "class": "django.utils.log.AdminEmailHandler",\n        },\n    },\n    "loggers": {\n        "django": {\n            "handlers": ["console", "mail_admins"],\n            "level": "INFO",\n        },\n        "django.server": {\n            "handlers": ["django.server"],\n            "level": "INFO",\n            "propagate": False,\n        },\n    },\n}\n
\n

Féach: ref: cumraing-loging maidir le conas an chumraíocht logála réamhshocraithe seo a chomhlánú nó a athsholáthar.

\n
\n
\n
\n

Síntí logála DjangoLink to this heading#

\n

Soláthraíonn Django roinnt fóntais chun na riachtanais áirithe a bhaineann le logáil isteach i dtimpeallacht freastalaí gréasáin a láim

\n
\n

LogálaíLink to this heading#

\n

Soláthraíonn Django roinnt loggers ionsuite.

\n
\n

DjangoLink to this heading#

\n

<naming-loggers-hierarchy>An logálaí tuismitheora do theachtaireachtaí sa django:ref: `ordlathas logálaí ainmnithe `. Ní phostáil Django teachtaireachtaí ag baint úsáide as an ainm seo. Ina áit sin, úsáideann sé ceann de na loggers thíos.

\n
\n
\n

django.requestLink to this heading#

\n

Teachtaireachtaí logála a bhaineann le láimhseáil iarratais. Ardaítear 5XX freagra mar theachtaireachtaí ERROR; Ardaítear 4XX freagra mar theachtaireachtaí RABHADH ``. Ní chuirtear iarratais atá logáilte chuig an logaire ``django.security logáilte chuig django.request.

\n

Tá an comhthéacs breise seo a leanas ag teachtaireachtaí chuig an logaire seo:

\n
    \n

  • status_code: An cód freagartha HTTP a bhaineann leis an iarratas.

    • \n

  • request: An réad iarratais a ghinigh an teachtaireacht logála.

    • \n
\n
\n
\n

django.freastalaLink to this heading#

\n

Logáil teachtaireachtaí a bhaineann le láimhseáil iarratais a fhaigheann an freastalaí a ghairm leis an ordú:djadmin: runserver. Logáiltear freagraí HTTP 5XX mar theachtaireachtaí ERROR, logáiltear freagraí 4XX mar theachtaireachtaí RABHADH ``, agus logáiltear gach rud eile mar `INFO.

\n

Tá an comhthéacs breise seo a leanas ag teachtaireachtaí chuig an logaire seo:

\n
    \n

  • status_code: An cód freagartha HTTP a bhaineann leis an iarratas.

    • \n

  • request: The request object (a socket.socket) that generated\nthe logging message.

    • \n
\n
\n
\n

django.teimpléadLink to this heading#

\n

Logáil teachtaireachtaí a bhaineann le rindreáil teimpléid.

\n
    \n

  • Logáiltear athróga comhthéacs atá in easnamh mar theachtaireachtaí ``DEBUG`.

    • \n
\n
\n
\n

django.db.backendsLink to this heading#

\n

Teachtaireachtaí a bhaineann le hidirghníomhú an chód leis an mbunachar sonraí Mar shampla, logáiltear gach ráiteas SQL ar leibhéal feidhmchláir a fhorghníomhaítear le hiarratas ag an leibhéal ``DEBUG` chuig an logger seo.

\n

Tá an comhthéacs breise seo a leanas ag teachtaireachtaí chuig an logaire seo:

\n
    \n

  • ``fad ``: An t-am a thógtar chun an ráiteas SQL a fhorghníomhú.

    • \n

  • sql: An ráiteas SQL a cuireadh i bhfeidhm.

    • \n

  • params: Na paraiméadair a úsáideadh sa ghlao SQL.

    • \n

  • alias: An alias den bhunachar sonraí a úsáidtear sa ghlao SQL.

    • \n
\n

Ar chúiseanna feidhmíochta, ní chumasaítear logáil SQL ach nuair a shocraítear Settings.debug go True, beag beann ar an leibhéal logála nó ar an láimhseálaithe atá suiteáilte.

\n

Ní chuimsíonn an logáil seo tionscnamh ar leibhéal creata (m.sh. SET TIMEZONE`). Cas ar logáil ceisteanna i do bhunachar sonraí más mian leat gach ceist bunachar sonraí a fheiceáil.

\n
\n
\n

django.utils.autoreloadLink to this heading#

\n

Logáil teachtaireachtaí a bhaineann le hathluchtú cód uathoibríoch le linn freastalaí forbartha Django a chur i bh Gineann an logálaí seo teachtaireacht ``INFO` nuair a bhrath modhnú i gcomhad cód foinse agus féadfaidh sé teachtaireachtaí `RABHADH ``a tháirgeadh le linn cigireachta an chórais chomhaid agus próisis síntiúis imeachta.

\n
\n
\n

django.contrib.authLink to this heading#

\n

Log messages related to django.contrib.auth, particularly ERROR\nmessages are generated when a\nPasswordResetForm is successfully submitted\nbut the password reset email cannot be delivered due to a mail sending\nexception.

\n
\n
\n

django.contrib.gisLink to this heading#

\n

Log messages related to GeodJango at various points: during\nthe loading of external GeoSpatial libraries (GEOS, GDAL, etc.) and when\nreporting errors. Each ERROR log record includes the caught exception and\nrelevant contextual data.

\n
\n
\n

``django.sheoladh ``Link to this heading#

\n

This logger is used in Comharthaí, specifically within the\nSignal class, to report issues when dispatching a\nsignal to a connected receiver. The ERROR log record includes the caught\nexception as exc_info and adds the following extra context:

\n
    \n

  • ``glacadóir`: Ainm an ghlacadóra.

    • \n

  • err: An eisceacht a tharla nuair a ghlaoigh ar an nglacadóir.

    • \n
\n
\n
\n

django.security. *Link to this heading#

\n

The security loggers will receive messages on any occurrence of\nSuspiciousOperation and other security-related\nerrors. There is a sub-logger for each subtype of security error, including all\nSuspiciousOperations. The level of the log event depends on where the\nexception is handled. Most occurrences are logged as a warning, while\nany SuspiciousOperation that reaches the WSGI handler will be logged as an\nerror. For example, when an HTTP Host header is included in a request from\na client that does not match ALLOWED_HOSTS, Django will return a 400\nresponse, and an error message will be logged to the\ndjango.security.DisallowedHost logger.

\n

Sroichfidh na himeachtaí logála seo an logaire django de réir réamhshocraithe, a sheolann imeachtaí earráide chuig riarthóirí nuair a bhíonn debug = false `. Ní logálfar iarratais a bhíonn freagra 400 mar gheall ar AbhraisciousOperation sa logálaí django.request`, ach chuig an logálaí django.security` amháin.

\n

Chun cineál áirithe AspiciousOperation a thostú, is féidir leat an logaire sonrach sin a shárú tar éis an sampla seo:

\n
Code
LOGGING = {\n    # ...\n    "handlers": {\n        "null": {\n            "class": "logging.NullHandler",\n        },\n    },\n    "loggers": {\n        "django.security.DisallowedHost": {\n            "handlers": ["null"],\n            "propagate": False,\n        },\n    },\n    # ...\n}\n
\n

Is iad logálaí eile django.security` nach bhfuil bunaithe ar AspiciousOperation:

\n
    \n

  • <csrf-rejected-requests>``django.security.csrf``: le haghaidh: `Teipeanna CSRF `.

    • \n
\n
\n
\n

django.db.backends.schemaLink to this heading#

\n

Logálann sé na ceisteanna SQL a fhorghníomhaítear le linn athruithe scéime ar an mbunachar sonraí ag an gcreata:doc: </topics/migrations> imirceach. Tabhair faoi deara nach logálfaidh sé na ceisteanna a fhorghníomhaí:class: ~django.db.migrations.operations.runpython. Tá params` agus sql` ag teachtaireachtaí chuig an logaire seo ina gcomhthéacs breise (ach murab ionann agus django.db.backends, ní fad). Tá an brí céanna ag na luachanna mar a mhínítear in:ref: django-db-logger.

\n
\n
\n

django.contrib.sesionsLink to this heading#

\n

Logáil teachtaireachtaí a bhaineann le:doc: `session framework`</topics/http/sessions>.

\n
    \n

  • Déantar earráidí neamh-mharfacha a tharlaíonn nuair a úsáidtear an inneall:class: Django.contrib.sessions.backends.cached_db.sessionStore logáilte mar theachtaireachtaí ERROR leis an rianaireacht chomhfhreagrach.

    • \n
\n
\n
\n
\n

LáimhseálaitheLink to this heading#

\n

<python:logging.handlers>Soláthraíonn Django láimhseálaí logála amháin i dteann:mod: `iad siúd a sholáthraíonn an modúl logála Python `.

\n
\n
\nclass AdminEmailHandler(include_html=False, email_backend=None, reporter_class=None)Link to this definition#
\n

Seolann an láimhseálaí seo ríomhphost chuig an láithreán: setting: ADMINS do gach teachtaireacht logála a fhaigheann sé.

\n

Má tá tréith iarrata sa taifead logála, cuirfear sonraí iomlána an iarratais san áireamh sa ríomhphost. Áireofar san ábhar ríomhphoist an abairt “IP inmheánach” má tá seoladh IP an chliaint sa socrú: INTERNAL_IPS; mura bhfuil, beidh “IP EXTERNAL” san áireamh ann.

\n

Má tá faisnéis rianaithe cruach sa taifead logála, cuirfear an rian cruach sin san áireamh sa ríomhphost.

\n

Úsáidtear an argóint include_html` de AdminEmailHandler` chun rialú a dhéanamh an bhfuil ceangaltán HTML san áireamh sa ríomhphost rianaithe ina bhfuil ábhar iomlán an leathanaigh ghréasáin dífhabhtaithe a tháirgfeadh dá mbeadh: socrú: DEBUG True. Chun an luach seo a shocrú i do chumraíocht, cuir san áireamh é sa sainmhíniú láimhseálaí do Django.utils.log.adminEmailHandler, mar seo:

\n
Code
"handlers": {\n    "mail_admins": {\n        "level": "ERROR",\n        "class": "django.utils.log.AdminEmailHandler",\n        "include_html": True,\n    },\n}\n
\n

Bí ar an eolas fao:ref: impleachtaí slándála a bhaineann le logáil `agus an `AdminEmailHand <logging-security-implications>ler` á úsáid agat.

\n

<topic-email-backends>Trí an argóint email_backend de AdminEmailHandler` a shocrú, is féidir an:ref: backend ríomhphost atá á úsáid ag an láimhseálaí a athshealbhú, mar seo:

\n
Code
"handlers": {\n    "mail_admins": {\n        "level": "ERROR",\n        "class": "django.utils.log.AdminEmailHandler",\n        "email_backend": "django.core.mail.backends.filebased.EmailBackend",\n    },\n}\n
\n

De réir réamhshocraithe, úsáidfear sampla den chúltaca ríomhphoist a shonraítear in:setting: EMAIL_BACKEND.

\n

Ligeann an argóint reporter_class de AdminEmailHandler` fo-aicme django.views.debug.exceptionReporter a sholáthar chun an téacs rianaithe a sheoltar sa chomhlacht ríomhphoist a shaincheapadh. Soláthraíonn tú cosán allmhairithe teaghrán chuig an rang is mian leat a úsáid, mar seo:

\n
Code
"handlers": {\n    "mail_admins": {\n        "level": "ERROR",\n        "class": "django.utils.log.AdminEmailHandler",\n        "include_html": True,\n        "reporter_class": "somepackage.error_reporter.CustomErrorReporter",\n    },\n}\n
\n
\n
\nsend_mail(subject, message, *args, **kwargs)Link to this definition#
\n

Seolann ríomhphoist chuig úsáideoirí admin. Chun an t-iompar seo a shaincheapadh, is féidir leat an rang:class: ~django.utils.log.adminEmailHandler a fho-aicmiú agus an modh seo a shárú.

\n
\n\n
\n\n
\n
\n

ScagairíLink to this heading#

\n

Soláthraíonn Django roinnt scagairí logála i dteannta leo siúd a sholáthraíonn modúl logála Python.

\n
\n
\nclass CallbackFilter(callback)Link to this definition#
\n

Glacann an scagaire seo le feidhm aisghlaonna (ba chóir dó glacadh le argóint amháin, an taifead atá le logáil), agus glaonn sé do gach taifead a théann tríd an scagaire. Ní rachaidh láimhseáil an taifead sin ar aghaidh má fhilleann an glaoch ar ais bréagach.

\n

Mar shampla, chun scagadh amach: exc: ~django.http.UnreadablePostError (arna ardú nuair a chuireann úsáideoir uaslódáil ar ceal) ó na ríomhphoist riaracháin, chruthófá feidhm scagaire:

\n
Code
from django.http import UnreadablePostError\n\n\ndef skip_unreadable_post(record):\n    if record.exc_info:\n        exc_type, exc_value = record.exc_info[:2]\n        if isinstance(exc_value, UnreadablePostError):\n            return False\n    return True\n
\n

agus ansin cuir é le do chumraíocht logála:

\n
Code
LOGGING = {\n    # ...\n    "filters": {\n        "skip_unreadable_posts": {\n            "()": "django.utils.log.CallbackFilter",\n            "callback": skip_unreadable_post,\n        },\n    },\n    "handlers": {\n        "mail_admins": {\n            "level": "ERROR",\n            "filters": ["skip_unreadable_posts"],\n            "class": "django.utils.log.AdminEmailHandler",\n        },\n    },\n    # ...\n}\n
\n
\n\n
\n
\nclass RequireDebugFalseLink to this definition#
\n

Ní chuirfidh an scagaire seo ar thaifid ach nuair a bhíonn settings.Debug bréagach.

\n

Úsáidtear an scagaire seo mar seo a leanas sa chumraíocht réamhshocraithe:socrú: LOGGING chun a chinntiú nach seolann an:class: adminEmailHandler ríomhphoist earráide chuig riarthóirí ach nuair:socrú: DEBUG False`:

\n
Code
LOGGING = {\n    # ...\n    "filters": {\n        "require_debug_false": {\n            "()": "django.utils.log.RequireDebugFalse",\n        },\n    },\n    "handlers": {\n        "mail_admins": {\n            "level": "ERROR",\n            "filters": ["require_debug_false"],\n            "class": "django.utils.log.AdminEmailHandler",\n        },\n    },\n    # ...\n}\n
\n
\n\n
\n
\nclass RequireDebugTrueLink to this definition#
\n

Tá an scagaire seo cosúil le:class: RequireDebugFalse, ach amháin nach ndéantar taifid a rith ach nuair:setting: DEBUG True.

\n
\n\n
\n
","rootId":"logging","toc":[{"title":"Cumraíocht logála réamhshocraithe Django","anchor":"django-s-default-logging-configuration","children":[{"title":"Coinníollacha logála réamhshoc","anchor":"default-logging-conditions","children":[]},{"title":"Sainmhíniú logála réamh","anchor":"default-logging-definition","children":[]}]},{"title":"Síntí logála Django","anchor":"django-logging-extensions","children":[{"title":"Logálaí","anchor":"loggers","children":[{"title":"Django","anchor":"django","children":[]},{"title":"django.request","anchor":"django-request","children":[]},{"title":"django.freastala","anchor":"django-server","children":[]},{"title":"django.teimpléad","anchor":"django-template","children":[]},{"title":"django.db.backends","anchor":"django-db-backends","children":[]},{"title":"django.utils.autoreload","anchor":"django-utils-autoreload","children":[]},{"title":"django.contrib.auth","anchor":"django-contrib-auth","children":[]},{"title":"django.contrib.gis","anchor":"django-contrib-gis","children":[]},{"title":"``django.sheoladh ``","anchor":"django-dispatch","children":[]},{"title":"django.security. *","anchor":"django-security","children":[]},{"title":"django.db.backends.schema","anchor":"django-db-backends-schema","children":[]},{"title":"django.contrib.sesions","anchor":"django-contrib-sessions","children":[]}]},{"title":"Láimhseálaithe","anchor":"handlers","children":[]},{"title":"Scagairí","anchor":"filters","children":[]}]}],"breadcrumbs":[{"docname":"ref/index","title":"Tagairt API","url":"/ga/6.0/ref/"}],"prev":{"docname":"ref/forms/validation","title":"Bailíochtú foirm agus réimse","url":"/ga/6.0/ref/forms/validation/"},"next":{"docname":"ref/middleware","title":"Meán-earraí","url":"/ga/6.0/ref/middleware/"},"formats":{"html":"/ga/6.0/ref/logging/","markdown":"/ga/6.0/ref/logging.md","json":"/ga/6.0/ref/logging.json"},"source":"https://github.com/django/django/blob/stable/6.0.x/docs/ref/logging.txt","official":"https://docs.djangoproject.com/ga/6.0/ref/logging/","inVersions":["6.1","6.0","5.2"],"inLocales":["en","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}