Ir para o conteúdo

Registro de depuração de operações para agentes em nuvem Jitterbit

Introdução

O registro de depuração de operações gera informações diagnósticas adicionais para ajudar na resolução de problemas. Este recurso produz o seguinte tipo de dado:

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. Informações pessoalmente identificáveis (PII) e dados sensíveis, como credenciais fornecidas em uma carga útil de solicitação, estarão visíveis em texto claro nos dados de entrada e saída nos logs da nuvem Harmony.

Devido a essas implicações de segurança, use o registro de depuração de operações apenas para depurar problemas durante os testes. Não ative este recurso em um ambiente de produção.

Ativar registro de depuração de operações

Você pode ativar o registro de depuração para uma operação individual do Studio ou Design Studio com estas etapas:

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

  • Design Studio: Clique com o botão direito no fundo de qualquer operação e selecione Opções. Na janela Opções da Operação, selecione Ativar Modo de Depuração Até e defina uma data para que o registro de depuração seja desativado.

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

Aviso

Em grupos de agentes em nuvem, a duração dessa configuração é pouco confiável. Os logs podem parar de ser gerados antes do final do período de tempo selecionado.

Visualizar logs de operações

Quando você ativa o registro de depuração de operações, pode visualizar os logs de operações em dois locais:

  • Logs de operações do Studio: Visualize os logs no menu Visualizar Logs de operações no Studio.
  • Página de Runtime: Visualize os logs na página Runtime do Console de Gerenciamento.

Ambos os locais exibem logs de operações com dados de entrada e saída de componentes (quando disponíveis) e dados de solicitação e resposta da API (quando a operação é acionada por uma API personalizada do Gerenciador de API). O payload de solicitação e resposta é incluído apenas quando Mostrar Payloads de Solicitação e Resposta nos Logs também está ativado na aba Configurações da API.

Dados de entrada e saída de componentes

Os dados de entrada e saída de componentes são gerados quando uma operação do Studio que tem registro de depuração de operações ativado no nível da operação é executada. Os dados de entrada e saída estão disponíveis apenas para atividades e transformações usadas como etapas da operação.

Cuidado

A geração de dados de entrada e saída de componentes não é afetada pela configuração do grupo de agentes Registro em nuvem ativado. Os dados de entrada e saída de componentes serão registrados na nuvem Harmony mesmo que o registro em nuvem esteja desativado.

Acesso a dados de entrada e saída

Os dados de entrada e saída de componentes são acessados a partir da tela de log de operações do Studio ou da página Runtime do Console de Gerenciamento em linhas de tabela adicionais mostradas para cada etapa da operação que possui dados de entrada e saída. Na coluna Entrada/Saída, í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 de componentes para essa etapa individual da operação. 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.

logs table operation steps header

  • Buscar: Busca os dados pelo texto inserido.
  • Copiar: Copia os dados do log para a sua área de transferência.
  • Baixar: Baixa os dados de entrada ou saída. O arquivo é nomeado com o nome da etapa da operação seguido de _input ou _output, conforme apropriado.

Política de retenção de dados de entrada e saída

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

Conteúdos dos dados de entrada e saída

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

Os dados de entrada e saída são gerados para estes componentes usados como etapas da operação:

  • Atividades: Dados de entrada e saída e qualquer informação relacionada à execução da atividade. Algumas atividades podem ter múltiplos 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 se aplicam a scripts quando você os utiliza como etapas da operação. O conteúdo do script, como o produzido pela função WritetoOperationLog, é exibido nas mensagens de log de um log de operação.