Saltar al contenido

Registro detallado para conectores que utilizan agentes privados de Jitterbit

Introducción

El registro detallado del conector se puede utilizar para solucionar problemas con ciertos Integration Studio conectores cuando se utilizan con agentes privados. Es posible que el soporte de Jitterbit le solicite que habilite el registro detallado del conector siguiendo los pasos de esta página.

Nota

Los pasos que se indican aquí solo deben utilizarse cuando lo indique el soporte de Jitterbit.

El registro detallado del conector es compatible con ciertos Integration Studio conectores, 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 utilizar se describe en la documentación de cada conector.

Habilitar el registro detallado

Para habilitar el registro detallado del conector, se requiere acceso a cada agente privado de 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 la Management Console Agentes página.

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

Importante

La ubicación de la logback.xml El archivo es diferente en la versión 10.70/11.8 y posteriores de los agentes privados que en las versiones anteriores. Al actualizar desde una versión de agente que sea al menos 10.35, para conservar 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. Haz una copia de seguridad de todos los archivos que vayas a editar.

  2. Detener el agente:

  3. Encuentra el logback.xml archivo, según lo determinado por el sistema operativo y la ubicación del directorio de inicio 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. Busque 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 tienen 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 de 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 logback:

    . . .
  <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 independiente para cada conector.

  7. Guarde el archivo y reinicie el agente:

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

Para editar el logback.xml archivo:

  1. Haz una copia de seguridad de todos los archivos que vayas a editar.

  2. Detener el agente:

  3. Encuentra el logback.xml archivo, según lo determine el sistema operativo y la ubicación del directorio de inicio 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. Busque 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 tienen 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 de 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 logback:

    . . .
  <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 independiente para cada conector.

  7. Guarde el archivo y reinicie el agente:

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

Para editar el log4j.properties archivo:

  1. Haz una copia de seguridad de todos los archivos que vayas a editar.

  2. Detener el agente:

  3. Encuentra el log4j.properties archivo, según lo determine el sistema operativo y la ubicación del directorio de inicio 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. Busque 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 tienen 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 de 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 utilizar con varios conectores. Agregue una línea independiente para cada conector.

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

Deshabilitar el registro detallado

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

  1. Haz una copia de seguridad de todos los archivos que vayas a editar.

  2. Detener el agente:

  3. Vaya al archivo de propiedades adecuado 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 la marca de DEBUG a OFF.

    • Uso de Workday Prism Analytics en una 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 una 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 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...

Nota

Es posible que los mensajes de registro contengan un ID de organización no definido ([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.