Aktivera och visa transaktionsrapporter för AEM Forms i JEE transaction-reports-overview

Aktivera transaktionsrapportering enable-transaction-reporting

Som standard är transaktionsregistrering inaktiverad. Så här aktiverar du transaktionsrapportering:

  1. Navigera till /adminui på din AEM Forms på JEE, till exempel http://10.14.18.10:8080/adminui.

  2. Logga in som administratör.

  3. Gå till Inställningar > Systeminställningar > Konfigurationer.

  4. Klicka i kryssrutan för att aktivera transaktionsrapportering och spara inställningarna.

    sample-transaction-report-jee

  5. Starta om servern.

  6. Förutom ändringarna på servern måste du på klientsidan uppdatera filen adobe-livecycle-client.jar i ditt projekt, om du använder samma.

Visa transaktionsrapport view-transaction-report

När du aktiverar transaktionsrapportering blir informationen om antalet transaktioner tillgänglig via transaktionsrapporten via kontrollpanelen och en detaljerad transaktionsrapport via loggfilen. Båda förklaras nedan:

Transaktionsrapport via kontrollpanelen transaction-report-dashboard

Transaktionsrapport via kontrollpanelen ger totalt antal transaktioner för varje typ av transaktion. Du kan t.ex. få information om det totala antalet formulär som återges, konverteras och skickas enligt bilden. Så här hämtar du transaktionsrapporten:

  1. Navigera till /adminui på din AEM Forms på JEE, till exempel: http://10.13.15.08:8080/adminui.
  2. Logga in som administratör.
  3. Klicka på Hälsoövervakning.
  4. Navigera till fliken Transaktionsrapportör, klicka på Beräkna totala transaktioner, nu ser du att ett cirkeldiagram representerar antalet PDF forms som har skickats, återgetts eller konverterats.

sample-transaction-report-jee

Transaktionsrapport via loggfil transaction-report-logfile

Transaktionsrapport via loggfil innehåller detaljerad information om varje transaktion. Om du vill få åtkomst till transaktionsloggar följer du kontextsökvägen i förhållande till serverns start. Transaktioner hämtas som standard i en separat loggfil transaction_log.log. filsökvägen är relativ till serverns startkontext. Standardsökvägen för olika servrar anges nedan:

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"

Exempel på en exempeltransaktion:
[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}

Transaktionspost transaction-record-structure-jee

Transaktionsloggens struktur definierar hur varje transaktion registreras med hjälp av dess olika parametrar, till exempel service, operation, transaktionstyp och andra. Dessa ges i detalj nedan. Transaktionspostens struktur är följande:

TransactionRecord
{
    service='...',
    operation='...',
    internalService='...',
    internalOperation='...',
    transactionOperationType='...',
    transactionCount=...,
    elapsedTime=...,
    transactionDate=...
}
  • service: Tjänstens namn.
  • operation: Åtgärdsnamn.
  • internalService: Anroparens namn om det finns ett internt anrop, annars samma som tjänstens namn.
  • internalOperation: Namnet på anroparen i det finns ett internt anrop, i annat fall samma som åtgärdsnamnet.
  • transactionOperationType: Typ av transaktion (Submit, Render, Convert).
  • transactionCount: Totalt antal transaktioner.
  • förfluten tid: Tid mellan anropsinitieringen och mottaget svar.
  • transactionDate: Tidsstämpeln anger när tjänsten anropades.

Exempel på transaktionslogg:

[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
}

Inspelningsfrekvens för transaktioner transaction-recording-frequency

Frekvensen för registrering av transaktioner bestäms av uppdateringsåtgärderna på servern för varje formulär som har skickats, återgetts eller konverterats.

  • I dashboard uppdateras antalet transaktioner regelbundet, standardvärdet är 1 minut. Du kan uppdatera frekvensen genom att ställa in systemegenskapen på "com.adobe.idp.dsc.transaction.recordFrequency". I AEM Forms för JEE på JBoss® lägger du till -Dcom.adobe.idp.dsc.transaction.recordFrequency=5 i JAVA_OPTS för att ange uppdateringsfrekvensen till 5 minuter.

  • I transaktionsloggar uppdateras varje transaktion omedelbart när ett formulär har skickats, återgetts eller konverterats.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2