Registro detalhado para conectores usando agentes privados Jitterbit

Introdução

O registro detalhado do conector pode ajudar a solucionar problemas com certos conectores do Integration Studio quando usados com agentes privados.

Para conectores que suportam o registro detalhado, o nome específico do conector para usar é descrito na documentação de cada conector.

Habilitar registro detalhado

O registro detalhado não é habilitado por padrão. Para habilitá-lo, você deve fazer 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 anterior: Editar log4j.properties

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

Para habilitar o registro detalhado em agentes privados da versão 10.70 ou 11.8 e posterior, 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 arquivo logback 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 elemento <configuration>, definindo CONNECTOR_NAME para o nome de log detalhado do conector e LEVEL para a string do nível de log do Java:

   <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 log detalhado é workdayprismanalytics (encontrado na documentação do conector Workday Prism Analytics):

   Exemplo para 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 agente privado Linux ou Windows.

Versão do agente 10.35 a 10.69 / 11.7: Edite logback.xml

Para habilitar o log detalhado em agentes privados da 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 arquivo logback 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 elemento <configuration>, definindo CONNECTOR_NAME para o nome de log detalhado do conector e LEVEL para a string do nível de log do Java:

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

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

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

1. (Opcional) Adicione linhas adicionais para outros conectores.

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

Versão do agente 10.34 e anterior: edite 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 registro, adicione um dos seguintes, dependendo do conector, logo antes da linha que começa com # Debug, definindo CONNECTOR_NAME para o nome de registro detalhado do conector e LEVEL para a string do nível de registro Java:

   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 Workday Prism Analytics). Este deve ser o trecho do arquivo de propriedades:

        . . .
        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 agente privado [Linux](/pt/agent/linux/#manage) ou [Windows](/pt/agent/windows/#manage).

## Desativar registro detalhado {: #disable-verbose-logging }

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

## Visualizar registros detalhados {: #view-verbose-logs }

Quando o registro detalhado está ativado, as entradas são gravadas no arquivo `jitterbit-axis.log`. 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:

=== "Linux"
    `/opt/jitterbit/log/jitterbit-axis.log`

=== "Windows"
    `C:\Program Files\Jitterbit Agent\log\jitterbit-axis.log`

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 durante a depuração. Um trecho é mostrado aqui:

```txt
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 que usam o formato de nome de registro detalhado org.jitterbit.connector.<connector_name> incluem certas informações no arquivo de log quando configurados para o nível de registro DEBUG:

• Chamadas HTTP: Chamadas HTTP do conector.

  • URL: A URL associada à chamada, incluindo quaisquer parâmetros de consulta e caminho, se presentes.
  • Cabeçalhos da Solicitação: Cabeçalhos da 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 da Resposta: Cabeçalhos da 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 de conectores.

As mensagens de log também incluirão o ID da organização Harmony e o ID do ambiente associados 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:-][envId:100000] - Fechando conexão
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] - A conexão está fechando...