cupsd-logs

NAME

cupsd-logs - Cupsd-Protokolldateien (access_log, error_log und page_log)

BESCHREIBUNG

cupsd(8) verwaltet normalerweise drei Protokolldateien: access_log, um Anfragen, die an den Auftragsplaner eingereicht wurden, nachzuverfolgen, error_log, um den Fortgang und Fehler nachzuverfolgen und page_log, um gedruckte Seiten nachzuverfolgen. Konfigurationsdirektiven in cupsd.conf(5) und cups-files.conf(5) regeln, welche Informationen protokolliert und wo sie gespeichert werden.

ZUGRIFFSPROTOKOLL-DATEIFORMAT

Die Datei access_log führt jede HTTP-Ressource auf, auf die durch einen Web-Browser oder -Client zugegriffen wird. Jede Zeile ist eine ausführliche Version des sogenannten »Common Log Format«, wie es von vielen Web-Servern und Web-Berichtswerkzeugen verwandt wird:

     Rechner Gruppe Benutzer Datum-Zeit "Methode Ressource Version" Status Bytes       Ipp-Vorgang Ipp-Status

Zum Beispiel:

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

Das Feld Rechner enthält normalerweise nur eine IP-Adresse, es sei denn, Sie haben die Direktive HostNameLookups in der Datei cupsd.conf aktiviert oder die IP-Adresse entspricht Ihrem lokalen Rechner. Das Feld Gruppe enthält immer »-«. Das Feld Benutzer enthält den authentifizierten Benutzernamen des anfragenden Benutzers. Falls kein Benutzername und Passwort für die Anfrage bereitgestellt wurde, enthält dieses Feld »-«. Das Feld Datum-Zeit enthält das Datum und die Uhrzeit der Anfrage in lokaler Zeit und im Format »[TT/MON/JJJJ:HH:MM:SS +ZZZZ]«. Das Feld Methode enthält die verwandte HTTP-Methode: »GET«, »HEAD«, »OPTIONS«, »POST« oder PUT«. »GET«-Anfragen werden verwandt, um Dateien vom Server zu erhalten, sowohl für die Web-Schnittstelle als auch um die Konfigurations- und Protokolldateien zu erhalten. »HEAD«-Anfragen werden zum Erhalt von Informationen über eine Ressource vor einem »GET« verwandt. »OPTIONS«-Anfragen werden zum Hochstufen einer Anfrage auf TLS-Verschlüsselung verwandt. »POST«-Anfragen werden für Webformulare und IPP-Anfragen verwandt. »PUT«-Anfragen dienen dem Hochladen von Konfigurationsdateien. Das Feld Ressource ist der Dateiname der angefragten Ressource. Das Feld Version ist die vom Client verwandte HTTP-Spezifikationsversion. Für CUPS-Clients wird sie stets »HTTP/1.1« sein. Das Feld Status enthält den HTTP-Ergebnisstatus der Anfrage, wie folgt: Das Feld Bytes enthält die Anzahl an Bytes in der Anfrage. Für POST-Anfragen enthält das Feld Bytes die Anzahl von Bytes in nicht IPP-Daten, die vom Client empfangen wurden. Das Feld Ipp-Vorgang enthält entweder »-« für nicht IPP-Anfragen oder den IPP-Vorgangsnamen für POST-Anfragen, die eine IPP-Anfrage enthalten. Das Feld Ipp-Status enthält entweder »-« für nicht IPP-Anfragen oder den IPP-Status-Codenamen für POST-Anfragen, die eine IPP-Antwort enthalten.

FEHLERPROTOKOLL-DATEIFORMAT

Die Datei error_log listet Nachrichten vom Auftragsplaner auf - Fehler, Warnungen usw. Die Direktive LogLevel in der Datei cupsd.conf(5) steuert, welche Nachrichten protokolliert werden:

    Stufe Datum-Uhrzeit Nachricht

Zum Beispiel:

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

Das Feld Stufe enthält den Typ der Nachricht:

A

Warnungsnachricht (LogLevel alert)

C

Kritische Fehlernachricht (LogLevel crit)

D

Fehlersuchnachricht (LogLevel debug)

d

Detaillierte Fehlersuchnachricht (LogLevel debug2)

E

Normale Fehlernachricht (LogLevel error)

I

Informative Nachricht (LogLevel info)

N

Hinweisnachricht (LogLevel notice)

W

Warnungsnachricht (LogLevel warn)

X

Notfallfehlernachricht (LogLevel emerg)

Das Feld Datum-Zeit enthält das Datum und die Uhrzeit vom Beginn des Drucks. Das Format dieses Feldes ist identisch zu dem Datum-Uhrzeit-Feld in der Datei access_log. Das Feld Nachricht enthält eine formlose Textnachricht. Nachrichten von Auftragsfiltern haben den Präfix »[Job NNN]«, wobei »NNN« die Auftrags-ID ist.

SEITENPROTOKOLL-DATEIFORMAT

Die Datei page_log listet die Gesamtzahl an gedruckten Seiten (Blättern) auf. Standardmäßig enthält jede Zeile die folgenden Informationen:

     Drucker Benutzer Auftrags-ID Datum-Uhrzeit total Anzahl-Blätter       Auftrags-Abrechnung Auftrags-erstellender-Rechnername Auftragsname Medium Seiten

Beispielsweise könnte der Eintrag für einen zweiseitigen Auftrag namens »meinAuftrag« wie folgt aussehen:

    DeskJet root 1 [20/May/1999:19:21:06 +0000] total 2 acme-123
      localhost meinAuftrag na_letter_8.5x11in one-sided

Die Direktive PageLogFormat in der Datei cupsd.conf(5) kann zum Ändern der Information verwandt werden. Das Feld Drucker enthält den Namen des Druckers, der die Seite gedruckt hat. Falls Sie einen Auftrag an eine Druckerklasse gesendet haben, wird dieses Feld den Namen des Druckers enthalten, dem dieser Auftrag zugewiesen wurde. Das Feld Benutzer enthält den Namen des Benutzers (des IPP-Attributs requesting-user-name), der diesen Auftrag zum Druck eingereicht hat. Das Feld Auftrags-ID enthält die Auftragsnummer der im Druck befindlichen Seite. Das Feld Datum-Uhrzeit enthält das Datum und die Uhrzeit, zu dem der Druck der Seite begonnen wurde. Das Format dieses Feldes ist identisch zu dem Datum-Uhrzeit-Feld in der Datei access_log. Das Feld Anzahl-Blätter stellt die Gesamtzahl an Seiten (Blättern) bereit, auf die für den Auftrag gedruckt wurde. Das Feld Auftrags-Abrechnung enthält eine Kopie der mit den IPP-Create-Job- oder -Print-Job-Anfragen bereitgestellten Attribute »job-billing« oder »job-account-id« oder »-«, falls keines der beiden bereitgestellt wurde. Das Feld Auftrags-erstellender-Rechnername enthält den Rechnernamen oder die IP-Adresse des Clients, der den Auftrag gedruckt hat. Das Feld Auftragsname enthält eine Kopie des mit der IPP-Anfrage »Create-Job« oder »Print-Job« bereitgestellten Attributes »job-name« oder »-«, falls keines bereitgestellt wurde. Das Feld Medium enthält eine Kopie des mit der IPP-Anfrage »Create-Job« oder »Print-Job« bereitgestellten Attribute »media« oder »media-col/media-size« oder »-«, falls keines der beiden bereitgestellt wurde. Das Feld Seiten enthält eine Kopie des mit der IPP-Anfrage »Create-Job« oder »Print-Job« bereitgestellten Attributs »sides« oder »-«, falls keines bereitgestellt wurde.

SIEHE AUCH

cupsd(8), cupsd.conf(5), cups-files.conf(5), CUPS-Online-Hilfe (http://localhost:631/help)

COPYRIGHT

Copyright © 2021-2022 by OpenPrinting.