Registro Detalhado para Conectores
Introdução
O registro detalhado do conector pode ser usado na solução de problemas com determinados Cloud Studio conectores quando usados com agentes privados. O suporte do Jitterbit pode solicitar que você habilite o registro detalhado do conector seguindo as etapas nesta página.
Nota
As etapas aqui devem ser usadas somente quando orientadas pelo suporte da Jitterbit.
O registro detalhado do conector é compatível com determinados conectores do Cloud Studio, cada um com seu próprio nome do conector de registro detalhado que deve ser inserido conforme descrito em Ativar o registro detalhado mais adiante nesta página.
Para conectores que suportam o 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
A ativação do log detalhado do conector requer acesso a cada agente privado em um grupo de agentes, pois o log detalhado não é habilitado por padrão. Cada agente deve ter um arquivo de propriedades editado para permitir a criação de log detalhado.
Há um procedimento diferente para ativar o log detalhado dependendo da versão do agente. A versão de um agente privado pode ser determinada através do Management Console Agents página.
- Agente versão 10.70/11.8 e posterior: Editar
logback.xml
- Agente Versão 10.35 a 10.69/11.7: Editar
logback.xml
- Agente versão 10.34 e anteriores: Editar
log4j.properties
Versão do Agente 10.70/11.8 e Posterior: Editar logback.xml
Importante
A localização do logback.xml
o arquivo é diferente nas versões 10.70 / 11.8 e posteriores dos agentes privados do que nas versões anteriores. Ao atualizar de uma versão do agente que seja pelo menos 10.35, para manter as entradas de log verbose existentes, você pode copiar o arquivo de seu local existente para o novo local definido abaixo.
Para editar o logback.xml
arquivo:
-
Faça um backup de todos os arquivos que você irá editar.
-
Pare o agente:
- Linux: Consulte Reiniciar agente em Instalar um agente Harmony Linux.
- Windows: Consulte Reiniciar agente em Instalar um agente Harmony Windows.
-
Encontre o
logback.xml
arquivo, conforme determinado pelo sistema operacional e pela localização do diretório inicial do Jitterbit:- Linux:
/opt/jitterbit/tomcat/shared/lib/logback.xml
- Windows:
C:\Program Files\Jitterbit Agent\tomcat\shared\lib\logback.xml
- Linux:
-
Abra o
logback.xml
arquivo em um editor. -
Encontre as linhas:
. . . <logger name="org.springframework" level="WARN"/> <logger name="org.hibernate.engine.jdbc.internal.JdbcResourceRegistryImpl" level="ERROR"/> . . .
-
Após essas linhas adicione uma das seguintes linhas, substituindo
<connector_name>
com o nome de registro detalhado do conector e defina o nível de registro. Veja a documentação do conector individual para o formato de nomenclatura apropriado,<connector_name>
, e nível de registro.Nomes de registro detalhados estão em um destes formatos, dependendo do conector específico:
<logger name="org.jitterbit.connector.<connector_name>" level="DEBUG"/>
<logger name="org.jitterbit.connector.verbose.logging.<connector_name>" level="DEBUG"/>
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 snippet do arquivo 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
O registro detalhado pode ser usado com vários conectores. Adicione uma linha separada para cada conector.
-
Salve o arquivo e reinicie o agente:
- Linux: Consulte Reiniciar agente em Instalar um agente Harmony Linux.
- Windows: Consulte Reiniciar agente em Instalar um agente Harmony Windows.
Versão do Agente 10.35 a 10.69/11.7: Editar logback.xml
Para editar o logback.xml
arquivo:
-
Faça um backup de todos os arquivos que você irá editar.
-
Pare o agente:
- Linux: Consulte Reiniciar agente em Instalar um agente Harmony Linux.
- Windows: Consulte Reiniciar agente em Instalar um agente Harmony Windows.
-
Encontre o
logback.xml
arquivo, conforme determinado pelo sistema operacional e pela localização do diretório inicial do 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
- Linux:
-
Abra o
logback.xml
arquivo em um editor. -
Encontre as linhas:
. . . <logger name="org.springframework" level="WARN"/> <logger name="org.hibernate.engine.jdbc.internal.JdbcResourceRegistryImpl" level="ERROR"/> . . .
-
Após essas linhas adicione uma das seguintes linhas, substituindo
<connector_name>
com o nome de registro detalhado do conector e defina o nível de registro. Veja a documentação do conector individual para o formato de nomenclatura apropriado,<connector_name>
, e nível de registro.Nomes de registro detalhados estão em um destes formatos, dependendo do conector específico:
<logger name="org.jitterbit.connector.<connector_name>" level="DEBUG"/>
<logger name="org.jitterbit.connector.verbose.logging.<connector_name>" level="DEBUG"/>
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 snippet do arquivo 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
O registro detalhado pode ser usado com vários conectores. Adicione uma linha separada para cada conector.
-
Salve o arquivo e reinicie o agente:
- Linux: Consulte Reiniciar agente em Instalar um agente Harmony Linux.
- Windows: Consulte Reiniciar agente em Instalar um agente Harmony Windows.
Agente Versão 10.34 e Anteriores: Editar log4j.properties
Para editar o log4j.properties
arquivo:
-
Faça um backup de todos os arquivos que você irá editar.
-
Pare o agente:
- Linux: Consulte Reiniciar agente em Instalar um agente Harmony Linux.
- Windows: Consulte Reiniciar agente em Instalar um agente Harmony Windows.
-
Encontre o
log4j.properties
arquivo, conforme determinado pelo sistema operacional e pela localização do diretório inicial do 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
- Linux:
-
Abra o
log4j.properties
arquivo em um editor. -
Encontre estas 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 # . . .
-
Logo antes da linha que começa com
# Debug
, adicione uma das seguintes linhas, substituindo<connector_name>
com o nome de registro detalhado do conector e defina o nível de registro. Veja a documentação do conector individual para o formato de nomenclatura apropriado,<connector_name>
, e nível de registro.Nomes de registro detalhados estão em um destes formatos, dependendo do conector específico:
log4j.logger.org.jitterbit.connector.<connector_name>=DEBUG
log4j.logger.org.jitterbit.connector.verbose.logging.<connector_name>=DEBUG
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 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 # . . .
Nota
O registro detalhado pode ser usado com vários conectores. Adicione uma linha separada para cada conector.
-
Salve o arquivo de propriedades e reinicie o agente:
- Linux: Consulte Reiniciar agente em Instalar um agente Harmony Linux.
- Windows: Consulte Reiniciar agente em Instalar um agente Harmony Windows.
Desabilitar Registro Detalhado
Para desativar o log detalhado para um conector quando ele não for mais necessário, edite o arquivo apropriado que foi editado originalmente para ativar o log detalhado. Você pode deixar as entradas no arquivo e simplesmente desativar o nível de log.
-
Faça um backup de todos os arquivos que você irá editar.
-
Pare o agente:
- Linux: Consulte Reiniciar agente em Instalar um agente Harmony Linux.
- Windows: Consulte Reiniciar agente em Instalar um agente Harmony Windows.
-
Vá para o arquivo de propriedades apropriado conforme descrito acima para sua versão do agente e abra-o em um editor.
-
Encontre a linha que contém as informações de log detalhadas para o conector específico e altere o sinalizador de
DEBUG
paraOFF
.-
Usando o Workday Prism Analytics em um
log4j.properties
arquivo como exemplo, altere:log4j.logger.org.jitterbit.connector.verbose.logging.workdayprismanalytics=DEBUG
para
log4j.logger.org.jitterbit.connector.verbose.logging.workdayprismanalytics=OFF
-
Usando o Workday Prism Analytics em um
logback.xml
arquivo como exemplo, altere:<logger name="org.jitterbit.connector.verbose.logging.workdayprismanalytics" level="DEBUG"/>
para
<logger name="org.jitterbit.connector.verbose.logging.workdayprismanalytics" level="OFF"/>
-
-
Salve o arquivo e reinicie o agente:
- Linux: Consulte Reiniciar agente em Instalar um agente Harmony Linux.
- Windows: Consulte Reiniciar agente em Instalar um agente Harmony Windows.
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:
- 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 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: O URL associado à chamada, incluindo qualquer consultar e parâmetros de caminho, se presentes.
- Cabeçalhos de solicitação: Cabeçalhos de solicitação associados à chamada. Por questões de segurança, cabeçalhos que contenham determinadas informações, como a passada 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
, ouTRACE
. - 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 registro 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...
Nota
É possível que mensagens de log contenham um ID de organização indefinido ([orgId:-]
) se as mensagens forem registradas fora do tempo de execução da operação. Por exemplo, ao testar a configuração de conexão de um conector.