Registro detalhado para conectores usando agentes privados Jitterbit

Introdução

O registro detalhado do conector pode ajudar a diagnosticar e resolver problemas problemas com determinados Integration Studio conectores quando usados com agentes privados.

Para conectores que suportam registro verboso do conector, o nome específico do conector de registro verboso a ser usado é descrito em a documentação de cada conector.

Habilitar registro detalhado

O registro detalhado não é habilitado por padrão. Para habilitá-lo, você deve efetuar login em todos os hosts de agentes privados no grupo, editar um arquivo e reiniciar todos os agentes. O arquivo a ser editado depende da versão do agente privado:

• Versão do Agente 10.70 / 11.8 e posterior: Editar logback.xml

• Versão do Agente 10.35 a 10.69 / 11.7: Editar logback.xml

• Versão do Agente 10.34 e anteriores: Editar log4j.properties

Versão do Agente 10.70 / 11.8 e posterior: Editar logback.xml

Para habilitar o registro detalhado em agentes privados versão 10.70 ou 11.8 e posteriores, siga estas etapas:

1. Faça uma cópia de backup do seguinte arquivo:

   LinuxWindows

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

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

2. Edite o logback arquivo e encontre as seguintes linhas:

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

3. Para configurar o nível de log, adicione um dos seguintes, dependendo do conector, dentro do <configuration> elemento, configuração CONNECTOR_NAME para o nome de registro detalhado do conector, e LEVEL para o nível de registro Java sequência:

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

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

   Exemplo

   Para o conector Workday Prism Analytics, seu nome de registro detalhado é workdayprismanalytics (encontrado na documentação do conector do 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) Adicione linhas adicionais para outros conectores.

5. Salve o arquivo e reinicie o Linux ou Windows agente privado.

Versão do Agente 10.35 a 10.69 / 11.7: Editar logback.xml

Para habilitar o registro detalhado em agentes privados versão 10.35 a 10.69 ou versão 11.7, siga estas etapas:

1. Faça uma cópia de backup do seguinte arquivo:

   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 o logback arquivo e encontre as seguintes linhas:

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

3. Para configurar o nível de log, adicione um dos seguintes, dependendo do conector, dentro do <configuration> elemento, configuração CONNECTOR_NAME para o nome de registro detalhado do conector, e LEVEL para o nível de registro Java sequência:

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

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

   Exemplo

   Para o conector Workday Prism Analytics, seu nome de registro detalhado é workdayprismanalytics (encontrado na documentação do conector do 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) Adicione linhas adicionais para outros conectores.

5. Salve o arquivo e reinicie o Linux ou Windows agente privado.

Versão do Agente 10.34 e anteriores: editar log4j.properties

Para habilitar o registro detalhado em agentes privados versão 10.34 e anteriores, siga estas etapas:

1. Faça uma cópia de backup do seguinte arquivo:

   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 o arquivo e encontre as seguintes linhas:

   . . .
   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 o nível de log, adicione um dos seguintes, dependendo do conector, logo antes da linha que começa com # Debug, contexto CONNECTOR_NAME para o nome de registro detalhado do conector, e LEVEL para o nível de registro Java sequência:

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

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

   Exemplo

   Usando o conector Workday Prism Analytics como exemplo, seu nome de registro detalhado é workdayprismanalytics (encontrado na documentação do conector do Workday Prism Analytics). Este deve ser o snippet do arquivo de propriedade:

   . . .
   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) Adicione linhas adicionais para outros conectores.

5. Salve o arquivo e reinicie o Linux ou Windows agente privado.

Desabilitar registro detalhado

Para desabilitar o registro detalhado, edite o logback.xml ou log4j.properties arquivo correspondente à versão do agente privado, defina todos os níveis para OFF, então reinicie o agente.

Exibir logs detalhados

Quando o registro detalhado está habilitado, as entradas são gravadas no jitterbit-axis.log arquivo. Abra o arquivo de log em um editor para visualizar as entradas. O arquivo de log é salvo nestes locais, dependendo do sistema operacional e da versão do agente:

Para encontrar entradas, pesquise os termos INFO, DEBUG, ou VerboseLogger no arquivo. As entradas podem incluir mensagens, esquemas e outras informações que podem ser usadas na depuração. Um trecho é mostrado aqui:

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"
    }
  ]
}

Informações adicionais de log

Conectores usando o org.jitterbit.connector.<connector_name> formato de nome de registro detalhado inclui certas informações no arquivo de registro quando definido como DEBUG nível de registro:

• Chamadas HTTP: Chamadas HTTP do conector.

  • URL: A URL associada à chamada, incluindo quaisquer parâmetros de consultar e caminho, se presentes.
  • Cabeçalhos de solicitação: Cabeçalhos de solicitação associados à chamada. Por motivos de segurança, cabeçalhos que contêm certas informações, como as passadas em um cabeçalho de autorização, terão seus valores mascarados com asteriscos.
  • Cabeçalhos de resposta: Cabeçalhos de resposta associados à chamada.
  • Método HTTP: O método HTTP associado à chamada, um dos HEAD, GET, POST, PUT, PATCH, DELETE, OPTIONS, CONNECT, ou TRACE.
  • Tempo de resposta: O tempo de resposta da chamada em milissegundos.
  • Corpo da solicitação: O corpo da solicitação associado à chamada, se presente.
  • Corpo da resposta: O corpo da resposta associado à chamada, se presente.
  • Código de status HTTP: O código de status HTTP associado à chamada.

• Mensagens de solução de problemas: Mensagens de log adicionais para ajudar na solução de problemas do conector.

As mensagens de log também incluirão o ID da organização Harmony e ID do ambiente associado ao projeto como orgId e 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 do 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 do ambiente: 100000] - Connection is closing...