Registro de Depurar de Operação para Agentes Privados¶

Introdução¶

Os logs de depurar de operação são arquivos de log adicionais e dados que são gerados para operações quando o log de depurar de operação está habilitado. O log de depurar de operação é usado principalmente para depurar problemas durante testes e não deve ser ativado em um ambiente de produção.

Em agentes privados, habilitando o registro de depurar da operação pode resultar na geração de três tipos de logs:

• Arquivos de log de depurar da operação: Arquivos gravados em um diretório de agente privado que são gerados quando o log de depurar de operação é habilitado em uma operação individual do Cloud Studio ou Design Studio ou para todas as operações em um agente privado por meio de um arquivo de configuração do agente. Os arquivos são acessíveis diretamente em agentes privados e podem ser baixados por meio do Management Console Agents e Operações de tempo de execução páginas. Os arquivos estão sujeitos à política de retenção configurada nas regras de limpeza do agente, que é de 1 dia por padrão.

  Cuidado

  Quando o registro de depurar da operação é ativado, os arquivos de registro de depurar gerados podem ser grandes em quantidade e/ou tamanho. É recomendável desabilitar o registro de depurar o mais rápido possível.

• Dados de entrada e saída do componente: Dados gravados em um log de operação do Cloud Studio quando o log de depurar de operação está habilitado em uma operação do Cloud Studio em execução em um agente privado 10.48 ou posterior. Os dados são retidos por 30 dias pelo Harmony.

  Aviso

  Quando os dados de entrada e saída do componente são gerados, todos os dados de solicitação e resposta para essa operação são registrados na nuvem Harmony e permanecem lá por 30 dias. Esteja ciente de que informações de identificação pessoal (PII) e dados confidenciais, como credenciais fornecidas em uma payload de solicitação, serão visíveis em texto não criptografado nos dados de entrada e saída dentro dos logs da nuvem Harmony.

• Registros de operação da API: Registros de operação para operações de API bem-sucedidas e malsucedidas (configuradas para APIs personalizadas ou serviços OData). Quando o registro de depurar de operação não está habilitado, somente as operações de API malsucedidas são registradas nos registros de operação.

  Nota

  As etapas para habilitar o registro de todas as operações de API para todo o agente diferem das etapas descritas em Agente privado inteiro mais adiante nesta página. Para obter informações sobre como habilitar o registro de operação da API para todo o agente, consulte o API Operation seção em Editar o arquivo de configuração do agente.

Habilitar Registro de Depurar de Operação¶

O registro de depurar da operação pode ser habilitado em uma operação individual ou em um agente privado inteiro. Os dados de entrada e saída do componente são gerados por padrão em agentes privados 10.48 ou posteriores, mas podem ser desabilitados usando configurações adicionais no arquivo de configuração do agente privado.

Operação Individual¶

O registro de depurar no nível da operação pode ajudar se você estiver tendo problemas com uma operação individual e não precisar ativar o registro de depurar no nível do agente, o que pode gerar arquivos grandes em quantidade e/ou tamanho.

Você pode habilitar o registro de depurar para uma operação individual usando Opções de operação do Cloud Studio ou Opções de operação do Design Studio:

• Cloud Studio: Use o menu de ações de uma operação para selecionar Configurações. Na aba Opções, selecione Habilitar Modo de Depuração Até e defina uma data para que o registro de depurar seja desativado. A opção de cascatear as configurações do modo de depurar para quaisquer operações filhas também está disponível.

• Design Studio: Clique com o botão direito do mouse no plano de fundo de qualquer operação e selecione Opções. Na janela Opções de operação, selecione Habilitar modo de depuração até e defina uma data para que o registro de depurar seja desativado.

Esta data é limitada a 2 semanas a partir da data atual. O log de depurar da operação será desativado no início desta data (ou seja, às 12:00 am) usando o fuso horário do agente.

Agente Privado Inteiro¶

O registro de depurar de operação em nível de agente pode ser habilitado no arquivo de configuração do agente privado para todas as operações em execução em um agente privado.

Para habilitar o registro de depurar, edite o arquivo de configuração do agente privado conforme a seguir e reinicie os serviços do Jitterbit.

• Sob o [TransformationEngine] seção, conjunto WriteLog=true.

• Sob o [OperationEngine] seção, conjunto Debug=true.

Os arquivos criados neste diretório podem se tornar muito grandes. Desligue o registro de depurar assim que puder e exclua os arquivos quando eles não forem mais necessários.

Configurações Adicionais¶

Agentes privados que são versão 10.48 e posteriores têm a seção [VerboseLogging] presente em seu arquivo de configuração do agente privado com a configuração verbose.logging.enable=true, que permite a geração de dados de entrada e saída de componentes:

[VerboseLogging]
verbose.logging.enable=true

Ao atualizar uma versão anterior do agente privado para 10.48 ou posterior, a geração de dados de entrada e saída é habilitada automaticamente por padrão, mesmo se o [VerboseLogging] seção e o verbose.logging.enable configuração não estão presentes no arquivo de configuração.

Para desabilitar a geração de dados de entrada e saída do componente, você deve adicionar o [VerboseLogging] seção e conjunto verbose.logging.enable=false para evitar que os dados de entrada e saída dos componentes sejam registrados na nuvem Harmony.

Configurações adicionais no [VerboseLogging] A seção não deve ser alterada a menos que seja instruído pelo suporte do Jitterbit.

Arquivos de Log de Depurar de Operação¶

Depois que o registro de depurar de operação é habilitado em uma operação do Cloud Studio, uma operação do Design Studio ou um agente privado inteiro, os arquivos de registro de depurar de operação para as operações aplicáveis são gerados quando essas operações são executadas.

Acesso ao Arquivo de Log de Depuração¶

Os arquivos de log de depurar da operação podem ser acessados por meio do Ícone Baixar logs do agente no Management Console página Agentes, a aba Arquivos de depuração do Management Console Operações de tempo de execução ou diretamente no hospedar do agente nos seguintes locais:

• Windows: C:\Program Files\Jitterbit Agent\DataInterchange\Temp\Debug

• Linux: /usr/local/jitterbit/DataInterchange/Temp/Debug

  Para alterar o diretório do log de depurar da operação, edite o arquivo de configuração do agente privado da seguinte forma e reinicie os serviços Jitterbit: - Sob o [TransformationEngine] seção, conjunto WriteLogDir para o local do diretório desejado.

Política de Retenção de Arquivo de Log de Depuração¶

Por padrão, os arquivos de log de depurar da operação são excluídos automaticamente após 1 dia.

Este período de tempo é configurável em CleanupRules.xml, que pode ser acessado por agentes privados nestes locais padrão:

• Windows: C:\Program Files\Jitterbit Agent

• Linux: /usr/local/jitterbit/

Dentro do CleanupRules.xml arquivo, você pode editar esta regra de limpeza para alterar a política de retenção do log de depurar da operação:

  <CleanupRule>
      <DirectoryPath SearchSubDirectory = "YES" >DataInterchange/Temp/Debug</DirectoryPath>
      <Pattern>*</Pattern>
      <FileAge NumDays = "1" Comparator = "GE"/>
      <FileSize Size = "0" Comparator = "GE"/>
  </CleanupRule>

Conteúdo do Arquivo de Log de Depuração¶

Os arquivos de log de depurar de operação contêm mensagens de depurar para cada atividade de operação e incluem informações que são registradas antes e depois de cada transformação ser executada. Informações sobre outras ações, como leitura e gravação no cache do Harmony, também são incluídas.

Esses arquivos geralmente são solicitados pelo suporte do Jitterbit caso mais informações sejam necessárias durante a solução de problemas.

Dados de Entrada e Saída do Componente¶

Os dados de entrada e saída do componente são gerados quando uma operação do Cloud Studio tem registro de depurar de operação habilitado no nível de operação é executado em um agente privado 10.48 ou posterior que também tem as configurações padrão. Os dados de entrada e saída estão disponíveis apenas para atividades e transformações usadas como etapas da operação.

Acesso a Dados de Entrada e Saída¶

Os dados de entrada e saída do componente são acessados a partir do Cloud Studio tela de log de operação em linhas de tabela adicionais mostradas para cada etapa de operação que tem dados de entrada e saída. Na coluna Entrada/Saída, os ícones para atividades e transformações usadas como etapas da operação podem ser clicados para mostrar ou ocultar os dados de entrada e saída do componente para essa etapa de operação individual. Cada entrada de log de entrada e saída é limitada a 100 MB. Se os dados para uma entrada de log de entrada ou saída individual excederem 100 MB, nenhum dado será exibido.

• Copiar: Copia os dados de log para sua área de transferência. Quando clicado, um ícone da área de transferência é exibido temporariamente.
• Download: Baixa os dados de entrada ou saída. O arquivo é nomeado com o nome da etapa de operação seguido por _input ou _output conforme apropriado.

Política de Retenção de Dados de Entrada e Saída¶

Os dados de entrada e saída dos componentes são retidos por 30 dias pelo Harmony.

Conteúdo de Dados de Entrada e Saída¶

Dados de entrada e saída do componente são gerados para certas etapas de uma operação. Os dados são apropriados para a função de uma etapa. A entrada é a estrutura que o componente consome, enquanto a saída é a estrutura que o componente produz.

Dados de entrada e saída são gerados para esses componentes usados como etapas de operação:

• Atividades: Dados de entrada e saída e quaisquer informações relacionadas para a execução da atividade. Algumas atividades podem ter vários arquivos de entrada e saída.
• Transformações: Dados de entrada e saída para a execução da transformação.

Os dados de entrada e saída não são aplicáveis a scripts quando são usados como etapas de operação. Conteúdo de Script, como aquele produzido pelo WritetoOperationLog função, é exibida nas mensagens de log de um log de operação.

Solução de Problemas de Dados de Entrada e Saída¶

Logs de Agente relacionados aos dados de entrada e saída normalmente não precisam ser acessados. Se você acha que pode haver um problema com a geração dos dados de entrada e saída, você pode verificar os arquivos de log do serviço Verbose Log Shipper em um agente privado:

<JITTERBIT_HOME>/VerboseLogShipper/verbose-log-shipper.out.log

O serviço Verbose Log Shipper pode ser reiniciado reiniciando um agente privado.

Em agentes privados do Linux, você também pode desabilitar e reabilitar esse serviço usando estas opções de linha de comando do Jitterbit:

jitterbit start_verboselogshipper

jitterbit stop_verboselogshipper

Essas opções também podem ser visualizadas usando jitterbit --help.