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.
Deaktiviert die Protokollierung.
Höchste Priorität, höchster Wert. Anwendungsdefiniert.
Anwendungsdefiniert.
Anwendungsdefiniert.
Anwendungsdefiniert.
Anwendungsdefiniert.
Anwendungsdefiniert.
Niedrigste Priorität, niedrigster Wert. Anwendungsdefiniert.
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.