Pipelineprotokollierungskomponenten erleichtern die Erstellung von angepassten Pipelineprotokollierungskonfigurationen. Sie liefern dem System Anweisungen zum Protokollieren von Pipelineereignissen und -nachrichten.
- Protokollausgabeprogramm
- Gibt an, welches Protokollausgabeprogramm zum Schreiben oder Anzeigen der Protokolldatei verwendet werden soll:
- file
- Die Protokollereignisse und -nachrichten werden in eine angegebene Datei geschrieben.
- Das Protokollausgabeprogramm file verwendet die Protokollierungskomponenten Pfad, Parameter, Leerraum und Filter. Beispiel:
- file://absoluter_path?parameter [leerraum] filter
- cmeadmin
- Die Protokollereignisse und -nachrichten werden in das Protokoll cmeadmin geschrieben.
- Das Protokollausgabeprogramm cmeadmin verwendet die Protokollierungskomponenten Leerraum und Filter.
Beispiel:
- cmeadmin://[leerraum] filter
- console
- Die Protokollereignisse und -nachrichten werden in die Befehlszeilenkonsole geschrieben.
- Das Protokollausgabeprogramm console verwendet die Protokollierungskomponenten Position, Parameter und Filter. Beispiel:
- console://dateiposition?parameter filter
- eventlog
- (Nur Microsoft Windows-Plattformen) Die Protokollereignisse und -nachrichten werden in die Microsoft Windows-Ereignisanzeige geschrieben.
- Das Protokollausgabeprogramm eventlog verwendet die Protokollierungskomponente Filter. Beispiel:
- eventlog://./filter
- Pfad
- Gibt die Position und den Namen der Datei an, in die die Protokolldaten geschrieben werden sollen:
- Dateiadresse
- Folgende Werte sind gültig:
- stdout - für das Protokollausgabeprogramm console
- stderr - für das Protokollausgabeprogramm console
- absoluter_pfad - für das Protokollausgabeprogramm file
- Dateiname
- Gibt an, in welche IBM Relationship Resolution-Standarddatei die Informationen geschrieben werden sollen. Folgende Werte sind gültig:
- .err
- .bad
- .msg
- .SqlDebug.log
- .SqlErr.log
- .MQErr.log
- Parameter
- Gibt optionale Protokollierungsparameter an. Folgende Werte sind gültig:
- style=bare
- Gibt an, dass die Protokollierung keine Zeitmarken oder andere Kopfdaten enthält. Dieser Parameter ist normalerweise in Dateien enthalten, die UMF-Nachrichten protokollieren.
- rotateSize=maximale_dateigröße
- Gibt die maximale Dateigröße der Protokolldatei in Kilobyte an. Wenn die Protokolldatei die maximale Dateigröße überschreitet, archiviert das System die Datei automatisch und erstellt eine neue Datei für die Protokollierung. Das System hängt eine 0 an den Namen der Archivdatei an, und die neue Datei übernimmt den ursprünglichen Dateinamen. Dieser Vorgang wird so lange fortgesetzt, bis das System die maximale Anzahl Archivdateien erreicht, die im Parameter keep angegeben ist.
- keep=maximale anzahl archivdateien
- Gibt die maximale Anzahl der Archivdateien an, die während der automatischen Dateirotation gemäß dem Parameter rotateSize aufbewahrt werden sollen. Wird die maximale Anzahl Dateien überschritten, überschreibt das System die älteste Archivprotokolldatei mit den neuen Protokolldaten.
- Leerraum
- Gibt an, welche Art Leerraum in die Protokolldatei eingefügt werden soll. Folgende Werte sind gültig:
- Filter
- Gibt die aufzuzeichnenden Protokolldaten an. Folgende Werte sind gültig:
- Modul
- Gibt den Typ der zu protokollierenden Nachrichten an. Folgende Werte sind gültig:
- $NODE_NAME - generische Nachrichten
- sql - SQL-Nachrichten
- mq - Nachrichtenwarteschlangennachrichten
- bad_xml - ungültige oder fehlerhafte UMF-Nachrichten
- msg - UMF-Ausnahmebedingungen
- logger - Nachrichten der Protokollfunktion
Sollen alle Modultypen angegeben werden, verwenden Sie das Platzhalterzeichen * (Stern). Beispiel:
- console://stdout *.ERR
- Wertigkeit
- Gibt die Wertigkeit der Protokollnachricht an. Folgende Werte sind gültig:
- CRIT - kritische Nachrichten
- ERR - Fehlernachrichten
- WARN - Warnungen
- NOTE - Hinweise
- INFO - Informationsnachrichten
- PERF - Leistungsnachrichten
- DBUG - Debugnachrichten
Sollen alle Wertigkeitstypen angegeben werden, verwenden Sie das Platzhalterzeichen * (Stern). Beispiel:
- console://stdout *.*
- Soll eine Wertigkeit nicht berichtet werden, verwenden Sie das Ausrufezeichen. Beispiel:
- console://stdout mq.!DBUG