Einsatz von Trace-Objekten 

Verwendung

Verwenden Sie Trace-Objekte, um Zugriff auf Log- und Trace-Mechanismen zu erhalten.

uml_tracelib.wmf enthält das Klassendiagram in UML-Darstellung. Öffnen Sie hierzu Word und importieren Sie uml_tracelib.wmf als Grafik.

Voraussetzungen

Alle Trace-Objekte lesen ihre Konfigurationsinformationen aus dem Log Configurator. Siehe auch: Log Configurator Service

Funktionsumfang

Sie können folgende Methoden für das Trace-Objekt verwenden:

Methoden für den Trace

Methodenname	SAP J2EE Logging	SAP J2EE Tracing	Audits	Performance-Messung	Anmerkung
Trace	Ja	Ja	Nein	Ja	Constructor
Entering	Nein	Ja	Nein	Ja	Erster Aufruf in einer instrumentierten Methode, d.h. einer Methode, die mit Überwachungsfunktionen ausgestattet ist.
Exiting	Nein	Ja	Nein	Ja	Letzter Aufruf in einer instrumentierten Methode, falls keine Exception auftritt
Throwing	Nein	Ja	Nein	Nein	Letzter Aufruf in einer instrumentierten Methode, falls eine Exception auftritt
Catching	Nein	Ja	Nein	Nein	Erstes Statement in einem instrumentierten Catch-Block
debugT infoT warningT errorT fatalT assertion	Ja	Ja	Nein	Nein	Wird im J2EE Logging verwendet, falls das Category-Objekt spezifiziert ist (nicht gleich Null)
beLogged	Nein	Ja	Nein	Nein	Überprüft die Tracing-Relevanz

Methoden für Audit-Monitoring

Methodenname	SAP J2ee Logging	SAP J2EE Tracing	Audits	Performance-Messung	Anmerkung
Audit	Nein	Nein	Ja	Nein	Constructor
addAuditLogEntry	Nein	Nein	Ja	Nein	Verwenden Sie den AuditMessageKey
flushAuditLogEntries	Nein	Nein	Ja	Nein	Schreibt Audits in die Datenbank. Vor Aufruf dieser Methode werden alle Audit-Protokolleinträge im Speicher gesammelt.

Aktivitäten

Alle Trace-Objekte lesen ihre Konfiguration aus dem J2EE Log Configurator-Service. Die Einstellungen werden einmal in der Minute aktualisiert. Das Trace-Objekt reagiert also auf Änderungen spätestens nach einer Minute.

·        Wenn der Trace-Objekt-Constructor aufgerufen wird, dann muss vom Aufrufenden im Versionsparameter die Location angegeben werden, für die das Trace-Objekt Traces und Logs schreibt.

Der Versions-String muss das folgende Format haben:

$Id:[zusätzlicher String, z.B. Verzeichnispfad]com/[package nach com].java#[Versionsnummer] $

$Id: //tc/dev/com/sap/aii/af/sample/ra/CCIConnectionFactory.java#1 $

Die hervorgehobenen Teile definieren die Location des SAP Logging API, für den z.B. der Protokollierungs-Level gesetzt werden kann.

·        Beachten Sie bei der Kode-Instrumentierung folgende Regeln:

¡        SAP J2EE-Logging

§         Ermitteln Sie alle Informationen, an denen ein Systemverwalter interessiert sein könnte.

§         Setzen Sie fatalT(), warningT(), errorT(), wo immer Fehler das Systemverhalten beeinträchtigen können.

§         Um die erfolgreiche Verarbeitung im Adapter zu dokumentieren, setzen Sie infoT() (z.B. Adapter gestartet, Message erfolgreich verarbeitet, etc.).

§         Verwenden Sie debugT() nur sehr restriktiv.

¡        SAP J2EE-Tracing

Verwenden Sie entering(), exiting(), throwing() und catching() im gesamten Adapterkode, besonders im Bereich der Message-Verarbeitung. Der Trace wird im Support dazu verwendet, die Location und die Fehlerursache zu ermitteln.

¡        Audit-Logs

Sie müssen für jede Message mindestens ein Audit-Log AuditLogStatus.SUCESS oder AuditLogStatus.ERROR im Adapter oder den eigenen Adapter-Services des Adapter-Framework schreiben.