Registro Detallado para Conectores¶

Introducción¶

El registro detallado del conector se puede utilizar para solucionar problemas con ciertos Cloud Studio conectores cuando se utilizan con Agentes Privados. Es posible que Soporte de Jitterbit para habilitar el registro detallado del conector siguiendo los pasos de esta página.

El registro detallado del conector es compatible con ciertos conectores de Cloud Studio, cada uno con su propio nombre del conector de registro detallado que debe ingresarse como se describe en Habilitación del registro detallado más adelante en esta página.

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

Habilitar Registro Detallado¶

Habilitar el registro detallado del conector requiere acceso a cada Agente Privado en un Grupo de Agentes, ya que el registro detallado no está habilitado de forma predeterminada. Cada agente debe tener un archivo de propiedades editado para permitir el registro detallado.

Existe un procedimiento diferente para habilitar el registro detallado según la versión del agente. La versión de un agente privado se puede determinar a través de la Management Console.

• Agente Versión 10.70/11.8 y posteriores: Editar logback.xml
• Versión del Agente 10.35 a 10.69/11.7: Editar logback.xml
• Agente versión 10.34 y anteriores: editar log4j.properties

Versión del Agente 10.70/11.8 y Posteriores: Editar logback.xml¶

Para editar el logback.xml archivo:

1. Haga una copia de seguridad de los archivos que vaya a editar.

2. Detenga al agente:

   • Linux: Consulte Reiniciar Agente en Instalación de un Agente Harmony Linux.
   • Windows: Consulte Reiniciar Agente en Instalación de un Agente de Windows Harmony.

3. Encuentra el logback.xml archivo, según lo determinado por el sistema operativo y la ubicación del directorio de inicio de Jitterbit:

4. Linux: /opt/jitterbit/tomcat/shared/lib/logback.xml

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

5. Abra el logback.xml archivo en un editor.

6. Encuentra las líneas:

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

7. Después de esas líneas, agregue una de las siguientes líneas, reemplazando <connector_name> con el nombre de registro detallado del conector y establezca el nivel de registro. Consulte la documentación del conector individual para el formato de nombre apropiado, <connector_name>y nivel de registro.

   Los nombres de registro detallados están en uno de estos formatos, según el conector específico:

     <logger name="org.jitterbit.connector.<connector_name>" level="DEBUG"/>
   

     <logger name="org.jitterbit.connector.verbose.logging.<connector_name>" level="DEBUG"/>
   

   Utilizando 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 entonces el fragmento del archivo de inicio de sesión:

   . . .
     <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"/>
   . . .
   

   Nota

   El registro detallado se puede utilizar con varios conectores. Agregue una línea separada para cada conector.

8. Guarde el archivo y reinicie el agente:

   • Linux: Consulte Reiniciar Agente en Instalación de un Agente Harmony Linux.
   • Windows: Consulte Reiniciar Agente en Instalación de un Agente de Windows Harmony.

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

Para editar el logback.xml archivo:

1. Haga una copia de seguridad de los archivos que vaya a editar.

2. Detenga al agente:

   • Linux: Consulte Reiniciar Agente en Instalación de un Agente Harmony Linux.
   • Windows: Consulte Reiniciar Agente en Instalación de un Agente de Windows Harmony.

3. Encuentra el logback.xml archivo, según lo determinado por el sistema operativo y la ubicación del directorio de inicio de Jitterbit:

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

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

5. Abra el logback.xml archivo en un editor.

6. Encuentra las líneas:

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

7. Después de esas líneas, agregue una de las siguientes líneas, reemplazando <connector_name> con el nombre de registro detallado del conector y establezca el nivel de registro. Consulte la documentación del conector individual para el formato de nombre apropiado, <connector_name>y nivel de registro.

   Los nombres de registro detallados están en uno de estos formatos, según el conector específico:

     <logger name="org.jitterbit.connector.<connector_name>" level="DEBUG"/>
   

     <logger name="org.jitterbit.connector.verbose.logging.<connector_name>" level="DEBUG"/>
   

   Utilizando 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 entonces el fragmento del archivo de inicio de sesión:

   . . .
     <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"/>
   . . .
   

   Nota

   El registro detallado se puede utilizar con varios conectores. Agregue una línea separada para cada conector.

8. Guarde el archivo y reinicie el agente:

   • Linux: Consulte Reiniciar Agente en Instalación de un Agente Harmony Linux.
   • Windows: Consulte Reiniciar Agente en Instalación de un Agente de Windows Harmony.

Versión del Agente 10.34 y Anteriores: Editar log4j.properties¶

Para editar el log4j.properties archivo:

1. Haga una copia de seguridad de los archivos que vaya a editar.

2. Detenga al agente:

   • Linux: Consulte Reiniciar Agente en Instalación de un Agente Harmony Linux.
   • Windows: Consulte Reiniciar Agente en Instalación de un Agente de Windows Harmony.

3. Encuentra el log4j.properties archivo, según lo determinado por el sistema operativo y la ubicación del directorio de inicio de Jitterbit:

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

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

5. Abra el log4j.properties archivo en un editor.

6. Encuentra estas 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
   # . . .
   

7. Justo antes de la línea que comienza con # Debug, agregue una de las siguientes líneas, reemplazando <connector_name> con el nombre de registro detallado del conector y establezca el nivel de registro. Consulte la documentación del conector individual para el formato de nombre apropiado, <connector_name>y nivel de registro.

   Los nombres de registro detallados están en uno de estos formatos, según el conector específico:

   log4j.logger.org.jitterbit.connector.<connector_name>=DEBUG
   

   log4j.logger.org.jitterbit.connector.verbose.logging.<connector_name>=DEBUG
   

   Utilizando 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 entonces 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
   # . . .
   

   Nota

   El registro detallado se puede utilizar con varios conectores. Agregue una línea separada para cada conector.

8. Guarde el archivo de propiedades y reinicie el agente:

   • Linux: Consulte Reiniciar Agente en Instalación de un Agente Harmony Linux.
   • Windows: Consulte Reiniciar Agente en Instalación de un Agente de Windows Harmony.

Deshabilitar el Registro Detallado¶

Para deshabilitar el registro detallado para un conector cuando ya no sea necesario, edite el archivo apropiado que se editó originalmente para habilitar el registro detallado. Puede dejar las entradas en el archivo y simplemente desactivar el nivel de registro.

1. Haga una copia de seguridad de los archivos que vaya a editar.

2. Detenga al agente:

   • Linux: Consulte Reiniciar Agente en Instalación de un Agente Harmony Linux.
   • Windows: Consulte Reiniciar Agente en Instalación de un Agente de Windows Harmony.

3. Vaya al archivo de propiedades apropiado como se describe arriba para su versión de agente y ábralo en un editor.

4. Busque la línea que contiene la información de registro detallada para el conector específico y cambie el indicador de DEBUG a OFF.

   • Uso de Workday Prism Analytics en un log4j.properties archivo como ejemplo, cambie:

     log4j.logger.org.jitterbit.connector.verbose.logging.workdayprismanalytics=DEBUG
     

     a

     log4j.logger.org.jitterbit.connector.verbose.logging.workdayprismanalytics=OFF
     

   • Uso de Workday Prism Analytics en un logback.xml archivo como ejemplo, cambie:

       <logger name="org.jitterbit.connector.verbose.logging.workdayprismanalytics" level="DEBUG"/>
     

     a

       <logger name="org.jitterbit.connector.verbose.logging.workdayprismanalytics" level="OFF"/>
     

5. Guarde el archivo y reinicie el agente:

   • Linux: Consulte Reiniciar Agente en Instalación de un Agente Harmony Linux.
   • Windows: Consulte Reiniciar Agente en Instalación de un Agente de Windows Harmony.

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:

• 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 se puede utilizar durante la depuración. Aquí 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 establece en el 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 respuesta: El cuerpo de 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 organización de Harmony y ID de ambiente asociado 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:-][ID de ambiente: 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 ambiente: 100000] - Connection is closing...