Saltar al contenido

Registro Detallado para Conectores

Introducción

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

Nota

Los pasos que se describen a continuación deben usarse solo cuando lo indique Jitterbit Support.

El registro detallado del conector es compatible con ciertos conectores de Cloud Studio, cada uno con su propio nombre de 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 debe usar 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 manera predeterminada. Cada agente debe tener un archivo de propiedades editado para habilitar 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 Management Console.

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

Importante

La ubicación del logback.xml El archivo es diferente en Agentes Privados versión 10.70 / 11.8 y posteriores que en versiones anteriores. Al actualizar desde una versión de agente que es al menos 10.35, para mantener las entradas de registro detalladas existentes, puede copiar el archivo desde su ubicación existente a la nueva ubicación definida a continuación.

Para editar el logback.xml archivo:

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

  2. Detener al agente:

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

    • Linux: /opt/jitterbit/tomcat/shared/lib/logback.xml
    • Windows: C:\Program Files\Jitterbit Agent\tomcat\shared\lib\logback.xml

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

  5. Encuentra las líneas:

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

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

    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 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 usar con varios conectores. Agregue una línea separada para cada conector.

  7. Guarde el archivo y reinicie el agente:

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

Para editar el logback.xml archivo:

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

  2. Detener al agente:

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

    • 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

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

  5. Encuentra las líneas:

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

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

    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 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 usar con múltiples conectores. Agregue una línea separada para cada conector.

  7. Guarde el archivo y reinicie el agente:

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

Para editar el log4j.properties archivo:

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

  2. Detener al agente:

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

    • 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

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

  5. 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
# . . .

  6. 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

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

    Nota

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

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

Deshabilitar el Registro Detallado

Para deshabilitar el registro detallado para un conector cuando ya no se necesita, 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. Realice una copia de seguridad de los archivos que vaya a editar.

  2. Detener al agente:

  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:

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 usar 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 usando 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 con la solución de problemas del conector.

Los mensajes de registro también incluirán el ID de la 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:-][envid: 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:-][envid: 100000] - Connection is closing...

Nota

Es posible que los mensajes de registro contengan un ID de organización indefinido ([orgId:-]) si los mensajes se registran fuera del tiempo de ejecución de la operación. Por ejemplo, al probar la configuración de conexión de un conector.