Registro detallado para conectores que utilizan agentes privados de Jitterbit

Introducción

El registro detallado del conector puede ayudar a identificar y solucionar problemas problemas con ciertos Integration Studio conectores cuando se utilizan con agentes privados.

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

Habilitar el registro detallado

El registro detallado no está habilitado de forma predeterminada. Para habilitarlo, debe iniciar sesión en todos los hosts de agente privado del grupo, editar un archivo y reiniciar todos los agentes. El archivo que se debe 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 versión 10.70 o 11.8 y posteriores, siga estos pasos:

1. Realice 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 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, agregue uno de los siguientes, según el conector, dentro del <configuration> elemento, configuración CONNECTOR_NAME al nombre de registro detallado del conector, y LEVEL al nivel de registro de Java 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 (que se encuentra en la documentación del conector de Workday Prism Analytics):

   Example for 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) Agregue líneas adicionales para otros conectores.

5. Guarde el archivo y reinicie Linux o Windows agente privado.

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

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

1. Realice 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. Edite el 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, agregue uno de los siguientes, según el conector, dentro del <configuration> elemento, configuración CONNECTOR_NAME al nombre de registro detallado del conector, y LEVEL al nivel de registro de Java 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 (que se encuentra en la documentación del conector de Workday Prism Analytics):

   Example for 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) Agregue líneas adicionales para otros conectores.

5. Guarde el archivo y reinicie Linux o Windows agente privado.

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

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

1. Realice 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. Edite el archivo y busque 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, agregue uno de los siguientes, según el conector, justo antes de la línea que comienza con # Debug, configuración CONNECTOR_NAME al nombre de registro detallado del conector, y LEVEL al nivel de registro de Java cadena:

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

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

   Ejemplo

   Usando el conector Workday Prism Analytics como ejemplo, su nombre de registro detallado es workdayprismanalytics (que se encuentra 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) Agregue líneas adicionales para otros conectores.

5. Guarde el archivo y reinicie Linux o Windows agente privado.

Deshabilitar el registro detallado

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

Ver registros detallados

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

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 se puede utilizar durante la depuración. A continuación se muestra un extracto:

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 de registro adicional

Conectores que utilizan el org.jitterbit.connector.<connector_name> El formato de nombre de registro detallado incluye cierta información en el archivo de registro cuando se configura en DEBUG nivel de registro:

• Llamadas HTTP: Llamadas HTTP desde el conector.

  • URL: La URL asociada con la llamada, incluidos los parámetros de consultar y ruta, si están presentes.
  • Encabezados de solicitud: Encabezados de solicitud asociados con la llamada. Por motivos 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 la solicitud: El cuerpo de la solicitud asociado con la llamada, si está presente.
  • Cuerpo de la 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 a solucionar problemas del conector.

Los mensajes de registro también incluirán el ID de la organización Harmony y ID del ambiente asociados al 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:-][ID de env: 100000] - Closing connection
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:-][ID de env: 100000] - Connection is closing...