{"title":"Conas logáil a chumrú agus a úsáid","version":"6.0","locale":"ga","docname":"howto/logging","url":"/ga/6.0/howto/logging/","canonical":"https://djangodocs.dev/ga/6.0/howto/logging/","summary":"Soláthraíonn Django oibrí:ref: `cumraíocht logála réamhshocraithe `a leathnaítear go héasca.","html":"

Conas logáil a chumrú agus a úsáidLink to this heading#

\n\n

Soláthraíonn Django oibrí:ref: `cumraíocht logála réamhshocraithe <default-logging-configuration>`a leathnaítear go héasca.

\n
\n

Déan glao logála bunúsachLink to this heading#

\n

Chun teachtaireacht logála a sheoladh ó laistigh de do chód, cuireann tú glao logála isteach ann.

\n\n

First, import the Python logging library, and then obtain a logger instance\nwith logging.getLogger(). Provide the getLogger() method with a\nname to identify it and the records it emits. A good option is to use\n__name__ (see Úsáid spás ainmneacha logger below for more on this) which will\nprovide the name of the current Python module as a dotted path:

\n
Code
import logging\n\nlogger = logging.getLogger(__name__)\n
\n

Is coinbhinsiún maith é an dearbhú seo a dhéanamh ar leibhéal an mhodúil.

\n

Agus ansin i bhfeidhm, mar shampla i radharc, seol taifead chuig an logger:

\n
Code
def some_view(request):\n    ...\n    if some_risky_state:\n        logger.warning("Platform is running at risk")\n
\n

When this code is executed, a LogRecord containing that\nmessage will be sent to the logger. If you're using Django's default logging\nconfiguration, the message will appear in the console.

\n

Tá an leibhéal RABHADH ``a úsáidtear sa sampla thuas ar cheann de roinnt leibhéil déine logála `: `DEBUG, INFO`, RABHADH`, ERROR`<topic-logging-parts-loggers>, CRITICAL`. Mar sin, d'fhéadfadh sampla eile a bheith:

\n
Code
logger.critical("Payment system is not responding")\n
\n\n
\n
\n

Saincheapadh cumraíocht logálaLink to this heading#

\n

Cé go n-oibríonn cumraíocht logála Django as an mbosca, is féidir leat rialú go díreach conas a sheoltar do logaí chuig cinn scríbe éagsúla - chun comhaid, seirbhísí seachtracha, ríomhphost agus mar sin de - a logáil le roinnt cumraíochta breise.

\n

Is féidir leat a chumrú:

\n\n

Tá bealaí éagsúla ann chun logáil a chumrú. I Django, úsáidtear an socrú: setting: LOGGING is coitianta. <default-logging-definition>Úsáideann an socrú an fhormáid: ref: DictConfig <logging-config-dictschema>, agus leathnaíonn sé an:ref: cumraíocht logála réamhshocraithe.

\n

Féach: ref: configuring-loging le haghaidh míniú ar an gcaoi a ndéantar do shocruithe saincheaptha a chumasc le réamhshocruithe Django.

\n

Féach na:mod: Doiciméadú logála Python <python:logging.config>`le haghaidh sonraí faoi bhealaí eile chun logáil a chumrú. Ar mhaithe le simplíocht, ní mheasfaidh an doiciméadú seo cumraíocht ach tríd an socrú ``LOGGING.

\n
\n

Cumraíocht logála bunúsachLink to this heading#

\n

Agus logáil á chumrú agat, bíonn sé ciallmhar

\n
\n

Cruthaigh foclóir LOGGINGLink to this heading#

\n

I do settings.py`:

\n
Code
LOGGING = {\n    "version": 1,  # the dictConfig format version\n    "disable_existing_loggers": False,  # retain the default loggers\n}\n
\n

Tá sé ciallmhar beagnach i gcónaí an chumraíocht logála réamhshocraithe a choinneáil agus a leathnú trí “disable_existing_loggers” a shocrú go False.

\n
\n
\n

Cumraigh láimhseálaíLink to this heading#

\n

Cumraíonn an sampla seo láimhseálaí aonair darb ainm file, a úsáideann Python's:class: ~logging.fileHandler chun logaí de leibhéal DEBUG` agus níos airde chuig an gcomhad ``general.log (ag fréamh an tionscadail) a shábháil:

\n
Python
LOGGING = {\n    # ...\n    "handlers": {\n        "file": {\n            "class": "logging.FileHandler",\n            "filename": "general.log",\n        },\n    },\n}\n
\n

Different handler classes take different configuration options. For more\ninformation on available handler classes, see the\nAdminEmailHandler provided by Django and the various\nhandler classes provided by Python.

\n

Is féidir leibhéil logála a shocrú ar na láimhseálaithe freisin (de réir réamhshocraithe, glacann siad le teachtaireachtaí loga de gach leibhéal). Ag baint úsáide as an sampla thuas, ag cur leis:

\n
Python
{\n    "class": "logging.FileHandler",\n    "filename": "general.log",\n    "level": "DEBUG",\n}\n
\n

sainmhíníodh cumraíocht láimhseálaí nach nglacann ach taifid ar leibhéal ``DEBUG` agus níos airde.

\n
\n
\n

Cumraigh mapáil loggerLink to this heading#

\n

Chun taifid a sheoladh chuig an láimhseálaí seo, cumraigh mapáil logger chun é a úsáid mar shampla:

\n
Python
LOGGING = {\n    # ...\n    "loggers": {\n        "": {\n            "level": "DEBUG",\n            "handlers": ["file"],\n        },\n    },\n}\n
\n

Cinneann ainm na mapála cé na taifid logála a phróiseálfaidh sé. Tá an chumraíocht seo ("`) gan ainmne. Ciallaíonn sé sin go ndéanfaidh sé taifid a phróiseáil ó* lógairí uach* (féach:ref: naming-loggers thíos maidir le conas an t-ainm mapála a úsáid chun na logairí a phróiseálfaidh sé taifid a chinneadh).

\n

Cuirfidh sé teachtaireachtaí de leibhéil ``DEBUG` agus níos airde ar aghaidh chuig an láimhseálaí darb ainm ``comhad ``.

\n

Tabhair faoi deara gur féidir le logálaí teachtaireachtaí a chur ar aghaidh chuig láimhseálaithe iolracha, mar sin tá an gaol idir lógairí agus láimhseálaithe go leor.

\n

Má fhorghníomhaíonn tú:

\n
Code
logger.debug("Attempting to connect to API")\n
\n

i do chód, gheobhaidh tú an teachtaireacht sin sa chomhad general.log i bhfréamh an tionscadail.

\n
\n
\n

Cumraigh formáiditheoirLink to this heading#

\n

<logging.LogRecord>De réir réamhshocraithe, tá an chuid teachtaireachta de gach ceann: class: log record `sa aschur logála deiridh. Úsáid formáiditheoir más mian leat sonraí breise a chur san áireamh. Céad ainm agus sainmhínigh do chuid formáidithe - sainmhíníonn an sampla seo formáidithe darb ainm ``verbose` agus simpl:

\n
Python
LOGGING = {\n    # ...\n    "formatters": {\n        "verbose": {\n            "format": "{name} {levelname} {asctime} {module} {process:d} {thread:d} {message}",\n            "style": "{",\n        },\n        "simple": {\n            "format": "{levelname} {message}",\n            "style": "{",\n        },\n    },\n}\n
\n

Ligeann an eochairfhocal style duit { a shonrú for:meth: str.format nó $ formáidiú: class: `String.template; is é $` an réamhshocraithe.

\n

Féach: ref: logrecord-atritributes do thréithe: class: ~logging.logrecord is féidir leat a chur san áireamh.

\n

Chun formáiditheoir a chur i bhfeidhm ar láimhseálaí, cuir iontráil ``formáiditheoir ``le foclóir an láimhseálaí ag tagairt don fhormáiditheoir de réir ainm, mar shampla:

\n
Python
"handlers": {\n    "file": {\n        "class": "logging.FileHandler",\n        "filename": "general.log",\n        "formatter": "verbose",\n    },\n}\n
\n
\n
\n

Úsáid spás ainmneacha loggerLink to this heading#

\n

Gabhann an chumraíocht logála gan ainm ```logaí ó aon fheidhmchlár Python. Ní ghlacfaidh cumraíocht logála ainmnithe logaí ach ó logálaithe le hainmneacha meaitseála.

\n

The namespace of a logger instance is defined using\ngetLogger(). For example in views.py of my_app:

\n
Code
logger = logging.getLogger(__name__)\n
\n

cruthóidh sé logálaí sa spás ainmneacha my_app.views. Ligeann __name__ duit teachtaireachtaí logála a eagrú de réir a dtionscnaimh laistigh d'iarratais do thionscadail go huathoibríoch. Cinntíonn sé freisin nach mbeidh imbhuailtí ainmneacha agat.

\n

Gabhfaidh mapáil logaire darb ainm my_app.views taifid ón logger seo:

\n
Python
LOGGING = {\n    # ...\n    "loggers": {\n        "my_app.views": {...},\n    },\n}\n
\n

Beidh mapáil logálaí darb ainm my_app` níos ceadaithe, ag gabháil taifid ó loggers áit ar bith laistigh den spás ainmneacha my_app (lena n-áirítear my_app.views, my_app.utils`, agus mar sin de):

\n
Python
LOGGING = {\n    # ...\n    "loggers": {\n        "my_app": {...},\n    },\n}\n
\n

Is féidir leat spás ainmneacha logger a shainiú go sainráite freisin:

\n
Code
logger = logging.getLogger("project.payment")\n
\n

agus mharpálacha logaire a chur ar bun dá réir.

\n
\n
Ag baint úsáide as ordlathais logger agus iomadúLink to this heading#
\n

Is é ainmniú logger* ordlathach*. Is é my_app` tuismitheoir my_app.views, arb é tuismitheoir my_app.views.private. Mura sonraítear a mhalairt, iomadóidh mapáil logger na taifid a phróiseálann siad dá dtuismitheoirí - déanfar taifead ó logálaí sa spás ainmneacha my_app.views.private a láimhseáil le mapáil do my_app agus my_app.views` araon.

\n

Chun an t-iompar seo a bhainistiú, socraigh an eochair iomadaithe ar na mapálacha a shainmhíníonn tú:

\n
Code
LOGGING = {\n    # ...\n    "loggers": {\n        "my_app": {\n            # ...\n        },\n        "my_app.views": {\n            # ...\n        },\n        "my_app.views.private": {\n            # ...\n            "propagate": False,\n        },\n    },\n}\n
\n

Tá iomada réamhshocraithe go True. Sa sampla seo, ní láimhseálfaidh an tuismitheoir na logaí ó my_app.views.private`, ach déanfaidh logaí ó my_app.views`.

\n
\n
\n
\n
\n

Cumraigh logáil sofhreagrachLink to this heading#

\n

Tá logáil is úsáideach nuair a bhíonn an oiread faisnéise agus is féidir ann, ach ní faisnéis nach dteastaíonn uait - agus braitheann an méid a theastaíonn uait ar an méid atá á dhéanamh agat. Nuair a bhíonn tú ag dífhabhtú, teastaíonn leibhéal faisnéise uait a bheadh iomarcach agus neamhchabhrach dá mbeadh ort déileáil leis i dtáirgeadh.

\n

Is féidir leat logáil a chumrú chun an leibhéal sonraí a theastaíonn uait a sholáthar duit, nuair is gá duit é. Seachas an chumraíocht a athrú de láimh chun é seo a bhaint amach, is é bealach níos fearr ná cumraíocht a chur i bhfeidhm go huathoibríoch de réir an chomhshaoil.

\n

Mar shampla, d'fhéadfá athróg comhshaoil DJANGO_LOG_LEVEL a shocrú go cuí i do thimpeallachtaí forbartha agus stáitse, agus úsáid a bhaint as i mapáil logaire mar sin:

\n
Code
"level": os.getenv("DJANGO_LOG_LEVEL", "WARNING")\n
\n

- ionas nach gcuirfidh an chumraíocht seo ach taifid déine `RABHADH `RABHADH ``agus os cionn chuig a láimhseálaí mura sonraíonn an timpeallacht leibhéal logála níos ísle.

\n

Is féidir roghanna eile sa chumraíocht (mar shampla an rogha láimhseálaithe leibhéil ``nó `formáiditheoir) a bhainistiú ar an gcaoi chéanna.

\n
\n
","rootId":"how-to-configure-and-use-logging","toc":[{"title":"Déan glao logála bunúsach","anchor":"make-a-basic-logging-call","children":[]},{"title":"Saincheapadh cumraíocht logála","anchor":"customize-logging-configuration","children":[{"title":"Cumraíocht logála bunúsach","anchor":"basic-logging-configuration","children":[{"title":"Cruthaigh foclóir LOGGING","anchor":"create-a-logging-dictionary","children":[]},{"title":"Cumraigh láimhseálaí","anchor":"configure-a-handler","children":[]},{"title":"Cumraigh mapáil logger","anchor":"configure-a-logger-mapping","children":[]},{"title":"Cumraigh formáiditheoir","anchor":"configure-a-formatter","children":[]},{"title":"Úsáid spás ainmneacha logger","anchor":"use-logger-namespacing","children":[{"title":"Ag baint úsáide as ordlathais logger agus iomadú","anchor":"using-logger-hierarchies-and-propagation","children":[]}]}]},{"title":"Cumraigh logáil sofhreagrach","anchor":"configure-responsive-logging","children":[]}]}],"breadcrumbs":[{"docname":"howto/index","title":"Treoracha conas","url":"/ga/6.0/howto/"}],"prev":{"docname":"howto/static-files/index","title":"Conas comhaid statacha a bhainistiú (m.sh. íomhánna, JavaScript, CSS)","url":"/ga/6.0/howto/static-files/"},"next":{"docname":"howto/error-reporting","title":"Conas tuairisciú earráide a bhainisti","url":"/ga/6.0/howto/error-reporting/"},"formats":{"html":"/ga/6.0/howto/logging/","markdown":"/ga/6.0/howto/logging.md","json":"/ga/6.0/howto/logging.json"},"source":"https://github.com/django/django/blob/stable/6.0.x/docs/howto/logging.txt","official":"https://docs.djangoproject.com/ga/6.0/howto/logging/","inVersions":["6.1","6.0","5.2"],"inLocales":["en","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}