Abilitazione e visualizzazione dei rapporti sulle transazioni per AEM Forms su JEE transaction-reports-overview
Abilita reporting delle transazioni enable-transaction-reporting
Per impostazione predefinita, la registrazione delle transazioni è disabilitata. Per abilitare il reporting delle transazioni, effettuare le seguenti operazioni:
-
Passa a
/adminuinel tuo AEM Forms su JEE, ad esempiohttp://10.14.18.10:8080/adminui. -
Accedi come Amministratore.
-
Vai a Impostazioni > Impostazioni sistema core > Configurazioni.
-
Fai clic sulla casella di controllo per abilitare la generazione di rapporti sulle transazioni e salvare le impostazioni.
-
Riavviare il server.
-
A parte le modifiche sul server, sul lato client è necessario aggiornare il file
adobe-livecycle-client.jarnel progetto, se si utilizza lo stesso.
Visualizzazione del report delle transazioni view-transaction-report
Quando si abilita il reporting delle transazioni, le informazioni sui conteggi delle transazioni diventano accessibili tramite il report transazioni tramite dashboard e un report dettagliato transazioni tramite il file di registro. Entrambi sono descritti di seguito:
Rapporto di transazione tramite dashboard transaction-report-dashboard
Il rapporto di transazione tramite dashboard fornisce il numero totale di transazioni conteggiate per ogni tipo di transazione. Ad esempio, si ottengono le informazioni sul numero totale di moduli sottoposti a rendering, convertiti e inviati come mostrato nell’immagine. Per ottenere il report delle transazioni:
- Passa a
/adminuinel tuo AEM Forms su JEE, ad esempio:http://10.13.15.08:8080/adminui. - Accedi come Amministratore.
- Fare clic su Health Monitor.
- Passa alla scheda Transaction Reporter e fai clic su Calcola transazioni totali. Ora puoi vedere che un grafico a torta rappresenta il numero di PDF forms inviati, sottoposti a rendering o convertiti.
Rapporto di transazione tramite file di registro transaction-report-logfile
Il report delle transazioni tramite file di log fornisce informazioni dettagliate su ciascuna transazione. Per accedere ai log delle transazioni, seguire il percorso contestuale relativo all'avvio del server. Per impostazione predefinita, le transazioni vengono acquisite in un file di log separato transaction_log.log. Il percorso del file è relativo al contesto di avvio del server. Il percorso predefinito per i diversi server è indicato di seguito:
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"
Esempio di un record di transazione di esempio:[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}
Record transazione transaction-record-structure-jee
La struttura del registro delle transazioni definisce il modo in cui ogni transazione viene registrata tramite i vari parametri, ad esempio servizio, operazione, tipo di transazione e altri. Ciascuno è fornito in dettaglio di seguito. La struttura del record di transazione è la seguente:
TransactionRecord
{
service='...',
operation='...',
internalService='...',
internalOperation='...',
transactionOperationType='...',
transactionCount=...,
elapsedTime=...,
transactionDate=...
}
- servizio: nome del servizio.
- operazione: nome operazione.
- internalService: nome del destinatario della chiamata se è presente una chiamata interna, altrimenti uguale al nome del servizio.
- internalOperation: il nome del destinatario della chiamata è una chiamata interna, altrimenti corrisponde al nome dell'operazione.
- transactionOperationType: tipo di transazione (Submit, Render, Convert).
- transactionCount: conteggio totale della transazione.
- elapsedTime: tempo tra l'avvio della chiamata e la risposta ricevuta.
- transactionDate: timestamp che indica quando è stato richiamato il servizio.
Registro transazioni di esempio:
[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
}
Frequenza di registrazione delle transazioni transaction-recording-frequency
La frequenza di registrazione delle transazioni è determinata dalle operazioni di aggiornamento sul server per ogni modulo inviato, sottoposto a rendering o convertito correttamente.
-
In dashboard il conteggio delle transazioni viene aggiornato periodicamente. Il valore predefinito è 1 minuto. È possibile aggiornare la frequenza impostando la proprietà di sistema su
"com.adobe.idp.dsc.transaction.recordFrequency". Ad esempio, in AEM Forms per JEE su JBoss®, aggiungi-Dcom.adobe.idp.dsc.transaction.recordFrequency=5inJAVA_OPTSper impostare la frequenza di aggiornamento su 5 minuti. -
Nei registri transazioni, l'aggiornamento di ogni transazione viene eseguito immediatamente quando un modulo viene inviato, sottoposto a rendering o convertito correttamente.