Verwendung des technischen Trace und Log
Verwendung
Das Adapter-Framework Trace- und Log-Interface stellt verschiedene Mechanismen und allgemeine Methoden in seinen Klassen zur Verfügung, die das Tracing und Logging von Adaptern erlauben.
Interface-Überblick
Merkmal |
Wert |
Name |
Adapter-Framework technischer Trace und Log |
Zweck |
Das Schreiben von Einträgen in das SAP J2EE Engine Logging Tool, in das Audit-Log und das Erzeugen von Zeitstempeln für die Performance-Messung |
Typ |
Java-Bibliothek |
Technischer Name |
com.sap.aii.af.service.trace com.sap.aii.af.service.auditlog |
Zertifizierung |
Optional |
Syntax |
Siehe JavaDoc (.\index.html) package com.sap.aii.af.service.trace and auditlog |
Integration
Die Verwendung des Adapter-Framework Trace and Log-Interface ist optional. Falls Sie dieses Interface verwenden, dann müssen Sie die Anforderungen folgender Bereiche berücksichtigen:
· Einsatz von Logging-Kategorien
· Erzeugung von Audit-Protokolleinträgen
Funktionsumfang
Die unterschiedlichen Werkzeuge sind in folgenden Bereichen enthalten:
· SAP J2EE Engine Logging Tool
Dieser Mechanismus stellt Funktionen für das Tracing und Logging zur Verfügung. Das Tracing liefert Angaben über das Auftreten und den Ort eines Fehlers, das Logging liefert Informationen über das korrekte Funktionieren einer Komponente auf detaillierter technischer Ebene.
In diesem Zusammenhang wird der Begriff Category verwendet, wenn Logging-Statements für eine bestimmte Kategorie von Funktionen geschrieben werden.
adapter.EISconnction
adapter.J2EEconnection
Der Begriff Location wird verwendet, wenn Trace-Statements erzeugt werden, die die Rekonstruktion von Verarbeitungs-Code erlauben.
Diese beiden Begriffe spiegeln sich im Methoden-Design des technischen Trace-und Log-Interface wieder.
· Adapter-Framework-Audits
Die Technischen Trace.- und Log-Klassen stellen Funktionen zur Verfügung, die das Schreiben von Audit-Einträgen zu einer bestimmten XI-Message erlauben. Die Einträge dokumentieren den Message-Fluss im Adapter-Framework. Sie werden in der Datenbank, die vom J2EE-Server verwendet wird, gespeichert.
· SAP J2EE Performance-Trace über JARM
Darüber hinaus werden Zeitstempel beim Ausführen der Eingangs- und Ausgangsmethode gefüllt, die eine einfache Performance-Messung des Adapter-Framework erlauben.
Verbindung zu JCA Error Logging und Tracing-Methoden
Die Verweise beziehen sich auf Kapitel 6.6 des Dokuments J2EE Connector Architecture Specification, Final Version 1.0.
Das Dokument kann im Internet unter java.sun.com/j2ee/connector bezogen werden.
· Wenn Ihr Adapter das Adapter-Framework Trace- und Log-Interface unterstützt, dann kann er den erhaltenen PrintWriter Character Output Stream ignorieren.
· Wenn der Adapter die JCA-Protokollierung unterstützt, dann schreiben Sie in dieses Protokoll nur JCA-bezogene und keine Adapter-Framework-bezogene Information.
· Wenn Ihr Adapter nur die JCA-Protokollierungsmethode unterstützt, dann sollte er alle seine Protokollanweisungen in das vom J2EE JCA Container übergebene Java PrintWriter-Objekt schreiben. Dieser Mechanismus reicht jedoch für die SAP-Zertifizierung nicht aus.
· Sie können sich auch entscheiden, weder die JCA-Protokollierungsmethode noch das Adapter-Framework Trace- und Log-Interface zu verwenden.
Die Verwendung des Adapter-Framework Trace- und Log-Interface ist optional, falls Sie es verwenden, dann müssen alle in den folgenden Abschnitten beschriebenen Voraussetzungen erfüllt werden.