Logs de operação no Jitterbit Studio

Introdução

Quando uma operação é executada, um log de operação é gerado. Um log de operação contém informações sobre quando e onde uma operação foi executada, o status da operação e quaisquer mensagens de log. Se mensagens de log detalhadas são exibidas depende dos níveis de permissão e acesso e se o registro em nuvem está ativado.

Operações acionadas por API (configuradas através de APIs personalizadas ou APIs OData) possuem registro adicional que pode ser ativado dependendo de quais configurações estão definidas. Para detalhes, consulte Dados de solicitação e resposta da API.

Os logs de operação, incluindo mensagens de log detalhadas de agentes em nuvem e agentes privados, e dados de entrada e saída de componentes dentro dos logs de operação, são retidos por 30 dias pelo Harmony.

Acessar logs de operação

Os logs de operação podem ser acessados no Studio no nível do fluxo de trabalho, operação ou projeto. Dependendo de onde são acessados, a tela de log de operação inclui um máximo de 1.000 logs para um período determinado de operações que foram executadas em um fluxo de trabalho específico, para uma operação específica ou em um projeto, respectivamente. Se as operações estiverem vinculadas com ações de operação ou a função RunOperation, os logs das operações subsequentes também serão incluídos.

Por fluxo de trabalho

A opção Exibir Logs para um fluxo de trabalho, que mostra logs de operações executadas dentro de um fluxo de trabalho específico, pode ser acessada na guia Fluxos de Trabalho do painel de projeto (consulte Menu de ações do fluxo de trabalho em Guia Fluxos de Trabalho do painel de projeto).

Por operação

A opção Exibir Logs para uma operação é acessível a partir destes locais:

• A guia Fluxos de Trabalho do painel de projeto (consulte Menu de ações do componente em Guia Fluxos de Trabalho do painel de projeto).
• A guia Componentes do painel de projeto (consulte Menu de ações do componente em Guia Componentes do painel de projeto).
• A tela de design (consulte Menu de ações do componente em Tela de design).

Além disso, após executar uma operação manualmente, você pode clicar no status da operação na tela de design para exibir os logs (consulte Status da operação em Implantação e execução de operação).

Por projeto

Ao usar a opção Exibir Logs de um projeto, a página Runtime do Console de Gerenciamento é aberta em uma nova guia do navegador e é filtrada para exibir logs de operações que foram executadas dentro do projeto.

A opção Exibir Logs para um projeto pode ser acessada a partir destes locais:

• A página Projetos (consulte Visualização de cartão ou Visualização de lista em Projetos).
• A barra de ferramentas do projeto (consulte Menu de ações do projeto em Barra de ferramentas do projeto).

Guia de log de operações do painel do projeto

Ao visualizar logs por fluxo de trabalho ou operação, o painel do projeto abre na parte inferior da tela de design para manter seu contexto no projeto. Os logs de operações são exibidos em uma visualização dividida, com a lista de operações à esquerda e informações detalhadas do log da operação selecionada à direita.

• Abas: As abas na parte superior do painel são rotuladas com Logging seguido pelo nome da operação ou fluxo de trabalho (dependendo de onde os logs foram acessados). Ao acessar logs adicionais ou variáveis de projeto, novas abas são adicionadas. Para reordenar abas, arraste e solte uma aba. Para fechar uma aba, clique no ícone de fechamento. Fechar a última aba ou usar o ícone de fechamento mais à direita fecha o painel.
• Redimensionar: A barra na parte superior do painel pode ser usada para redimensioná-lo. Passe o mouse sobre a barra e arraste o ícone de redimensionamento para cima ou para baixo para redimensionar o painel.
• Recolher: Recolhe o painel para que todos os logs fiquem ocultos. Após recolhido, clique no ícone de retorno para voltar à visualização anterior.
• Expandir: Expande o painel para tela inteira para que logs adicionais sejam exibidos. Após expandido, clique no ícone de retorno para voltar à visualização anterior.
• Abrir no Runtime: Abre a guia de log de operações atualmente acessada com qualquer consulta aplicada na página Runtime do Console de Gerenciamento. Os filtros de período não são retidos e devem ser reaplicados na página Runtime.
• Fechar: Fecha o painel.

Controles da tabela de log de operações

A visualização do painel de log de operações inclui filtros para período e consultas, além de atualização da tabela.

Período

Todos os períodos são exibidos como a hora local do navegador. Por padrão, o período é definido para os Últimos 24 horas de logs desde a última execução de uma operação. Como alternativa, use o menu para selecionar Últimas 48 horas, Últimas 72 horas ou Período personalizado:

Para um determinado período, um máximo de 1.000 logs são incluídos na tabela de log de operações.

Quando Período personalizado é selecionado, uma caixa de diálogo de configuração abre:

• Finalizado: Para filtrar pela data e hora em que a operação ou etapa de operação parou de ser executada, clique no ícone de calendário para abrir o seletor de data. Para limpar este campo, clique no ícone de limpeza de filtro.
• Iniciado: Para filtrar pela data e hora em que a operação ou etapa de operação começou a ser executada, clique no ícone de calendário para abrir o seletor de data. Para limpar este campo, clique no ícone de limpeza de filtro.
• Aplicar: (Ativado quando um dos campos Finalizado ou Iniciado está configurado.) Aplica todos os filtros de data e hora à tabela de logs de operações.
• Limpar: (Ativado quando um dos campos Finalizado ou Iniciado está configurado.) Limpa os filtros Finalizado e Iniciado.

Após um ícone de calendário ser clicado, o seletor de data/hora é aberto para esse campo:

• Data de/até: Use o calendário em um ou ambos esses campos para selecionar uma data nos últimos 30 dias. Datas fora desse intervalo não são selecionáveis.

• Mês: O mês atual é usado por padrão. Use as setas para navegar para um mês diferente.

  • Dia: Selecione o dia desejado no calendário.

• Hora: Digite a hora, o minuto e o período (AM ou PM).

Atualizar

Os logs são atualizados automaticamente a cada cinco segundos se alguma operação ainda estiver em execução (status de Recebido, Enviado, Pendente ou Em execução).

Você também pode atualizar os logs manualmente a qualquer momento para exibir informações atualizadas. Para atualizar os logs manualmente, clique no ícone Atualizar no canto superior direito.

Consultas

Uma consulta é um ou mais termos de chave/valor. Vários termos são separados por ponto e vírgula. Um termo tem a forma <chave><operador><valor>. Para a chave operation, o valor pode incluir um caractere curinga, %, que corresponde a qualquer string.

Para usar uma consulta, insira uma especificação de consulta válida na barra de pesquisa e pressione Enter:

A tabela a seguir mostra os componentes de termo de consulta disponíveis:

Status de operação

A seguir estão os status que podem ser consultados ao usar a chave status:

• Erro: Se o agente conclui a execução de uma operação, mas houve um erro fatal ao escrever no sistema de destino, ou houve um erro de validação fatal na transformação, ou a lógica de transformação acionou a função RaiseError, o status da operação é definido como Erro e a execução da operação é encerrada.

• Falha SOAP: Se o agente conclui a execução de uma operação e o resultado foi uma falha SOAP, o status é definido como Falha SOAP. Este status é aplicável apenas para operações que usam atividades do Salesforce, Salesforce Service Cloud, ServiceMax, SOAP ou Workday.

• Enviado: Quando operações são enviadas para a fila do Harmony, mas ainda não foram selecionadas por um agente para execução, elas têm um status de Enviado. As operações podem ser enviadas de várias formas:

  • Serviço de agendamento do Jitterbit ou serviço de agendamento externo
  • Execução manual da operação no Studio
  • Uma função RunOperation de um script ou transformação
  • Qualquer ferramenta, incluindo JitterbitUtils, que chama uma API do API Manager

• Recebido: Assim que um agente é selecionado e o agente reconhece que recebeu a solicitação para executar uma operação, o status é alterado para Recebido.

• Pendente: Após uma operação ser agendada para execução no mecanismo de operações de um agente, o status muda para Pendente. As operações não devem permanecer em status Pendente por longos períodos, pois os agentes devem captar a solicitação e começar a executar operações em pouco tempo.

• Em execução: Quando o agente começa a executar uma operação, o status muda para Em execução. As operações permanecem neste status até serem concluídas ou encontrarem um erro. O agente começa a registrar as mensagens geradas pela operação conforme ela é executada, permitindo que os usuários acompanhem qual parte da operação está sendo executada no momento.

• Cancelamento solicitado: Indica que uma solicitação para interromper a operação foi enviada. Se um usuário quiser interromper uma operação que está em status Enviada, Recebida, Pendente ou Em execução, ele pode fazer isso a partir destes locais:

  • A operação (consulte status de tempo de execução em Design canvas).
  • A tabela de log de operações.
  • A página Runtime do Management Console.

  Como alternativa, é possível habilitar outra operação para cancelar uma operação usando uma combinação das funções GetOperationQueue e CancelOperation. Após solicitar um cancelamento, o status da operação muda para Cancelamento solicitado. Uma operação não deve permanecer neste status por muito tempo, pois o agente deve cancelá-la em um período relativamente curto.

• Cancelada: Após um agente cancelar uma operação, ele define o status como Cancelada e a operação é encerrada. Todas as informações de log até o ponto do cancelamento estão disponíveis para revisão nas mensagens de log, permitindo saber em qual ponto a operação foi cancelada.

• Sucesso: Após um agente concluir a execução de uma operação, se o resultado foi um sucesso sem avisos do sistema de destino, ou aviso escrito na transformação usando a função WriteToOperationLog, o status é definido como Sucesso.

• Sucesso com informações: Se o agente concluir a execução de uma operação, mas houve problemas não fatais na transformação ou no envio para o sistema de destino, ou a função WriteToOperationLog foi usada para escrever mensagens no log, o status é definido como Sucesso com informações. Isso alerta o usuário para verificar as informações nas mensagens de log.

• Sucesso com aviso: Se o agente concluir a execução de uma operação, mas houve problemas não fatais na transformação ou no envio para o sistema de destino, e havia um aviso, o status é definido como Sucesso com aviso. Isso alerta o usuário para verificar os avisos nas mensagens de log.

• Sucesso com erro secundário: Se o agente concluir com sucesso a execução de uma operação, mas em uma ou mais operações secundárias houve um erro fatal ao escrever no sistema de destino, ou houve um erro de validação fatal na transformação, ou a lógica de transformação acionou a função RaiseError, o status da operação é definido como Sucesso com erro secundário. Este status não se aplica a operações assíncronas.

• Status atrasado: Se o agente não retornar um log de operações por qualquer motivo, Status atrasado é exibido. O Harmony tentará buscar logs seis vezes, com um tempo limite de 10 segundos entre cada chamada. Atualize ou verifique os logs novamente mais tarde. Não é possível filtrar operações com Status atrasado, mas você pode vê-las nos logs de operações.

Status da etapa de operação

As etapas de operação aparecem apenas quando essa operação tem o log de depuração de operação habilitado no nível de operação (para agentes em nuvem ou para agentes privados) e a operação foi executada em um agente versão 10.48 ou posterior.

As etapas de operação podem ter estes status possíveis:

• Concluída: A etapa de operação foi executada e concluída sem erros.
• Erro: A etapa de operação foi executada, mas não pôde ser concluída devido a um erro.
• Incompleta: A etapa de operação não foi executada ou concluída. As possíveis razões para este status incluem que a etapa de operação está aguardando execução ou que houve um erro em uma etapa de operação anterior que impediu a execução da etapa seguinte.

Visualização do log de operações

A visualização do log de operações exibe uma visualização dividida com logs de operações no painel esquerdo e informações detalhadas do log da operação selecionada no painel direito. A visualização usa os controles de tabela selecionados para filtrar resultados. Se as operações forem encadeadas, essas operações serão listadas sob a operação pai.

As operações pai (e todas as operações filhas abaixo delas) são classificadas em ordem crescente por Iniciado. A tabela pode ser classificada (apenas para operações de nível superior) por Nome, Iniciado, Concluído, Duração ou Status clicando na respectiva linha de cabeçalho.

Um máximo de 1000 logs de operações é exibido. Para visualizar logs de operações adicionais, ajuste os filtros adequadamente.

Painel de lista de operações

Ao abrir a visualização do log de operações, o primeiro log de operações na lista é selecionado por padrão. As informações detalhadas do log dessa operação aparecem no painel direito.

• Nome: O nome da operação ou etapa de operação. Os símbolos de intercalação, que podem ser usados para expandir ou recolher linhas adicionais, são mostrados em operações pai e em operações para as quais dados de entrada e saída de componentes estão disponíveis:

  • Operações pai: Ao expandir uma operação pai, linhas adicionais para suas operações filhas aparecem na ordem em que foram executadas. Por padrão, todas as operações pai são expandidas. Use os ícones recolher lista ou expandir lista ao lado da coluna Nome para recolher ou expandir todas as operações pai.

  • Operação com dados de entrada e saída: Ao expandir uma operação com dados de entrada e saída, linhas adicionais para cada etapa de operação aparecem na ordem em que foram executadas. Mais informações são fornecidas em Dados de entrada e saída de componentes.

• Iniciado: A data e hora em que a operação ou etapa de operação começou a ser executada, exibida como a hora local do navegador.

• Concluído: A data e hora em que a operação ou etapa de operação parou de ser executada, exibida como a hora local do navegador. Este campo fica em branco enquanto a operação ou etapa de operação ainda está em execução.

• Duração: O tempo decorrido entre Iniciado e Concluído, informado em segundos para operações e em milissegundos para etapas de operação. Este campo fica em branco enquanto a operação ou etapa de operação ainda está em execução.

• Status: O status da operação ou etapa de operação. Para obter uma lista completa dos possíveis status, consulte Status de operações anteriormente nesta página.

• Ações: Esta ação está disponível:

  • Cancelar operação: Habilitado para operações que estão com status Enviado, Recebido, Pendente ou Em execução.

    Cancelar operação envia uma solicitação ao agente para interromper a operação. Após clicar, o status Cancelamento solicitado é exibido ao lado do status de operação em tempo real.

    Nota

    Enviar uma solicitação de cancelamento não garante que a operação será cancelada. Operações com status Cancelamento solicitado ainda podem ser executadas, dependendo do estado de execução atual do agente.

• Atualizar: Clique para atualizar a lista de logs de operações.

• Preferências de visualização: Abre um menu que controla quais operações aparecem na visualização do log.

  • Operações encadeadas: Mostra ou oculta operações filhas em uma cadeia de operações. Quando habilitado (), a visualização do log exibe a operação selecionada e todas as operações filhas em sua cadeia de operações. Quando desabilitado (), apenas os logs da operação selecionada aparecem.

• Filtrar Colunas: Clique para abrir um painel que permite reordenar as colunas ou ajustar sua visibilidade no painel de lista de operações:

  

  • Mostrar Tudo: Torna todas as colunas visíveis.

  • Mover: Arraste e solte para alterar a posição da coluna em relação às outras.

  • Ocultar: A coluna está visível. Clique para ocultá-la.

  • Mostrar: A coluna está oculta. Clique para exibi-la.

• Redimensionar colunas: Arraste a barra Redimensionar de uma coluna para redimensioná-la.

Painel de log de operação

Clique em qualquer linha de operação no painel esquerdo para exibir suas informações de log detalhadas no painel direito:

• Nome: O nome da operação ou etapa de operação à qual o log pertence.

• Status: O status da operação ou etapa de operação.

• Iniciado: A data e hora em que a operação ou etapa de operação começou a ser executada, exibida como a hora local do navegador.

• Concluído: A data e hora em que a operação ou etapa de operação parou de ser executada, exibida como a hora local do navegador. Este campo fica em branco enquanto a operação ou etapa de operação ainda está em execução.

• Duração: O tempo decorrido entre Iniciado e Concluído, informado em segundos para operações e em milissegundos para etapas de operação. Este campo fica em branco enquanto a operação ou etapa de operação ainda está em execução.

• Registros de Origem: Ao usar uma atividade FTP ou Banco de Dados como origem, exibe-se a contagem de registros que foram lidos do sistema de origem. Para outros conectores, a contagem mostra 0 independentemente do número de registros de origem.

• Registros de Destino: Ao usar uma atividade FTP ou Banco de Dados como destino, exibe-se a contagem de registros que foram postados no sistema de destino. Para outros conectores, a contagem mostra 0 independentemente do número de registros de destino.

• Mensagens de log: As mensagens de log incluem os detalhes do log da operação selecionada. Se as mensagens de log são exibidas depende de o registro em nuvem estar ativado. Para mais informações, consulte a aba Mensagens na documentação da página Runtime do Console de Gerenciamento.

  Nota

  • As datas e horas nas mensagens de log aparecem em seu formato original da origem e não são convertidas para a hora local do navegador.
  • As mensagens de log que excedem ~100 KB de tamanho (~99.000 caracteres) são truncadas, indicadas com message truncated aparecendo no final do log.

• Copiar: Copia os dados do log para sua área de transferência.

• Baixar: Baixa as mensagens de log como um arquivo de texto.

• Mostrar / ocultar: Mostra ou oculta as mensagens de log.

Dados de entrada e saída do componente

Os dados de entrada e saída do componente são gerados quando uma operação tem o registro de depuração de operação ativado no nível de operação (para agentes em nuvem ou para agentes privados) e a operação foi executada em um agente versão 10.48 ou posterior.

Quando dados de entrada e saída de componentes estão presentes, uma representação gráfica da operação ou etapa de operação é exibida no painel de lista de operações:

Você pode clicar nas etapas de operação 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.

• Pesquisar: Pesquisa os dados pelo texto inserido.

• Copiar: Copia os dados de log para a área de transferência.

• Baixar: Baixa os dados de entrada ou saída como um arquivo no formato de dados apropriado. O arquivo é nomeado com o nome da etapa de operação seguido por _input ou _output, conforme apropriado.

Dados de solicitação e resposta da API

Quando uma operação é acionada por uma API personalizada ou API OData do API Manager, as informações exibidas nos logs de operação dependem de quais configurações estão habilitadas. Operações malsucedidas são sempre registradas. Execuções bem-sucedidas aparecem nos logs de operação do Studio apenas quando Ativar modo de depuração até (uma configuração do API Manager) ou Log de depuração de operação (uma configuração do agente) está ativo. indica que a configuração adiciona essa capacidade; indica que não:

Informações da API

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

• API: O nome da API que acionou a operação.

  • Abrir API em nova aba: Clique para abrir a API em uma nova aba no API Manager.

• Tipo de API: Este campo pode ter um dos seguintes tipos:

  • CUSTOM_API: Uma API personalizada criada no API Manager.
  • ODATA: Uma API OData criada no API Manager.

• Método de Requisição: O método HTTP usado para a chamada de API. Os valores possíveis incluem GET, POST, PUT, DELETE, PATCH e MERGE.

• ID de requisição de API: Um identificador único para a requisição de API. Você pode usar esse ID para correlacionar logs em diferentes sistemas e para pesquisar requisições específicas. Clique no ícone copiar para copiar o valor.

• IP de Origem: O endereço IP da aplicação cliente ou servidor que fez a requisição de API.

• Gateway de API: O gateway de API que processou a requisição. Este campo mostra o nome de domínio do gateway de API na nuvem ou gateway de API privado que tratou a chamada de API.

• URL do serviço de API: A URL completa para chamar a API, incluindo a URL base, raiz do serviço, versão e quaisquer parâmetros de caminho. Esta é a URL do serviço de API completa conforme consumida pelo cliente.

• Aplicação de Origem: A aplicação ou navegador que fez a requisição de API.

Informações de chamada

O log de operação exibe uma seção Informações de chamada com os cabeçalhos de requisição HTTP enviados com a chamada de API. Cada cabeçalho é exibido como um par chave-valor, como accept, accept_encoding, content_length, fulluri, host, user_agent e cabeçalhos de encaminhamento. Os cabeçalhos que carregam credenciais ou dados de sessão são mascarados, conforme descrito em Cabeçalhos mascarados.

Log de chamada

O log de operação também exibe uma seção Log de chamada com informações de rastreamento detalhadas sobre o processamento da requisição de API. Essas informações podem ser usadas para solucionar problemas de gateway de API, problemas de tempo limite ou para entender o fluxo de processamento interno da API. O conteúdo específico do log de chamada varia dependendo da configuração da API, das configurações do gateway e se algum problema ocorreu durante o processamento da requisição.