Show TOC

Einsatz von Trace-ObjektenLocate this document in the navigation structure

Verwendung

Um Zugriff auf Log- und Trace-Mechanismen zu erhalten, verwenden Sie die Trace-Objekte com.sap.tc.logging.Category und com.sap.tc.logging.Location .

Voraussetzungen

Alle Trace-Objekte lesen ihre Konfigurationsinformationen aus dem Log Configurator.

Weitere Informationen: Log Configurator Service

Der Zugriff auf das Logging API wurde im Beispieladapter in der Klasse XITrace komplett verschalt.

  • Öffnen Sie XITrace.java .

    Migrieren Sie eine ältere Adapterversion, können Sie diese Klasse auch in Ihr Projekt übernehmen.

    XITRace implementiert XI AF Tracing API . Instanziieren Sie das TRACE Objekt wie folgt:

    • XITrace TRACE = new XITrace(SPIManagedConnectionFactory.class.getName());

    Anstelle von:

    • TRACE = new Trace(<your version string>);
Aktivitäten

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

  • Wird der Trace-Objekt-Constructor aufgerufen, muss vom Aufrufenden im Versionsparameter die Location angegeben werden, für die das Trace-Objekt Traces und Logs schreibt. Sie heißt this.getClass().getName() .
  • Beachten Sie bei der Kode-Instrumentierung folgende Regeln:
    • 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.
    • 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.