Show TOC

Erzeugung von Audit-ProtokolleinträgenLocate this document in the navigation structure

Verwendung

Mit dem Audit-Log schreiben Sie und speichern Sie Protokolleinträge zu einer Message. Sie geben an, wie eine konkreten Message-Instanz im Adapter-Framework und im Integration Server bearbeitet wurde.

Interface-Überblick

Merkmal Wert

Name

Adapter-Framework Audit Log

Zweck

Schreiben von Einträgen in das AF Message-Log mit Kontrolle der Persistenzzeitpunkte.

Typ

AS Java Interface in Fassade com.sap.aii.af.ifc.facade

Technischer Name

com.sap.engine.interfaces.messaging.api.auditlog

Zertifizierung

Optional

Syntax

Javadoc (.\index.html) package com.sap.engine.interfaces.messaging.api.auditlog

Voraussetzungen
  • Bevor Audit-Protokolleinträge geschrieben werden können, müssen Sie Zugriff auf ein Objekt erhalten, das AuditAccess implementiert.

    Verwenden Sie dazu das Objekt PublicAPIAccess t. Mit getAuditAccess() erhalten Sie ein AuditAccess- Objekt.

    Weitere Informationen: XI-Message-Interfaces

    Hinweis

    Öffnen Sie hierzu SPIManagedConnectionFactory.java und suchen Sie nach der Zeichenkette CS_AUDITACCESS.

  • Um den Audit-Log-Eintrag mit einer Message zu verknüpfen, müssen Sie beim Schreiben des Audit-Log-Eintrags ein MessageKey -Objekt instanziieren.
Funktionsumfang

Methoden für Audit-Monitoring

Klasse/Interface Methodenname Methode

AuditAccess

addAuditLogEntry

Verwenden Sie den AuditMessageKey

AuditAccess

flushAuditLogEntries

Schreibt Audit-Protokolleinträge in die Datenbank. Vor Aufruf der Methode werden alle Audit-Protokolleinträge im Speicher gesammelt.

AuditLogStatus

Gültige Statuseinträge

MessageKey

XI-Message-Interfaces

Schreiben Sie den Log-Eintrag wie in dem folgenden Beispiel:

Hinweis

Öffnen Sie hierzu SPIManagedConnectionFactory.java und suchen Sie nach der Zeichenkette CS_TRAUD.

Achtung

Um unnötige Audit-Protokolleinträge zu vermeiden, verwenden Sie flushAuditLogEntries() für synchrone Messages nicht.

Prüfung der Messages im Message-Monitor

  • Um die Payload einer synchronen Message im Message-Monitor anzeigen zu können, können Sie für den Test Ihres Adapters eine Service-Property umsetzen.
  • Setzen Sie im Service XPI AF Messaging System folgende Property:

    Messaging.syncMessageRemover.removeBody = false

    Weitere Informationen: Properties for Service XPI AF Messaging System

    Achtung

    Ändern Sie den Parameter nur in einem Testsystem.

    In einem Produktivsystem kann diese Einstellung zu OutOfMemory-Exceptions im AS Java führen, wenn viele große synchrone Messages den Hauptspeicher verbrauchen.