LogáilLink to this heading#

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

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

Nuair: Socrú: Is é DEBUG True:

• 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.

Nuair: Socrú: Is é DEBUG False:

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

Neamhspleách ar luach: socrú: DEBUG:

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

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.

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

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

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:

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

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

LogálaíLink to this heading#

Soláthraíonn Django roinnt loggers ionsuite.

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

LáimhseálaitheLink to this heading#

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

class AdminEmailHandler(include_html=False, email_backend=None, reporter_class=None)Link to this definition#

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

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.

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

Ú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:

Code

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

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.

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

Code

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

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

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:

Code

"handlers": {
    "mail_admins": {
        "level": "ERROR",
        "class": "django.utils.log.AdminEmailHandler",
        "include_html": True,
        "reporter_class": "somepackage.error_reporter.CustomErrorReporter",
    },
}

send_mail(subject, message, *args, **kwargs)Link to this definition#

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ú.

ScagairíLink to this heading#

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

class CallbackFilter(callback)Link to this definition#

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.

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:

Code

from django.http import UnreadablePostError


def skip_unreadable_post(record):
    if record.exc_info:
        exc_type, exc_value = record.exc_info[:2]
        if isinstance(exc_value, UnreadablePostError):
            return False
    return True

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

Code

LOGGING = {
    # ...
    "filters": {
        "skip_unreadable_posts": {
            "()": "django.utils.log.CallbackFilter",
            "callback": skip_unreadable_post,
        },
    },
    "handlers": {
        "mail_admins": {
            "level": "ERROR",
            "filters": ["skip_unreadable_posts"],
            "class": "django.utils.log.AdminEmailHandler",
        },
    },
    # ...
}

class RequireDebugFalseLink to this definition#

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

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

Code

LOGGING = {
    # ...
    "filters": {
        "require_debug_false": {
            "()": "django.utils.log.RequireDebugFalse",
        },
    },
    "handlers": {
        "mail_admins": {
            "level": "ERROR",
            "filters": ["require_debug_false"],
            "class": "django.utils.log.AdminEmailHandler",
        },
    },
    # ...
}

class RequireDebugTrueLink to this definition#

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