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 dois tipos de dados:

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 um payload 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 esse recurso em um ambiente de produção.

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

Você pode habilitar 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 Habilitar 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 Habilitar 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 na nuvem, a duração dessa configuração é imprevisível. Os logs podem parar de ser gerados antes do final do período de tempo selecionado.

Visualizar logs de operações

Quando você habilita 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 da operação 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 do componente (quando disponíveis) e dados de solicitação 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 o registro detalhado da API também está habilitado.

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 Studio que tem registro de depuração de operações habilitado 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 do componente não é afetada pela configuração do grupo de agentes Registro em nuvem habilitado. Os dados de entrada e saída do componente 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 do componente 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 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 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 á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 usa 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.

Dados de solicitação da API

Nova interface de Analytics necessária

O recurso de dados de solicitação da API está disponível apenas para organizações que foram atualizadas para a nova interface de Analytics. Esta atualização está sendo implementada gradualmente. Se você estiver interessado em acesso antecipado, entre em contato com o suporte da Jitterbit.

Quando uma operação é acionada por uma API personalizada do API Manager ou por uma API OData, a quantidade de informações exibidas nos logs de operação depende das configurações que estão habilitadas:

Configurações habilitadas Informações registradas Como habilitar
Nenhuma (padrão)
  • Operações malsucedidas apenas no Studio logs de operação.
  • Operações bem-sucedidas e malsucedidas com informações de solicitação da API na página Runtime do Console de Gerenciamento.
 Este é o comportamento padrão.
Registro de depuração de operações Operações bem-sucedidas e malsucedidas com informações de solicitação da API nos logs de operação do Studio e na página Runtime do Console de Gerenciamento. O payload de solicitação e resposta é excluído.
Registro de depuração de operações e registro detalhado da API Operações bem-sucedidas e malsucedidas com informações de solicitação da API nos logs de operação do Studio e na página Runtime do Console de Gerenciamento, incluindo payload de solicitação e resposta. Habilite o registro de depuração de operações para agente em nuvem ou agentes privados, e no Gerenciador de API, habilite Registro detalhado na aba Configurações da API.

informações da api

Informações da API

O log de operações pode exibir as seguintes informações para chamadas de API:

  • Informações da API: Detalhes sobre a chamada da API, incluindo nome da API, tipo de API, método de solicitação, ID da solicitação da API, IP de origem, gateway da API, URL do serviço da API e aplicativo de origem. Para descrições dos campos, veja informações da API.

  • Informações da chamada: Os cabeçalhos da solicitação HTTP enviados com a chamada da API, como accept, accept_encoding, content_length, fulluri, host, user_agent e cabeçalhos de encaminhamento.

  • Registro da chamada: Informações de rastreamento sobre o processamento da solicitação da API.