Registro detallado para conectores utilizando agentes privados de Jitterbit

Introducción

El registro detallado de conectores puede ayudar a solucionar problemas con ciertos conectores de Integration Studio cuando se utilizan con agentes privados.

Para los conectores que admiten el registro detallado, el nombre específico del conector para usar se describe en la documentación de cada conector.

Habilitar el registro detallado

El registro detallado no está habilitado por defecto. Para habilitarlo, debe iniciar sesión en todos los hosts de agentes privados en el grupo, editar un archivo y reiniciar todos los agentes. El archivo a editar depende de la versión del agente privado:

• Versión del Agente 10.70 / 11.8 y posteriores: Editar logback.xml

• Versión del Agente 10.35 a 10.69 / 11.7: Editar logback.xml

• Versión del Agente 10.34 y anteriores: Editar log4j.properties

Versión del agente 10.70 / 11.8 y posteriores: Editar logback.xml

Para habilitar el registro detallado en agentes privados de la versión 10.70 o 11.8 y posteriores, siga estos pasos:

1. Haga una copia de seguridad del siguiente archivo:

   LinuxWindows

   /opt/jitterbit/tomcat/shared/lib/logback.xml

   C:\Program Files\Jitterbit Agent\tomcat\shared\lib\logback.xml

2. Edite el archivo logback y busque las siguientes líneas:

   . . .
     <logger name="org.springframework" level="WARN"/>
     <logger name="org.hibernate.engine.jdbc.internal.JdbcResourceRegistryImpl" level="ERROR"/>
   . . .
   

3. Para configurar el nivel de registro, agrega uno de los siguientes, dependiendo del conector, dentro del elemento <configuration>, estableciendo CONNECTOR_NAME al nombre de registro detallado del conector, y LEVEL al nivel de registro de Java en forma de cadena:

   <logger name="org.jitterbit.connector.CONNECTOR_NAME" level="LEVEL"/>
   

   <logger name="org.jitterbit.connector.verbose.logging.CONNECTOR_NAME" level="LEVEL"/>
   

   Ejemplo

   Para el conector de Workday Prism Analytics, su nombre de registro detallado es workdayprismanalytics (encontrado en la documentación del conector de Workday Prism Analytics):

   Ejemplo para Workday Prism Analytics

   . . .
     <logger name="org.springframework" level="WARN"/>
     <logger name="org.hibernate.engine.jdbc.internal.JdbcResourceRegistryImpl" level="ERROR"/>
     <logger name="org.jitterbit.connector.verbose.logging.workdayprismanalytics" level="DEBUG"/>
   . . .
   

4. (Opcional) Agrega líneas adicionales para otros conectores.

5. Guarda el archivo y reinicia el agente privado de Linux o Windows.

Versión del agente 10.35 a 10.69 / 11.7: Editar logback.xml

Para habilitar el registro detallado en agentes privados de la versión 10.35 a 10.69, o de la versión 11.7, sigue estos pasos:

1. Haz una copia de seguridad del siguiente archivo:

   LinuxWindows

   /opt/jitterbit/tomcat/webapps/axis/WEB-INF/lib/logback.xml

   C:\Program Files\Jitterbit Agent\tomcat\webapps\axis\WEB-INF\lib\logback.xml

2. Edita el archivo logback, y encuentra las siguientes líneas:

   . . .
     <logger name="org.springframework" level="WARN"/>
     <logger name="org.hibernate.engine.jdbc.internal.JdbcResourceRegistryImpl" level="ERROR"/>
   . . .
   

3. Para configurar el nivel de registro, agrega uno de los siguientes, dependiendo del conector, dentro del elemento <configuration>, estableciendo CONNECTOR_NAME al nombre de registro detallado del conector, y LEVEL al nivel de registro de Java en forma de cadena:

<logger name="org.jitterbit.connector.CONNECTOR_NAME" level="LEVEL"/>

<logger name="org.jitterbit.connector.verbose.logging.CONNECTOR_NAME" level="LEVEL"/>

. . .
      <logger name="org.springframework" level="WARN"/>
      <logger name="org.hibernate.engine.jdbc.internal.JdbcResourceRegistryImpl" level="ERROR"/>
      <logger name="org.jitterbit.connector.verbose.logging.workdayprismanalytics" level="DEBUG"/>
    . . .

1. (Opcional) Agregar líneas adicionales para otros conectores.

2. Guardar el archivo y reiniciar el agente privado de Linux o Windows.

Versión del agente 10.34 y anteriores: editar log4j.properties

Para habilitar el registro detallado en agentes privados de versión 10.34 y anteriores, seguir estos pasos:

1. Hacer una copia de seguridad del siguiente archivo:

   LinuxWindows

   /opt/jitterbit/tomcat/webapps/axis/WEB-INF/lib/log4j.properties

   C:\Program Files\Jitterbit Agent\tomcat\webapps\axis\WEB-INF\lib\log4j.properties

2. Editar el archivo y encontrar las siguientes líneas:

   . . .
   log4j.logger.org.springframework=WARN
   log4j.logger.org.hibernate.engine.jdbc.internal.JdbcResourceRegistryImpl=ERROR
   
   # Debug options can be turned on by uncommenting these lines
   # . . .
   

3. Para configurar el nivel de registro, agregar uno de los siguientes, dependiendo del conector, justo antes de la línea que comienza con # Debug, configurando CONNECTOR_NAME al nombre de registro detallado del conector y LEVEL al nivel de registro de Java en forma de cadena:

   log4j.logger.org.jitterbit.connector.CONNECTOR_NAME=LEVEL
   

   log4j.logger.org.jitterbit.connector.verbose.logging.CONNECTOR_NAME=LEVEL
   

   Ejemplo

   Usando el conector de Workday Prism Analytics como ejemplo, su nombre de registro detallado es workdayprismanalytics (encontrado en la documentación del conector de Workday Prism Analytics). Este debería ser el fragmento del archivo de propiedades:

        . . .
        log4j.logger.org.springframework=WARN
        log4j.logger.org.hibernate.engine.jdbc.internal.JdbcResourceRegistryImpl=ERROR
        log4j.logger.org.jitterbit.connector.verbose.logging.workdayprismanalytics=DEBUG

        # Debug options can be turned on by uncommenting these lines
        # . . .
        ```

4.  (Opcional) Agregar líneas adicionales para otros conectores.

5.  Guardar el archivo y reiniciar el agente privado de [Linux](/es/agent/linux/#manage) o [Windows](/es/agent/windows/#manage).

## Desactivar el registro detallado {: #disable-verbose-logging }

Para desactivar el registro detallado, edite el archivo `logback.xml` o `log4j.properties` correspondiente a la versión del agente privado, establezca todos los niveles en `OFF`, y luego reinicie el agente.

## Ver registros detallados {: #view-verbose-logs }

Cuando el registro detallado está habilitado, las entradas se escriben en el archivo `jitterbit-axis.log`. Abra el archivo de registro en un editor para ver las entradas. El archivo de registro se guarda en estas ubicaciones, dependiendo del sistema operativo y la versión del agente:

=== "Linux"
    `/opt/jitterbit/log/jitterbit-axis.log`

=== "Windows"
    `C:\Program Files\Jitterbit Agent\log\jitterbit-axis.log`

Para encontrar entradas, busque los términos `INFO`, `DEBUG` o `VerboseLogger` en el archivo. Las entradas pueden incluir mensajes, esquemas y otra información que puede ser utilizada al depurar. Aquí se muestra un extracto:

```txt
2020-12-07 15:06:31,445 +0530 http-nio-127.0.0.1-46912-exec-9 DEBUG org.jitterbit.connector.verbose.logging.epicorerp.VerboseLogger:22 - org.jitterbit.connector.epicor.EpicorClient.PATCH, msg: {"method: ":"PATCH","headers: ":"Authorization: Basic bWFuYWdlcjomd1I3aWk1IQ==\nkeep-alive: true\n","URI: ":"https://sample.developer.epicor.com/%2Fserver%2Fapi%2Fv1/BaqSvc/PartsAdvancedBPM","requestPayload: ":"{\"Part_Company\":\"EPIC01\",\"SysRowID\":\"470bf6e7-cba1-4a7b-6ee7-a33b015c3cbc\",\"Part_PartNum\":\"001_MPCons\",\"Part_UserDecimal1\":\"0\"}"}
2020-12-07 15:06:31,742 +0530 http-nio-127.0.0.1-46912-exec-9 DEBUG org.jitterbit.connector.verbose.logging.epicorerp.VerboseLogger:22 - org.jitterbit.epicor.adapter.common.CommonResponseGenerator.statusCode, msg: 200
2020-12-07 15:06:31,742 +0530 http-nio-127.0.0.1-46912-exec-9 DEBUG org.jitterbit.connector.verbose.logging.epicorerp.VerboseLogger:22 - org.jitterbit.epicor.adapter.common.CommonResponseGenerator.responsePayload, msg: {
  "odata.metadata":"https://sample.developer.epicor.com/server/api/v1/BaqSvc/PartsAdvancedBPM/$metadata#Epicor.DynamicQuery.QueryResults","value":[
    {
      "Part_Company":"EPIC06","Part_PartNum":"001_MPCons","Part_UserChar1":"","Part_UserDecimal1":"0","RowMod":"","RowIdent":"38ca34b4-2440-4d3d-ac3b-177b610f01ac","SysRowID":"470bf6e7-cba1-4a7b-6ee7-a33b015c3cbc"
    }
  ]
}

Información adicional del registro

Los conectores que utilizan el formato de nombre de registro detallado org.jitterbit.connector.<connector_name> incluyen cierta información en el archivo de registro cuando se establece en el nivel de registro DEBUG:

• Llamadas HTTP: Llamadas HTTP desde el conector.

  • URL: La URL asociada con la llamada, incluyendo cualquier parámetro de consulta y de ruta si están presentes.
  • Encabezados de Solicitud: Encabezados de solicitud asociados con la llamada. Por razones de seguridad, los encabezados que contienen cierta información, como la que se pasa en un encabezado de autorización, tendrán sus valores enmascarados con asteriscos.
  • Encabezados de Respuesta: Encabezados de respuesta asociados con la llamada.
  • Método HTTP: El método HTTP asociado con la llamada, uno de HEAD, GET, POST, PUT, PATCH, DELETE, OPTIONS, CONNECT o TRACE.
  • Tiempo de Respuesta: El tiempo de respuesta de la llamada en milisegundos.
  • Cuerpo de Solicitud: El cuerpo de la solicitud asociado con la llamada si está presente.
  • Cuerpo de Respuesta: El cuerpo de la respuesta asociado con la llamada si está presente.
  • Código de Estado HTTP: El código de estado HTTP asociado con la llamada.

• Mensajes de Solución de Problemas: Mensajes de registro adicionales para ayudar con la solución de problemas de los conectores.

Los mensajes de registro también incluirán el ID de organización de Harmony y el ID de entorno asociados con el proyecto como orgId y envId respectivamente:

2023-05-07 18:13:42 http-nio-127.0.0.1-46912-exec-6 DEBUG org.jitterbit.connector.<connector_name>.Connection:80 [orgId:-][envId:100000] - Cerrando conexión
2023-05-07 18:13:42 http-nio-127.0.0.1-46912-exec-6 DEBUG org.jitterbit.connector.<connector_name>.client.Client:80 [orgId:-][envId:100000] - La conexión se está cerrando...