Registros de operações no Jitterbit Studio

Introdução

Quando uma operação é executada, um registro de operação é gerado. Um registro 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. A exibição de mensagens de log detalhadas depende dos níveis de permissão e acesso e se o registro em nuvem está habilitado.

Operações acionadas por API (configuradas através de APIs personalizadas ou APIs OData) têm registros adicionais que podem ser habilitados dependendo das configurações configuradas. Para detalhes, veja dados da solicitação da API.

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

Acessar registros de operações

Os registros de operações podem ser acessados no Studio no nível de fluxo de trabalho, operação ou projeto. Dependendo de onde são acessados, a tela de registro de operações inclui um máximo de 1.000 registros para um determinado período de tempo para 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 a ações de operação ou à função RunOperation, os registros para operações a montante também estão incluídos.

Por fluxo de trabalho

A opção Ver Registros para um fluxo de trabalho, que mostra registros para operações que foram executadas dentro de um fluxo de trabalho específico, pode ser acessada na aba Fluxos de Trabalho do painel do projeto (veja menu de ações do fluxo de trabalho na aba Fluxos de Trabalho do painel do Projeto).

Por operação

A opção Ver Logs para uma operação está acessível a partir destes locais:

• A aba Workflows do painel do projeto (veja o menu de ações do componente na aba Workflows do painel do projeto).
• A aba Components do painel do projeto (veja o menu de ações do componente na aba Components do painel do projeto).
• A tela de design (veja o menu de ações do componente na 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 (veja o status da operação em Implantação e execução da operação).

Por projeto

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

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

• A página Projects (veja Visualização em cartão ou Visualização em lista em Projetos).
• A barra de ferramentas do projeto (veja o menu de ações do projeto na barra de ferramentas do projeto).

Log de operação da gaveta do projeto

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

• Guias: As guias na parte superior da gaveta são rotuladas com Registro seguido pelo nome da operação ou fluxo de trabalho (dependendo de onde os logs foram acessados). Quando você acessa logs adicionais ou variáveis de projeto, novas guias são adicionadas. Para reorganizar as guias, arraste e solte uma guia. Para fechar uma guia, clique no ícone de fechar . Fechar a última guia ou usar o ícone de fechar mais à direita fecha a gaveta.
• Redimensionar: A barra na parte superior da gaveta pode ser usada para redimensionar a gaveta. Passe o mouse sobre a barra e arraste o ícone de redimensionar para cima ou para baixo para redimensionar a gaveta.
• Colapsar: Colapsa a gaveta para que todos os logs fiquem ocultos. Uma vez colapsada, clique no ícone de retorno para voltar à visualização anterior.
• Expandir: Expande a gaveta para tela cheia para que quaisquer logs adicionais sejam exibidos. Uma vez expandida, clique no ícone de retorno para voltar à visualização anterior.
• Abrir em Tempo de Execução: Abre a guia de log de operação atualmente acessada com quaisquer consultas aplicadas na página Tempo de Execução do Console de Gerenciamento. Filtros de intervalo de tempo não são mantidos e devem ser reaplicados na página Tempo de Execução.
• Fechar: Fecha a gaveta.

Controles da tabela de log de operação

A visualização da gaveta de log de operação inclui filtros para intervalo de tempo e consultas, e atualização da tabela.

Período de Tempo

Todos os períodos de tempo são exibidos como o horário local do navegador. Por padrão, o período de tempo é definido para as Últimas 24 Horas de logs desde a última execução de uma operação. Alternativamente, use o menu para selecionar Últimas 48 Horas, Últimas 72 Horas ou Tempo Personalizado:

Para um determinado período de tempo, um máximo de 1.000 logs está incluído na tabela de logs de operação.

Quando Tempo Personalizado é selecionado, uma caixa de diálogo de configuração é aberta:

• Finalizado: Para filtrar pela data e hora em que a operação ou etapa da 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 limpar filtro .
• Iniciado: Para filtrar pela data e hora em que a operação ou etapa da 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 limpar filtro .
• Aplicar: (Ativado quando os campos Finalizado ou Iniciado estão configurados.) Aplica todos os filtros de data e hora à tabela de logs de operação.
• Limpar: (Ativado quando os campos Finalizado ou Iniciado estão configurados.) Limpa os filtros Finalizado e Iniciado.

Uma vez que um ícone de calendário é clicado, o seletor de data/hora é aberto para aquele campo:

• Data de/Início: Use o calendário sob um ou ambos os campos para selecionar uma data dentro dos últimos 30 dias.

  • 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, minuto e período do dia (AM ou PM).

Atualizar

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

Você também pode atualizar manualmente os logs a qualquer momento para exibir informações atualizadas. Para atualizar manualmente os logs, 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 termos de consulta disponíveis:

Status de operações

Os seguintes são os status que podem ser consultados ao usar a chave status:

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

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

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

  • Serviço de agendamento 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: Uma vez que um agente é selecionado e o agente reconheceu que recebeu o pedido para executar uma operação, o status é alterado para Recebido.

• Pendente: Uma vez que uma operação é agendada para ser executada no mecanismo de operações de um agente, o status é alterado para Pendente. As operações não devem permanecer no status Pendente por longos períodos, pois os agentes devem retirar o pedido e começar a executar as operações em um curto espaço de tempo.

• Executando: Uma vez que o agente começa a executar uma operação, o status deve mudar para Executando. As operações permanecem nesse status até que sejam concluídas ou encontrem um erro. O agente começa a registrar mensagens geradas pela operação enquanto ela é executada, para que os usuários possam acompanhar qual parte da operação está sendo executada no momento.

• Cancel Requested: Indica que um pedido para parar a operação foi enviado. Se um usuário deseja interromper uma operação que está em status Submitted, Received, Pending ou Running, ele pode fazê-lo a partir destes locais:

  • A operação (veja runtime status em Design canvas).
  • A operation log table.
  • A página Runtime do Management Console.

  Alternativamente, ele pode habilitar outra operação para cancelar uma operação usando uma combinação das funções GetOperationQueue e CancelOperation. Uma vez que um cancelamento é solicitado, o status da operação muda para Cancel Requested. Uma operação não deve permanecer nesse status por muito tempo, pois o agente deve cancelar a operação em um período de tempo relativamente curto.

• Canceled: Uma vez que um agente cancela uma operação, ele define o status como Canceled e a operação é encerrada. Todas as informações de log até o ponto de cancelamento estão disponíveis para revisão nas mensagens de log, para que você saiba em que ponto a operação foi cancelada.

• Success: Uma vez que um agente completa a execução de uma operação, se o resultado foi um sucesso sem avisos do sistema alvo, ou aviso escrito na transformação usando a função WriteToOperationLog, então o status é definido como Success.

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

• Success with Warning: Se o agente completa a execução de uma operação, mas houve problemas não fatais na transformação ou no envio para o sistema alvo, e houve um aviso, então o status é definido como Success with Warning. Isso alerta o usuário a verificar avisos nas mensagens de log.

• Sucesso com Erro Infantil: Se o agente concluir a execução bem-sucedida de uma operação, mas dentro de uma ou mais operações filhas, ocorrer um erro fatal ao gravar no sistema de destino, ou houver um erro fatal de validação na transformação, ou a lógica de transformação acionar a função RaiseError, então o status da operação é definido como Sucesso com Erro Infantil. Este status não se aplica a operações assíncronas.

• Status Atrasado: Se o agente não retornar um log de operação 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. Você não pode filtrar operações com Status Atrasado, mas pode vê-las nos logs de operação.

Status da etapa da operação

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

As etapas da operação podem ter os seguintes status possíveis:

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

Visualização do log da operação

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

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

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

Painel de lista de operações

Quando você abre a visualização do log de operações, o primeiro log de operação na lista é selecionado por padrão. As informações detalhadas do log para esta operação aparecem no painel à direita.

• Nome: O nome da operação ou etapa da operação. Os caret, que podem ser usados para expandir ou colapsar 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: Quando você expande 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 estão expandidas. Use os ícones colapsar lista ou expandir lista ao lado da coluna Nome para colapsar ou expandir todas as operações pai.

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

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

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

• Duração: O tempo decorrido entre Iniciado e Finalizado, reportado em segundos para operações e em milissegundos para etapas da operação.

• Status: O status da operação ou etapa da operação. Para uma lista completa de possíveis status, consulte Status da operação mais acima 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 Executando.

    Cancelar operação envia uma solicitação ao agente para parar a operação. Uma vez clicado, o status Cancelamento Solicitado é exibido ao lado do status da operação em tempo real.

    Nota

    Operações que têm o status Cancelamento Solicitado ainda podem ser executadas.

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

• Ver Preferências: 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 reorganizar as colunas ou ajustar sua visibilidade no painel da lista de operações:

  

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

  • Mover: Arraste e solte para mudar 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 de Redimensionar de uma coluna para redimensioná-la.

Painel de log de operações

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

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

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

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

• Finalizado: A data e hora em que a operação ou etapa da operação parou de ser executada, exibida como o horário local do navegador.

• Duração: O tempo decorrido entre Iniciado e Finalizado, reportado em segundos para operações e em milissegundos para etapas de operação.

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

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

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

  Nota

  • Datas e horas nas mensagens de log aparecem em seu formato original da fonte e não são convertidas para o horário local do navegador.
  • Mensagens de log que excedem ~100 KB de tamanho (~99.000 caracteres) são truncadas, com mensagem truncada aparecendo no final do log.

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

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

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

Dados de entrada e saída do componente

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

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

Você pode clicar nas etapas da 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.

• Buscar: Pesquise 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 como um arquivo no formato de dados apropriado. O arquivo é nomeado com o nome da etapa da operação seguido de _input ou _output, conforme apropriado.

Dados da solicitação da API

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

Informações da API

O log da 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 Gerenciador de API.

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

  • CUSTOM_API: Uma API personalizada criada no Gerenciador de API.
  • ODATA: Uma API OData criada no Gerenciador de API.

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

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

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

• Gateway da API: O gateway da API que processou a solicitação. Este campo mostra o nome de domínio do gateway de API em nuvem ou do gateway de API privado que lidou com a chamada da API.

• URL do serviço da 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 da API completa conforme consumida pelo cliente.

• Aplicativo de origem: O aplicativo ou navegador que fez a solicitação da API.

Informações da chamada

O log da operação exibe uma seção Informações da chamada com os cabeçalhos de solicitação HTTP enviados com a chamada da 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.

Registro de chamadas

O registro de operações também exibe uma seção de Registro de chamadas com informações detalhadas sobre o processamento de solicitações da API. Esta seção é particularmente útil para solucionar problemas de gateway da API, problemas de tempo limite ou para entender o fluxo de processamento interno da API. O conteúdo específico do registro de chamadas varia dependendo da configuração da API, das configurações do gateway e se ocorreram problemas durante o processamento da solicitação.