Registro de depurar de operação para agentes privados Jitterbit

Introdução

Os logs de depurar de operação são arquivos de log e dados adicionais gerados para operações quando o log de depurar de operação está habilitado.

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 registro de depurar de operação é habilitado em uma operação individual do Integration Studio ou Design Studio ou para todas as operações em um agente privado por meio do arquivo de configuração de um agente. Os arquivos podem ser acessados diretamente nos agentes privados e podem ser baixados por meio do Management Console Agentes 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.

• Dados de entrada e saída do componente: Dados gravados em um log de operação do Integration Studio quando o log de depurar de operação está habilitado em uma operação do Integration 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, estarão visíveis em texto não criptografado nos dados de entrada e saída dentro dos registros 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 da 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 API Operation.

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 Integration Studio ou Opções de operação do Design Studio:

• Integration Studio: Use o menu de ações de uma operação para selecionar Configurações. Na aba Opções, selecione Ativar Modo de Depuração Até e defina uma data para o registro de depurar ser desativado. A opção de aplicar em cascata as configurações do modo de depurar a qualquer operação filha 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 Ativar Modo de Depuração Até e defina uma data para que o registro de depurar seja desativado.

Esta data está limitada a 2 semanas a partir da data atual. O registro de depurar da operação será desativado no início desta data (ou seja, à 0h), 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 executadas 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.

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

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

Os arquivos criados neste diretório podem ficar muito grandes. Desative o registro de depurar assim que possível e exclua os arquivos quando não forem mais necessários.

Configurações adicionais

Agentes privados da versão 10.48 e posteriores possuem 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 que [VerboseLogging] seção e a verbose.logging.enable As configurações 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 a [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 estiver habilitado em uma operação do Integration 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 serão gerados quando essas operações forem 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 página ou diretamente no hospedar do agente nos seguintes locais:

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:

• Em [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:

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ções contêm mensagens de depurar para cada atividade operação e incluem informações registradas antes e depois da execução de cada transformação. Informações sobre outras ações, como leitura e gravação no cache do Harmony, também estão incluídas.

Esses arquivos normalmente são solicitados pelo suporte do Jitterbit se mais informações forem 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 Integration 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 somente 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 no Integration Studio tela de registro de operação ou Operações de tempo de execução do console de gerenciamento em linhas de tabela adicionais, mostradas para cada etapa de operação que contém 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 aquela etapa de operação individual. Cada entrada de log de entrada e saída é limitada a 100 MB. Se os dados de uma entrada de log de entrada ou saída individual excederem 100 MB, nenhum dado será exibido.

• Pesquisar: Pesquise os dados do texto inserido.
• Copiar: Copia os dados do log para a sua área de transferência.
• 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

Os dados de entrada e saída do componente são gerados para determinadas etapas de uma operação. Os dados são apropriados para a função de cada 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 à 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. O conteúdo do Script, como o 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

Normalmente, não é necessário acessar os logs do Agente relacionados aos dados de entrada e saída. Se você acha que pode haver um problema com a geração dos dados de entrada e saída, 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 este 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.