cupsd-logs

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 à lordonnanceur, error_log pour suivre le dérou
   lement et les erreurs et page_log pour suivre limpression 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 dune adresse IP à moins que la directive ne soit activée dans le fichier cupsd.conf ou que ladresse  IP  corresponde  à
   votre machine locale.

   Le champ groupe contient toujours « - ».

   Le  champ utilisateur est lidentifiant authentifié de lauteur 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 fi
   chiers  du serveur, à la fois pour linterface web et pour obtenir les fichiers de configuration et de journal. Les requêtes « HEAD » sont utilisées pour ob
   tenir de linformation 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 linterface 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é na pas changé.

        400  Mauvaise requête HTTP ; généralement cela signifie quun programme malicieux essaie daccéder au serveur.

        401  Non autorisé, une authentification est nécessaire (identifiant + mot de passe).

        403  Accès interdit ; généralement cela signifie quun client essaie daccéder à un fichier ou à une ressource, sans la permission daccès.

        404  Ce fichier ou cette ressource nexiste pas.

        405  La méthode daccès à lURL nest 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 quun client essaie dimprimer un fichier plus important que MaxRequestSize nautorise.

        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 derreur
             pour plus de détails.

        501  Le client demande un chiffrement mais la prise en charge dun chiffrement nest pas activée ou intégrée.

        505  Numéro de version HTTP non pris en charge ; généralement cela signifie quun programme malicieux essaie daccéder au serveur.

   Le champ octets contient le nombre doctets de la requête. Pour les requêtes POST, le champ octets contient le nombre doctets 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 dopé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 lordonnanceur  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 :

   A    Message dalerte (LogLevel alert)

   C    Message derreur critique (LogLevel crit)

   D    Messages de débogage (LogLevel debug)

   d    Messages de débogage détaillés (LogLevel debug2)

   E    Messages derreur normaux (LogLevel error)

   I    Messages d'information (LogLevel info).

   N    Messages dannonce (LogLevel notice)

   W    Messages davertissement (LogLevel warn)

   X    Messages derreur urgents (LogLevel emerg)

   Le champ date-time contient la date et heure du début dimpression 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] »  « NNN » est lidenti
   fiant du travail.

FORMAT DE PAGE DE JOURNAL

   Le fichier page_log liste le nombre total de pages (feuilles) envoyées à limprimante. 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 limprimante ayant imprimé la page. Si le travail est envoyé à une classe dimprimantes, ce champ contient le nom de  lim
   primante à laquelle la tâche est assignée.

   Le champ utilisateur contient le nom de lutilisateur (lattribut IPP requesting-user-name) qui a demandé limpression.

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

   Le champ date_heure contient la date et lheure de démarrage de limpression 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
   na été faite.

   Le champ hôte_orig_tâche contient le nom dhôte ou ladresse IP du client qui a imprimé le travail.

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

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

   Le champ faces contient une copie de lattribut sides fourni par les requêtes IPP Create-Job ou Print-Job ou « - » si aucune na é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-2022 par OpenPrinting.

28 février 2021 CUPS cupsd-logs(5)