Protokollnamensräume, -ebenen und -aktivitäten

Der Message Queue-Anbieter definiert mehrere Protokollnamensräume, die mit Protokollebenen und Protokollaktivitäten verknüpft sind, über die Message Queue-Clients Verbindungs- und Sitzungsereignisse protokollieren können, sofern die Protkollkonfiguration entsprechend festgelegt wurde.

Der Root-Protokollnamensraum für die Message Queue-Client-Laufzeit ist als javax.jms definiert. Für alle Protokolle in der Message Queue-Client-Laufzeit wird dieser Name als übergeordneter Namensraum verwendet.

Die für die Message Queue-Client-Laufzeit verwendeten Protokollebenen stimmen mit denen überein, die in der java.util.logging.Level-Klasse definiert sind. Diese Klasse definiert sieben Standardprotokollebenen und zwei zusätzliche Einstellungen, über die Sie die Protokollierung aktivieren bzw. deaktivieren können.

OFF

Deaktiviert die Protokollierung.

SEVERE

Höchste Priorität, höchster Wert. Anwendungsdefiniert.

WARNING

Anwendungsdefiniert.

INFO

Anwendungsdefiniert.

CONFIG

Anwendungsdefiniert.

FINE

Anwendungsdefiniert.

FINER

Anwendungsdefiniert.

FINEST

Niedrigste Priorität, niedrigster Wert. Anwendungsdefiniert.

ALL

Aktiviert die Protokollierung aller Nachrichten.

Im Allgemeinen werden Ausnahmen und Fehler, die zur Message Queue-Client-Laufzeit auftreten, im Protokoll mit dem javax.jms-Namensraum erfasst.

• Ausnahmefehler, die von der JVM ausgelöst und von der Client-Laufzeit abgefangen werden, z. B. IOException, werden bei der Protokollierung mit dem Protokollnamensraum javax.jms auf der Ebene WARNING erfasst.

• JMS-Ausnahmen, die von der Client-Laufzeit ausgelöst werden, z. B. IllegalStateException , werden bei der Protokollierung mit dem Protokollnamensraum javax.jms auf der Ebene FINER erfasst.

• Fehler, die von der JVM zurückgegeben und von der Client-Laufzeit abgefangen werden, z. B. OutOfMemoryError, werden bei der Protokollierung mit dem Protokollnamensraum javax.jms auf der Ebene SEVERE erfasst.

In den folgenden Tabellen sind die Ereignisse aufgelistet, die protokolliert werden können, sowie die Protokollebene, die festgelegt werden muss, um Ereignisse für JMS-Verbindungen und für Sitzungen zu protokollieren.

Die folgende Tabelle enthält Beschreibungen der Protokollebenen und Ereignisse für Verbindungen.

Tabelle 1–6 Protokollebenen und Ereignisse für den javax.jms.connection -Namensraum

Protokollebene	Ereignisse
FINE	Verbindung erstellt
FINE	Verbindung geöffnet
FINE	Verbindung geschlossen
FINE	Verbindung unterbrochen
FINE	Verbindung wiederhergestellt
FINER	Diverse Verbindungsaktivitäten wie z. B. setClientID
FINEST	Nachrichten, Bestätigungen, Message Queue-Aktion und Steuerungsmeldungen (wie das Durchführen einer Transaktion)

Für Sitzungen werden die folgenden Informationen im Protokolleintrag erfasst.

• Jeder Protokolleintrag für eine an den Konsumenten übermittelte Nachricht umfasst ConnectionID, SessionID und ConsumerID.

• Jeder Protokolleintrag für eine Nachricht, die von einem Produzenten gesendet wurde, umfasst ConnectionID, SessionID, ProducerID und Zielname.

Die folgende Tabelle enthält Beschreibungen der Protokollebenen und Ereignisse für Sitzungen.

Tabelle 1–7 Protokollebenen und Ereignisse für den javax.jms.session -Namensraum

Protokollebene	Ereignis
FINE	Sitzung erstellt
FINE	Sitzung geschlossen
FINE	Produzent erstellt
FINE	Konsument erstellt
FINE	Ziel erstellt
FINER	Diverse Sitzungaktivitäten wie z. B. das Durchführen einer Sitzung.
FINEST	Produzierte und konsumierte Nachrichten. (Nachrichteneigenschaften und -texte werden in den Protokolleinträgen nicht erfasst.)

Die Ausgabeprotokollebene wird standardmäßig aus der JRE übernommen, in der die Anwendung ausgeführt wird. Überprüfen Sie die Datei JRE_DIRECTORY/lib/logging.properties , um diese Ebene zu bestimmen.

Sie haben die Möglichkeit, die Protokollierung programmatisch oder mithilfe von Konfigurationsdateien zu konfigurieren. Zudem können Sie den Umfang der Protokollierung steuern. In den folgenden Abschnitten werden diese Möglichkeiten erläutert.