Activación y visualización de informes de transacciones para AEM Forms en JEE transaction-reports-overview
Habilitar informes de transacciones enable-transaction-reporting
De forma predeterminada, el registro de transacciones está desactivado. Para habilitar los informes de transacciones, realice los siguientes pasos:
-
Vaya a
/adminui
en su AEM Forms en JEE, por ejemplo,http://10.14.18.10:8080/adminui
. -
Inicie sesión como administrador.
-
Vaya a Configuración > Configuración del sistema principal > Configuraciones.
-
Haga clic en la casilla de verificación para habilitar los informes de transacciones y guardar la configuración.
-
Reinicie el servidor.
-
Aparte de los cambios en el servidor, en el lado del cliente debe actualizar el archivo
adobe-livecycle-client.jar
en su proyecto, si está utilizando el mismo.
Ver informe de transacciones view-transaction-report
Cuando habilita los informes de transacciones, se puede obtener acceso a la información sobre los recuentos de transacciones a través del informe de transacciones a través del panel y de un informe de transacciones detallado a través del archivo de registro. Ambos se explican a continuación:
Informe de transacciones mediante tablero transaction-report-dashboard
El informe de transacciones a través del panel proporciona el número total de transacciones contabilizadas para cada tipo de transacción. Por ejemplo, se obtiene la información sobre el número total de formularios procesados, convertidos y enviados como se muestra en la imagen. Para obtener el informe de transacciones:
- Vaya a
/adminui
en su AEM Forms en JEE, por ejemplo:http://10.13.15.08:8080/adminui
. - Inicie sesión como administrador.
- Haga clic en Monitor de estado.
- Vaya a la ficha Informador de transacciones, haga clic en Calcular transacciones totales y verá que un gráfico circular representa el número de PDF forms: enviados, procesados o convertidos.
Informe de transacciones mediante archivo de registro transaction-report-logfile
El informe de transacciones mediante el archivo de registro proporciona información detallada sobre cada transacción. Para acceder a los registros de transacciones, siga la ruta de contexto relativa al inicio del servidor. De forma predeterminada, las transacciones se capturan en un archivo de registro independiente transaction_log.log
. La ruta de archivo es relativa al contexto de inicio del servidor. A continuación se indica la ruta predeterminada para diferentes servidores:
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"
Ejemplo de registro de transacción de ejemplo:[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}
Registro de transacciones transaction-record-structure-jee
La estructura del registro de transacciones define cómo se registra cada transacción a través de sus distintos parámetros, como servicio, operación, tipo de transacción y otros. Cada uno se detalla a continuación. La estructura del registro de transacciones es la siguiente:
TransactionRecord
{
service='...',
operation='...',
internalService='...',
internalOperation='...',
transactionOperationType='...',
transactionCount=...,
elapsedTime=...,
transactionDate=...
}
- servicio: nombre del servicio.
- operación: nombre de operación.
- internalService: Nombre del destinatario de la llamada si hay una llamada interna; de lo contrario, es igual que el nombre del servicio.
- internalOperation: El nombre del destinatario de la llamada allí es una llamada interna; de lo contrario, será el mismo que el nombre de la operación.
- transactionOperationType: tipo de transacción (enviar, procesar, convertir).
- transactionCount: Recuento total de transacciones.
- elapsedTime: tiempo entre el inicio de la llamada y la respuesta recibida.
- transactionDate: marca de tiempo que indica cuándo se invocó el servicio.
Registro de transacciones de ejemplo:
[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
}
Frecuencia de registro de transacciones transaction-recording-frequency
La frecuencia de registro de transacciones está determinada por las operaciones de actualización en el servidor para cada formulario que se envía, procesa o convierte correctamente.
-
En panel, el recuento de transacciones se actualiza periódicamente; el valor predeterminado es 1 minuto. Puede actualizar la frecuencia estableciendo la propiedad del sistema en
"com.adobe.idp.dsc.transaction.recordFrequency"
. Por ejemplo, en AEM Forms para JEE en JBoss®, agregue-Dcom.adobe.idp.dsc.transaction.recordFrequency=5
enJAVA_OPTS
para establecer la frecuencia de actualización en 5 minutos. -
En registros de transacciones, la actualización de cada transacción se produce instantáneamente cuando un formulario se envía, procesa o convierte correctamente.