[UNIX, Linux, Windows, IBM i]

Diagnosenachrichtenservices

Die folgenden Diagnosenachrichtenservices und ihre servicespezifischen Attribute, die in den Zeilengruppen DiagnosticSystemMessages, DiagnosticMessages und DiagnosticMessagesTemplate der Konfigurationsdateien angegeben sind, können definiert werden:

Die folgenden Diagnosenachrichtenservices sind definiert:
Datei
Dieser Service sendet alle ungefilterten Nachrichten an eine Datei auf ähnliche Weise an den Service QMErrorLog. Je nach angegebener Format wird entweder das vorhandene Textformat oder das angegebene JSON-Format verwendet. Standardmäßig gibt es drei Dateien mit den Namen AMQERR01.LOG, AMQERR02.LOGund AMQERR03.LOG oder AMQERR01.json, AMQERR02.jsonund AMQERR03.json, abhängig von der Eigenschaft Format , und diese Rollover basieren auf der konfigurierten Größe.
Die folgenden Attribute werden nur in einer Datei-Zeilengruppe unterstützt:
FilePath
Der Pfad zu der Position, in die Protokolldateien geschrieben wurden. Der Standardwert ist dieselbe Position wie die AMQERR01.log-Dateien, d. h. System- oder Warteschlangenmanager. Der Pfad muss absolut sein, er kann jedoch austauschbare Einfügungen enthalten. For example:
+ MQ_Q_MGR_DATA_PATH +
Der vollständige Pfad zum übergeordneten Verzeichnis des Nachrichtenverzeichnisses des Warteschlangenmanagerdiagnoseprogramms. Die Standardwerte lauten wie folgt:
  • [AIX][Linux]Auf AIX® and Linux® Plattformen: /var/mqm/qmgrs/<QM_name>
  • [Windows]auf Windows, C:\Program Data\IBM\MQ\qmgrs\<QM_name>
+ MQ_DATA_PATH +
Der vollständige Pfad zum übergeordneten Element des Nachrichtenverzeichnisses für Systemdiagnosen. Die Standardwerte lauten wie folgt:
  • [AIX][Linux]Auf AIX and Linux Plattformen:/var/mqm
  • [Windows]Auf Windows: C:\Program Data\IBM\MQ
Sie müssen diesen Pfad mit den entsprechenden Berechtigungen erstellen, wenn er das vorhandene Fehlerverzeichnis nicht verwendet.
FilePrefix
Das Präfix der Protokolldateien. Der Standardwert ist AMQERR.
FileSize
Die Größe, in der sich das Protokoll überrollt. Der Standardwert ist 32MB, wie bei der ErrorLogSize Eigenschaft der StanzaQMErrorLog, die semantisch identisch ist.
Hinweis: Die Eigenschaft ErrorLogSize gilt nur für den Standardfehlerprotokollservice, nicht für angepasste Diagnoseservices.

Sie können die Größe des Protokolls mit der Umgebungsvariablen MQMAXERRORLOGSIZE festlegen.

Format
Das Format der Datei. Der Wert kann entweder text (für zusätzliche QMErrorLog-Stilservices) oder json sein, der Standardwert ist.
Das Suffix der Datei ist entweder .LOG oder .json abhängig von der Einstellung dieses Attributs.
Bearbeiten Sie beispielsweise die qm.ini-Datei des Warteschlangenmanagers, und fügen Sie die folgende Zeilengruppe hinzu:

DiagnosticMessages:
   Service = File
   Name = JSONLogs
   Format = json
   FilePrefix = AMQERR
Nach dem Neustart hat der Warteschlangenmanager AMQERR0x.json-Dateien in seinem Verzeichnis ERRORS.
Sie können mehrere Dateiservices definieren. Dies ermöglicht die Konfiguration wie in den folgenden Beispielen gezeigt, in denen Nachrichten unterschiedlicher Tags über verschiedene Protokollgruppen aufgeteilt werden:

DiagnosticMessages:
  Name=ErrorsToFile
  Service=File
  Severities=E+
  FilePrefix=OnlyErrors

DiagnosticMessages:
  Name=NonErrorstoFile
  Service=File
  Severities=I,W
  FilePrefix=InformationandWarning
[AIX][Linux]Syslog
Der Syslog-Service ist unter Windows und IBM i nicht verfügbar
Sie können nur einen Syslog-Service definieren und der Syslog-Service sendet alle ungefilterten Nachrichten an syslog unter Verwendung der Spezifikation für Diagnosenachrichten im JSON-Format . Die Informationen werden dem Systemprotokoll in der in der Tabelle angegebenen Reihenfolge hinzugefügt, beginnend mit dem Parameter msgID und den Einfügungen.
Der Schweregrad der Nachricht wird auf folgende Weise auf die Systemprotokollstufe (syslog) abgebildet:
Tabelle 1. Zuordnung der Nachrichtenbewertung zur Syslog-Ebene
Bewertung Ebene
0 LOG_INFO
10 LOG_WARNUNG
20 LOG_ERR
30 LOG_ERR
40 LOG_ALERT
50 LOG_ALERT
Das folgende Attribut wird nur in einer syslog-Zeilengruppe unterstützt:
Ident
Definiert den Wert ident, der den Syslog-Einträgen zugeordnet ist. Der Standardwert ist ibm-mq.
Das folgende Beispiel zeigt Fehlernachrichten, die an Syslog gesendet werden:

DiagnosticMessages:
  Name=ErrorsToSyslog
  Ident=mq 
  Service=Syslog
  Severities=E+

Weitere Informationen zu den generischen Stanza-Attributen finden Sie unter Stanzas für Diagnosemeldungen.

Hinweise:
  1. Nur für den Dateiservice können mehrere Zeilengruppen mit jeweils einem anderen Namen vorhanden sein. Nur die Definition, die den endgültigen Namen in der Sequenz verwendet, wird wirksam.
  2. Änderungen am Wert einer Zeilengruppe treten erst in Kraft, wenn der WS-Manager erneut gestartet wird.