Scroll to navigation

cupsd-logs(5) OpenPrinting cupsd-logs(5)

NOM

cupsd-logs - Fichiers de journalisation de cupsd (access_log, error_log et page_log)

DESCRIPTION

cupsd(8) entretient habituellement trois fichiers de journal : access_log pour suivre les requêtes soumises à l’ordonnanceur, error_log pour suivre le déroulement et les erreurs et page_log pour suivre l’impression des pages. Les directives de configuration dans cupsd.conf et cups-files.conf déterminent quelles informations sont journalisées et leur lieu de stockage.

FORMAT DU FICHIER ACCES LOG

Le fichier access_log liste chaque ressource HTTP jointe par un navigateur ou client web. Chaque ligne est une version étendue du format appelé « Common Log Format » utilisé par de nombreux serveurs web et outils de compte-rendu web :



    hôte groupe utilisateur date-heure "méthode ressource version" état octets       ipp-opération ipp-état

Par exemple :



    10.0.1.2 - - [01/Dec/2005:21:50:28 +0000] "POST / HTTP/1.1" 200 317


      CUPS-Get-Printers successful-ok-ignored-or-substituted-attributes


    localhost - - [01/Dec/2005:21:50:32 +0000] "GET /admin HTTP/1.1"


      200 0 - -


    localhost - - [01/Dec/2005:21:50:32 +0000] "POST / HTTP/1.1"


      200 157 CUPS-Get-Printers


      successful-ok-ignored-or-substituted-attributes


    localhost - - [01/Dec/2005:21:50:32 +0000] "POST / HTTP/1.1"


      200 1411 CUPS-Get-Devices -


    localhost - - [01/Dec/2005:21:50:32 +0000] "GET /admin HTTP/1.1"


      200 6667 - -

Le champ host se compose uniquement d’une adresse IP à moins que la directive ne soit activée dans le fichier cupsd.conf ou que l’adresse IP corresponde à votre machine locale.

Le champ groupe contient toujours « - ».

Le champ utilisateur est l’identifiant authentifié de l’auteur de la requête. Si aucun identifiant et mot de passe ne sont fournis pour la requête, alors ce champ contient « - ».

Le champ date-heure se compose des date et heure locales de la requête dans le format « [DD/MON/YYYY:HH:MM:SS +ZZZZ] ».

Le champ méthode est la méthode HTTP utilisée : « GET », « HEAD », « OPTIONS », « POST » ou « PUT ». Les requêtes « GET » sont utilisées pour obtenir des fichiers du serveur, à la fois pour l’interface web et pour obtenir les fichiers de configuration et de journal. Les requêtes « HEAD » sont utilisées pour obtenir de l’information avant un « GET ». Les requêtes « OPTIONS » sont utilisées pour basculer les connexions en chiffrement TLS.Les requêtes « POST » sont utilisées pour les formulaires de l’interface web et les requêtes IPP. Les requêtes « PUT » sont utilisées pour téléverser les fichiers de configuration.

Le champ ressource est le nom de fichier de la ressource demandée.

Le champ version est la spécification de version HTTP utilisée par le client. Pour les clients, cela sera toujours « HTTP/1.1 ».

Le champ état contient l’état HTTP résultant de la requête de la manière qui suit :

200
Opération réussie.
201
Fichier créé ou modifié avec succès.
304
Le fichier demandé n’a pas changé.
400
Mauvaise requête HTTP ; généralement cela signifie qu’un programme malicieux essaie d’accéder au serveur.
401
Non autorisé, une authentification est nécessaire (identifiant + mot de passe).
403
Accès interdit ; généralement cela signifie qu’un client essaie d’accéder à un fichier ou à une ressource, sans la permission d’accès.
404
Ce fichier ou cette ressource n’existe pas.
405
La méthode d’accès à l’URL n’est pas permise ; généralement cela signifie que le navigateur web utilise le serveur comme un mandataire.
413
Requête trop importante ; généralement cela signifie qu’un client essaie d’imprimer un fichier plus important que MaxRequestSize n’autorise.
426
Basculer en connexion chiffrée avec TLS.
500
Erreur du serveur ; généralement cela se produit lorsque le serveur est incapable de créer ou ouvrir un fichier ; consultez le journal d’erreur pour plus de détails.
501
Le client demande un chiffrement mais la prise en charge d’un chiffrement n’est pas activée ou intégrée.
505
Numéro de version HTTP non pris en charge ; généralement cela signifie qu’un programme malicieux essaie d’accéder au serveur.

Le champ octets contient le nombre d’octets de la requête. Pour les requêtes POST, le champ octets contient le nombre d’octets de données non IPP reçues du client.

Le champ ipp-opération contient soit « - » pour les requêtes non IPP, ou le nom d’opération IPP pour les requêtes POST contenant une requête IPP.

Le champ ipp-état contient soit « - » pour les requêtes non IPP, ou le nom de code d’état IPP pour les requêtes POST contenant une réponse IPP.

FORMAT DU FICHIER DE JOURNAL D’ERREURS

Le fichier error_log liste les messages de l’ordonnanceur — erreurs, avertissements, etc. La directive LogLevel dans le fichier cupsd.conf détermine quels messages sont journalisés :



    niveau date-heure message

Par exemple :



    I [20/May/1999:19:18:28 +0000] [Job 1] Queued on 'DeskJet' by 'mike'.


    D [20/May/1999:19:18:28 +0000] [Job 1] argv[0]="DeskJet"


    D [20/May/1999:19:18:28 +0000] [Job 1] argv[1]="1"


    D [20/May/1999:19:18:28 +0000] [Job 1] argv[2]="mike"


    D [20/May/1999:19:18:28 +0000] [Job 1] argv[3]="myjob"


    D [20/May/1999:19:18:28 +0000] [Job 1] argv[4]="1"


    D [20/May/1999:19:18:28 +0000] [Job 1] argv[5]="media=


      na_letter_8.5x11in sides=one-sided"


    D [20/May/1999:19:18:28 +0000] [Job 1] argv[6]="/var/spool/cups/


      d000001-001"


    I [20/May/1999:19:21:02 +0000] [Job 2] Queued on 'DeskJet' by 'mike'.


    I [20/May/1999:19:22:24 +0000] [Job 2] Canceled by 'mike'.

Le champ level contient le type of message :

Message d’alerte (LogLevel alert)
Message d’erreur critique (LogLevel crit)
Messages de débogage (LogLevel debug)
Messages de débogage détaillés (LogLevel debug2)
Messages d’erreur normaux (LogLevel error)
Messages d'information (LogLevel info).
Messages d’annonce (LogLevel notice)
Messages d’avertissement (LogLevel warn)
Messages d’erreur urgents (LogLevel emerg)

Le champ date-time contient la date et heure du début d’impression de la page. Le format de ce champ est identique au format du champ date-heure du fichier access_log.

Le champ message contient un message textuel de forme libre. Les messages des filtres de travail sont préfixés avec « [Job NNN] » où « NNN » est l’identifiant du travail.

FORMAT DE PAGE DE JOURNAL

Le fichier page_log liste le nombre total de pages (feuilles) envoyées à l’imprimante. Par défaut, chaque ligne contient les informations suivantes :



    impri utilisateur idt_tâche date_heure total nb_feuilles fact_tâche       hôte_orig_tâche nom_tâche média faces

Par exemple, les entrées pour un travail de deux pages appelé « myjob » peut ressembler à :



    DeskJet root 1 [20/May/1999:19:21:06 +0000] total 2 acme-123


      localhost myjob na_letter_8.5x11in one-sided

La directive PageLogFormat dans le fichier cupsd.conf peut être utilisée pour changer cette information.

Le champ impri contient le nom de l’imprimante ayant imprimé la page. Si le travail est envoyé à une classe d’imprimantes, ce champ contient le nom de l’imprimante à laquelle la tâche est assignée.

Le champ utilisateur contient le nom de l’utilisateur (l’attribut IPP requesting-user-name) qui a demandé l’impression.

Le champ idt_tâche contient le numéro de travail de la page en cours d’impression.

Le champ date_heure contient la date et l’heure de démarrage de l’impression de la page. Le format de ce champ est identique au format du champ date_heure du fichier access_log.

Le champ nb_feuilles fournit le nombre total de pages (feuilles) imprimées pour la tâche.

Le champ fact_tâche contient une copie des attributs job-billing ou job-account-id fournis par les requêtes IPP Create-Job ou Print-Job, ou « - » si aucune n’a été faite.

Le champ hôte_orig_tâche contient le nom d’hôte ou l’adresse IP du client qui a imprimé le travail.

Le champ nom_tâche contient une copie de l’attribut job-name fourni par les requêtes IPP Create-Job ou Print-Job ou « - » si aucune n’a été faite.

Le champ média contient une copie de l’attribut media ou media-col/media-size fourni par les requêtes IPP Create-Job ou Print-Job ou « - » si aucune n’a été faite.

Le champ faces contient une copie de l’attribut sides fourni par les requêtes IPP Create-Job ou Print-Job ou « - » si aucune n’a été faite.

VOIR AUSSI

cupsd(8), cupsd.conf(5), cups-files.conf(5), aide en ligne de CUPS <URL:http://localhost:631/help>

COPYRIGHT

Copyright © 2021-2023 by OpenPrinting.

CUPS 28 février 2021