Aktivieren und Anzeigen von Transaktionsberichten für AEM Forms on JEE transaction-reports-overview

Last update: Tue Dec 31 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Gilt für:
Experience Manager 6.5

Themen:
Transaktionsberichte

Erstellt für:

Admin
Benutzende
Entwickler

Aktivieren von Transaktionsberichten enable-transaction-reporting

Standardmäßig ist das Aufzeichnen von Transaktionen deaktiviert. Führen Sie die folgenden Schritte aus, um Transaktionsberichte zu aktivieren:

Navigieren Sie in AEM Forms on JEE zu /adminui, z. B. http://10.14.18.10:8080/adminui.
Melden Sie sich als Admin an.
Wechseln Sie zu Einstellungen > Core-Systemeinstellungen > Konfigurationen.
Aktivieren Sie das Kontrollkästchen Transaktionsberichte aktivieren und speichern Sie die Einstellungen.
Starten Sie den Server neu.
Abgesehen von den Änderungen auf dem Server müssen Sie auf Client-Seite die Datei adobe-livecycle-client.jar in Ihrem Projekt aktualisieren, wenn Sie dieselbe Datei verwenden.

Anzeigen eines Transaktionsberichts view-transaction-report

Wenn Sie Transaktionsberichte aktiviert haben, können Sie durch einen Transaktionsbericht anhand des Dashboards auf die Informationen zu den Transaktionszahlen zugreifen. Außerdem erhalten Sie einen detaillierten Transaktionsbericht über die Protokolldatei. Beides wird nachfolgend erläutert:

Transaktionsbericht anhand des Dashboards transaction-report-dashboard

Der Transaktionsbericht anhand des Dashboards liefert die Gesamtzahl der Transaktionen für jeden Transaktionstyp. Beispielsweise erhalten Sie Informationen zur Gesamtanzahl der gerenderten, konvertierten und gesendeten Formulare, wie im Bild dargestellt. So rufen Sie den Transaktionsbericht ab:

Navigieren Sie in AEM Forms on JEE zu /adminui, z. B. http://10.13.15.08:8080/adminui.
Melden Sie sich als Admin an.
Klicken Sie auf „Statusüberwachung“.
Navigieren Sie zur Registerkarte Transaktionsberichte und klicken Sie auf Gesamttransaktionen berechnen. Jetzt sehen Sie ein Tortendiagramm, das die Anzahl der PDF-Formulare darstellt – gesendet, gerendert oder konvertiert.

sample-transaction-report-jee

Transaktionsbericht anhand einer Protokolldatei transaction-report-logfile

Der Transaktionsbericht anhand einer Protokolldatei enthält detaillierte Informationen zu den einzelnen Transaktionen. Um auf Transaktionsprotokolle zuzugreifen, folgen Sie dem Kontextpfad relativ zum Server-Start. Transaktionen werden standardmäßig in einer separaten Protokolldatei transaction_log.log erfasst. Der Dateipfad ist relativ zum Server-Startkontext. Der Standardpfad für verschiedene Server ist unten angegeben:

For Jboss Turnkey:
"<AEM_Forms_Installation>/jboss/bin/transaction_log.log"

For IBM Websphere:
"<IBM_WAS_Profile_path>/transaction_log.log"

For Oracle Weblogic:
"<Weblogic_Domain_path>/transaction_log.log"

For Jboss Cluster:
"<Jboss home>/transaction_log.log"

Beispiel eines Transaktionseintrags:
[2024-02-28 06:11:27] [INFO] TransactionRecord{service='GeneratePDFService', operation='HtmlFileToPDF', internalService='GeneratePDFService', internalOperation='HtmlFileToPDF', transactionOperationType='CONVERT', transactionCount=1, elapsedTime=1906, transactionDate=Wed Feb 28 06:11:25 UTC 2024}

Transaktionseintrag transaction-record-structure-jee

Die Transaktionsprotokollstruktur definiert, wie jede Transaktion durch ihre verschiedenen Parameter aufgezeichnet wird: Dienst, Vorgang, Transaktionstyp usw. Es folgen Details zu den Parametern. Der Transaktionseintrag weist die folgende Struktur auf:

TransactionRecord
{
    service='...',
    operation='...',
    internalService='...',
    internalOperation='...',
    transactionOperationType='...',
    transactionCount=...,
    elapsedTime=...,
    transactionDate=...
}

service: Name des Dienstes.
operation: Vorgangsname.
internalService: Name des Aufrufs, falls ein interner Aufruf erfolgt, andernfalls identisch mit dem Dienstnamen.
internalOperation: Name des Aufrufs, falls ein interner Aufruf erfolgt, andernfalls identisch mit dem Vorgangsnamen.
transactionOperationType: Typ der Transaktion (Submit, Render, Convert).
transactionCount: Gesamtanzahl der Transaktionen.
elapsedTime: Zeit zwischen der Initiierung des Aufrufs und dem Erhalten der Antwort.
transactionDate: Zeitstempel, der angibt, wann der Dienst aufgerufen wurde.

Beispiel eines Transaktionsprotokolls:

[2024-02-14 14:23:25] [INFO] TransactionRecord
{
    service='BarcodedFormsService',
    operation='decode',
    internalService='BarcodedFormsService',
    internalOperation='decode',
    transactionOperationType='CONVERT',
    transactionCount=1,
    elapsedTime=47405,
    transactionDate=Wed Feb 14 14:22:37 UTC 2024
}

Häufigkeit der Aufzeichnung von Transaktionen transaction-recording-frequency

Die Häufigkeit der Aufzeichnung von Transaktionen wird durch die Aktualisierungsvorgänge auf dem Server für jedes Formular bestimmt, das erfolgreich gesendet, gerendert oder konvertiert wurde.

Im Dashboard wird die Transaktionsanzahl regelmäßig aktualisiert, standardmäßig jede Minute. Sie können diese Häufigkeit ändern, indem Sie die Systemeigenschaft "com.adobe.idp.dsc.transaction.recordFrequency" festlegen. Fügen Sie beispielsweise in AEM Forms for JEE in JBoss® -Dcom.adobe.idp.dsc.transaction.recordFrequency=5 in JAVA_OPTS hinzu, um die Aktualisierungsfrequenz auf 5 Minuten festzulegen.
In den Transaktionsprotokollen erfolgt die Aktualisierung für jede Transaktion sofort, wenn ein Formular gesendet, gerendert oder konvertiert wurde.

recommendation-more-help

19ffd973-7af2-44d0-84b5-d547b0dffee2