Ir para o conteúdo

Página Runtime no Jitterbit Management Console

Visão geral

Propósito Visualizar logs de operações em tempo de execução
Localização Menu do portal Harmony > Management Console > Runtime
Acesso à página Usuários com permissão de função Leitura role permission
Acesso ao ambiente Usuários com níveis de acesso ao ambiente Ver Logs environment access levels

Introdução

A página Runtime é uma tabela de logs de operações. 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, o número de registros de origem e destino processados, além de quaisquer mensagens de log. A exibição de mensagens de log detalhadas depende dos níveis de permissão e acesso, bem como se o log na nuvem está ativado.

Página Runtime

Nota

O Harmony mantém logs de operações por 30 dias.

Importante

Operações disparadas por uma API personalizada ou OData API do API Manager possuem logs adicionais que podem ser ativados. Para mais detalhes, consulte Dados de solicitação e resposta da API.

Valores de status

Para entradas de log de API Personalizada, API Proxy e OData API, o status é exibido como o código de status HTTP (consulte definições de código de status em w3.org). Para entradas de log de Operação, o status é um dos seguintes:

Ícone Status Descrição Observações
Enviado Uma operação foi enviada para a fila do Harmony, mas ainda não foi aceita por um agente para execução. Operações podem ser enviadas por um agendamento de operação, execução manual, a função RunOperation ou qualquer ferramenta (incluindo JitterbitUtils) que chame uma API do API Manager.
Recebido Um agente reconhece o recebimento da solicitação para executar uma operação. —
Pendente Uma operação está enfileirada para execução em um agente. —
Executando Um agente está executando a operação. —
Cancelamento Solicitado Uma solicitação para cancelar a operação foi feita. Operações podem exibir este status e continuar sendo executadas após o cancelamento. Você também pode solicitar um cancelamento a partir do Design canvas de uma operação, da visualização de log de operação do Studio ou usando as funções GetOperationQueue e CancelOperation.
Cancelado A operação foi cancelada. —
Sucesso A operação foi concluída com sucesso. —
Sucesso com Informações A operação foi concluída com sucesso com problemas não fatais. —
Sucesso com Aviso A operação foi concluída com sucesso com avisos conforme mostrado nas mensagens de log. Um aviso extra subelement nas mensagens de log pode geralmente ser ignorado. Este aviso indica que o payload da API de um conector retornou mais nós ou campos de dados do que aqueles definidos no esquema de dados de resposta.
Sucesso com Erro Secundário A operação foi concluída com sucesso, mas uma ou mais operações secundárias sofreram erros fatais. Aplica-se apenas a operações síncronas.
Erro A operação falhou. As possíveis causas incluem um erro fatal ao escrever no sistema de destino, um erro de validação fatal na transformação ou a lógica de transformação disparando a função RaiseError.
Soap Fault A operação falhou com um SOAP fault. Aplica-se a operações usando o SOAP, Salesforce, Salesforce Service Cloud, ServiceMax ou Workday do Studio ou o endpoint de serviços web ou Salesforce do Design Studio.
— Status Atrasado O Harmony não conseguiu buscar o log de operação do agente. O Harmony tenta novamente até seis vezes, com um tempo limite de 10 segundos entre as tentativas. Atualize ou verifique novamente mais tarde. Você não pode filtrar por este status, mas entradas de log atrasadas ainda podem aparecer nos resultados.

Controles da página Runtime

A barra de ferramentas da página Runtime inclui controles para pesquisar, filtrar, baixar e atualizar os dados de log.

Barra de pesquisa

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 <key><operator><value>. Para as chaves operation, project, environment, agent, status e apiServiceUrl, os valores podem incluir um caractere curinga (% ou *) para corresponder a qualquer string. A correspondência com curinga é ancorada ao início do valor, portanto apenas pesquisas que começam com (prefixo) retornam resultados: use value% ou value* para corresponder a valores que começam com o texto. Um curinga no início não amplia a correspondência: %value% e *value* são ambos tratados como value% (começa com), portanto pesquisar por texto que aparece apenas no meio ou no final de um valor não retorna mais resultados. Um curinga dentro do valor (por exemplo, abc%d ou abc*d) continua correspondendo. A chave logType também aceita curingas, mas apenas no meio ou no final do valor (por exemplo, Oper% ou Op%on).

Nota

Para resultados precisos ao usar o operador diferente de (!=), desabilite o toggle Execution tree view.

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

Barra de pesquisa

Quando o toggle Execution tree view está habilitado, uma consulta retorna resultados para a cadeia de execução completa de qualquer entrada correspondente: para uma consulta de chave operation, os resultados incluem a hierarquia completa de operações pai e filho vinculadas à operação, bem como a entrada de log da API pai se a operação foi acionada por uma chamada de API. A string de palavra-chave é destacada em azul nos resultados. Quando o toggle Execution tree view está desabilitado, apenas as entradas que correspondem diretamente à consulta são retornadas.

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

Chave Coluna da chave Operadores
permitidos
Valor Observações
operation Operation =, != Nome da operação
project Project =, != Nome do projeto
environment Environment =, != Nome do ambiente
agent Agent =, != Nome do agente
status Status =, != Nome do status ou código de status HTTP Para entradas de log Operation, o nome do status mostrado na coluna Status da tabela de detalhes da operação. Para entradas de log Custom API, Proxy API e OData API, um código de status HTTP de 100 a 599. Um valor que não corresponde a nenhum dos dois formatos retorna um erro de validação.
logType Log Type =, != Nome do tipo de log Um de Operation, Custom API, Proxy API ou OData API, correspondendo aos valores mostrados na coluna Log Type.
started Started <= Data/hora Data/hora: formato de data month/day/year, com hora opcional hour:minute:second em formato AM/PM. Apenas data: MM/DD/YYYY. Data e hora (AM): MM/DD/YYYY HH:MM:SS AM. Data e hora (PM): MM/DD/YYYY HH:MM:SS PM.
>=
finished Finished <= Data/hora
>=
rootOperationInstanceGuid Root Operation Instance GUID = GUID da operação raiz
apiServiceUrl API Service URL =, != URL do serviço de API A URL completa do serviço de API para entradas acionadas por uma chamada de API. Insira a URL completa, incluindo o esquema https://.

Exemplos de consulta

A seguir estão exemplos de termos de consulta:

Termo de consulta Descrição
operation=New Delete; Mostra a operação "New Delete".
operation=New%; Mostra logs de operação para operações com nomes que começam com "New".
operation!=New%; Mostra logs de operação para operações com nomes que não começam com "New".
project=SFDC-SAP; Mostra logs de operação para operações no projeto "SFDC-SAP".
project=SFDC%; Mostra logs de operação para operações em qualquer projeto com nomes que começam com "SFDC".
project!=SFDC-SAP; Mostra logs de operação para operações que não estão no projeto "SFDC-SAP".
environment=DEnv; Mostra logs de operação para operações implantadas no ambiente "DEnv".
environment=DE%; Mostra logs de operação para operações implantadas em ambientes com nomes que começam com "DE".
environment!=DEnv; Mostra logs de operação para operações não implantadas no ambiente "DEnv".
agent=Windows%; Mostra logs de operação para operações executadas em agentes com nomes que começam com "Windows".
agent!=Windows%; Mostra logs de operação para operações executadas em agentes com nomes que não começam com "Windows".
status=success; Mostra logs de operação para operações com status "SUCCESS".
status!=success; Mostra logs de operação para operações com status diferente de "SUCCESS".
status=200; Mostra entradas de log de API com código de status HTTP 200.
status!=200; Mostra entradas de log de API com código de status HTTP diferente de 200.
logType=Operation; Mostra entradas de log com tipo de log "Operation".
logType!=Operation; Mostra entradas de log com tipo de log diferente de "Operation".
logType=Oper%; Mostra entradas de log com tipo de log que começa com "Oper".
started>=9/12/2024; Mostra logs de operação para operações iniciadas em ou após 9/12/2024.
started>=9/12/2024 11:59:00 AM; Mostra logs de operação para operações iniciadas em ou após 11:59 da manhã de 9/12/2024.
finished<=10/04/2024; Mostra logs de operação para operações com última atividade em ou antes de 10/04/2024.
finished>=10/04/2024 01:00:00 PM; Mostra logs de operação para operações com última atividade em ou após 10/04/2024 às 13h.
message=1201 alarm; Mostra logs de operação para operações que contêm a string de mensagem "1201 alarm".
rootOperationInstanceGuid=0f04b6f6-4129-45dd-8388-abd19fe6a4f7; Mostra logs de operação para operações que são filhas da operação raiz com o GUID mostrado.
apiServiceUrl=https://acme2.jitterbit.net/defaultUrlPrefix%; Mostra entradas de log para chamadas de API cuja URL do serviço de API começa com "https://acme2.jitterbit.net/defaultUrlPrefix".
apiServiceUrl=https://acme2.jitterbit.net/defaultUrlPrefix/v1/customers; Mostra entradas de log para a chamada de API com a URL exata do serviço de API mostrada.

Nota

As datas são especificadas e exibidas no fuso horário do seu navegador.

Consultas salvas

É possível salvar consultas para usá-las, editá-las ou excluí-las da seguinte forma:

  • Para salvar uma consulta, clique em Salvar consulta. O formulário de consulta é aberto:

    Formulário de consulta

    Insira ou selecione valores para os seguintes campos e clique em Salvar:

    • Nome: um nome para a consulta.
    • Consulta: um ou mais termos de consulta usando a mesma sintaxe da barra de pesquisa. É possível adicionar termos das seguintes maneiras:
      • Clique no campo para exibir uma lista de termos de pesquisa disponíveis. Selecione um para inseri-lo no campo de consulta e adicione um operador e um valor.
      • Selecione uma das sugestões de consulta.
      • Insira um termo de consulta seguido por um ponto-e-vírgula.
    • Colunas: selecione as colunas a exibir nos resultados da pesquisa.

      Formulário de consulta

    Após salva, o formulário Consultas salvas é aberto:

    Salvar consultas

    Clique em Consultas salvas para fechá-lo.

  • Para usar uma consulta salva, clique em Consultas salvas e clique na consulta que deseja executar. Os termos da consulta são copiados para a barra de consulta e a consulta é executada automaticamente.

  • Para editar uma consulta salva, clique em Consultas salvas, clique no ícone Editar da consulta que deseja editar. A consulta é aberta na gaveta Editar consulta:

    Editar consulta

    Edite a consulta e clique em Salvar para salvá-la ou Cancelar para cancelar.

  • Para excluir uma consulta salva, clique em Consultas salvas e clique no ícone Excluir daquela que deseja excluir. Um diálogo Excluir Consulta Salva solicita confirmação. Clique em Excluir para continuar ou Cancelar para cancelar.

Seletor de período de tempo

A página Runtime retorna registros dentro do período definido no campo de intervalo de tempo, que filtra registros pelo horário Iniciado:

seletor de período de tempo

Clique no campo de intervalo de tempo para abrir um diálogo com duas abas: Relativo e Absoluto.

Aba Relativo

A aba Relativo fornece intervalos de tempo predefinidos e um seletor de período de tempo relativo personalizado:

Aba Relativo

Selecione um dos intervalos de tempo predefinidos:

  • Última 1 hora: exibe os logs de operações da última hora.

  • Últimas 24 horas: (padrão) Exibe os logs de operações das últimas 24 horas.

  • Últimos 7 dias: exibe os logs de operações dos últimos 7 dias.

  • Últimos 30 dias: exibe os logs de operações dos últimos 30 dias.

Para criar um período de tempo relativo personalizado, use os controles na parte inferior do diálogo:

  • Campo de número: insira o número de unidades de tempo (por exemplo, 1, 7, 30).

  • Dropdown de unidade: selecione a unidade de tempo em Minutos, Horas, Dias, Semanas ou Meses.

  • Cancelar: fecha o diálogo sem aplicar alterações.

  • Aplicar: aplica o intervalo de tempo selecionado e fecha o diálogo.

Aba Absoluto

A aba Absoluto permite selecionar um intervalo de data e hora específico dentro dos últimos 30 dias. Datas fora desse intervalo não podem ser selecionadas:

Aba Absoluto

Configure o intervalo de data e hora usando os seguintes controles:

  • Campo de hora de início: exibe a hora de início do intervalo. Clique em para limpar ou clique em para ajustar a hora.

  • Campo de hora de término: exibe a hora de término do intervalo. Clique em para limpar ou clique em para ajustar a hora.

  • Seletor de calendário: use o calendário para selecionar datas de início e término. Navegue entre meses usando as setas simples ou entre anos usando as setas duplas.

  • Cancelar: Fechar o diálogo sem aplicar as alterações.

  • Aplicar: Aplicar o intervalo de data e hora selecionado e fechar o diálogo.

Controles adicionais de período de tempo

Aplicar um intervalo de tempo define um termo de consulta Iniciado correspondente na barra de pesquisa (por exemplo, started>=10/01/2026 12:00:00 AM;started<=10/06/2026 03:00:00 PM;). Você ainda pode filtrar por tempo Concluído independentemente inserindo um termo de consulta finished diretamente na barra de pesquisa.

  • Clique em ao lado do campo de intervalo de tempo para redefini-lo para o padrão Últimas 24 horas. Isso não remove a condição Iniciado já aplicada na barra de pesquisa; para remover um filtro de tempo aplicado, clique em na barra de pesquisa.

  • Clique no ícone de calendário ao lado do campo de intervalo de tempo para reabrir o diálogo.

O intervalo de tempo selecionado é retido ao alternar entre os layouts de tabela e cartão dos resultados.

Baixar como CSV

Clique em Baixar como CSV para abrir o diálogo Baixar logs. A exportação tem as seguintes características:

  • Escopo: A exportação usa a consulta de pesquisa aplicada, filtros e intervalo de tempo, refletindo todas as entradas de log correspondentes. Isso é equivalente ao conjunto completo de resultados mostrado em todas as páginas da tabela.
  • Hierarquia: A exportação preserva a hierarquia pai-filho das cadeias de operações, mantendo as entradas relacionadas contíguas.
  • Ordem: Os registros são ordenados por tempo Iniciado do pai (decrescente), com registros filho ordenados pela sequência de execução (crescente).
  • Fuso horário: Os timestamps Iniciado e Concluído usam o fuso horário local do seu navegador.
  • Empacotamento: Quando a exportação abrange vários arquivos, todos os arquivos são empacotados em um único arquivo ZIP para download.

O diálogo contém a seguinte opção:

  • Incluir mensagens: Selecione para incluir mensagens de log completas na exportação. Esta opção fica desmarcada por padrão. Incluir mensagens pode aumentar significativamente o tamanho do arquivo e o tempo de geração.

Clique em Baixar para iniciar a exportação ou Cancelar para descartar.

Atualizar

A tabela é atualizada automaticamente. Para alterar o intervalo de atualização automática, clique em Configurações. O painel Configurações é aberto:

Settings

Selecione um intervalo de atualização automática, um dos Nunca (padrão), 1 minuto, 5 minutos, 15 minutos ou 30 minutos e clique no botão Salvar.

Para atualizar a tabela a qualquer momento, clique em Atualizar.

Filtrar colunas

Para alterar a disposição e visibilidade das colunas, clique em Filtrar Colunas. O painel Colunas é aberto:

Filter columns

O painel tem os seguintes controles:

  • Mostrar Todos: Tornar todas as colunas visíveis.
  • Mover: Arrastar e soltar 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.
  • Salvar: Salvar as colunas.
  • Cancelar: Fechar o painel de colunas sem salvar as alterações.

Tabela de detalhes da operação

Para classificar a tabela por coluna, clique no título da coluna; clique novamente para inverter a ordem. As colunas disponíveis são as seguintes:

  • Nome: O nome da API ou operação associada à entrada de log. Para entradas de operação com filhos, clique no ícone Expandir para revelar a cadeia inteira. Clique no ícone Minimizar para recolher uma operação e seus filhos. (Aplicável a todos os tipos de log.)

  • Tipo de Log: O tipo de entrada de log: Custom API, Proxy API ou OData API para operações acionadas por uma chamada de API, ou Operação para operações executadas diretamente. (Aplicável a todos os tipos de log.)

  • Ambiente: O nome do ambiente no qual a operação foi implantada. (Aplicável a todos os tipos de log.)

  • Status: O status da entrada de log. Consulte Status values.

  • Started: A hora em que a execução da operação foi solicitada. (Aplica-se a todos os tipos de log.)

  • Finished: A hora em que o status da operação foi alterado pela última vez. (Aplica-se a todos os tipos de log.)

  • Duration: O tempo decorrido entre Started e Finished. (Aplica-se a todos os tipos de log.)

  • ID: O identificador único da entrada de log. (Aplica-se a todos os tipos de log.)

  • API Service URL: A URL completa para chamar a API, incluindo a URL base, raiz do serviço, versão e qualquer parâmetro de caminho. Esta coluna é preenchida apenas para entradas de log Custom API, Proxy API e OData API.

  • Agent: O nome do agent. Esta coluna é preenchida apenas para entradas de log Operation.

  • Project: O nome do projeto em que a operação está em execução. Esta coluna é preenchida apenas para entradas de log Operation.

  • Root Operation Instance GUID: O identificador global exclusivo (GUID) da operação raiz (de nível superior) da operação. Este campo fica vazio para operações raiz e a coluna fica oculta por padrão. Esta coluna é preenchida apenas para entradas de log Operation. Para copiar o valor, passe o mouse sobre ele e clique em Copy content.

  • Operation ID: O identificador global exclusivo (GUID) da operação. Esta coluna é preenchida apenas para entradas de log Operation. (Esta coluna fica oculta por padrão.)

  • Actions: Passe o mouse sobre uma operação para revelar as ações disponíveis. As ações variam conforme o tipo de log:

    Para entradas de log Custom API, Proxy API e OData API:

    Para entradas de log Operation:

    • View: Abre os detalhes do log.
    • Cancel operation: Habilitado para operações com status Submitted, Received, Pending ou Running. Cancel operation envia uma solicitação ao agent para interromper a operação. Após clicar, o status Cancel Requested é exibido ao lado do status da operação em tempo real.

      Nota

      O envio de uma solicitação de cancelamento não garante que a operação será cancelada. Operações com status Cancel Requested ainda podem ser executadas, dependendo do estado de execução atual do agent.

    • Go to operation: Abre o projeto no Studio e seleciona a operação. Esta ação está disponível apenas para operações do Studio, não para operações do Design Studio.

Quando há mais de 100 operações, elas são divididas em páginas de aproximadamente 100 cada. Para manter as cadeias de operações vinculadas intactas, todas as operações filhas do último pai mostrado em uma página são incluídas nessa página, mesmo que o total exceda 100. Você pode navegar pelas páginas usando estes botões de navegação na parte inferior da tabela:

  • Previous Page: Vai para a página anterior.
  • Next Page: Vai para a próxima página.

Log entry details

Para ver os detalhes de uma entrada de log, selecione uma na tabela. A gaveta Messages and Logs abre na parte inferior da janela com as seguintes abas, dependendo do tipo de log:

Messages tab

O conteúdo da aba Messages varia dependendo do tipo de log da entrada selecionada.

API log entries

Quando uma entrada de log Custom API, Proxy API ou OData API é selecionada, a aba Messages exibe detalhes sobre a chamada de API nas seguintes seções recolhíveis: API information, Call information, Call log e API Payload (quando habilitado).

Informações da API

A seção Informações da API exibe os seguintes detalhes:

  • API: O nome da API que acionou a operação. Clique em para abrir a configuração da API em uma nova aba no API Manager.

  • Versão: O número da versão da API.

  • Tipo de API: O tipo de API, um dos seguintes:

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

  • ID da requisição da API: Um identificador único para a requisição da API. Use esse ID para correlacionar logs em diferentes sistemas e para pesquisar requisições específicas. Clique em para copiar o valor.

  • IP de Origem: O endereço IP da aplicação cliente ou servidor que fez a requisição da 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 em nuvem ou gateway de API privado que tratou a chamada da 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 da API.

Informações da Chamada

A seção Informações da Chamada exibe os cabeçalhos de requisição HTTP enviados com a chamada da API sob um rótulo Cabeçalhos de Requisição. 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

A seção Log de Chamada exibe as mensagens de log de nível do sistema geradas durante o processamento da requisição da API. Clique em para copiar o log para sua área de transferência.

Payload da API

A seção Payload da API exibe os dados de payload de requisição e resposta para a chamada da API. Esta seção fica visível quando uma ou ambas as opções a seguir estão habilitadas na aba Configurações da API: Ativar modo debug até ou Mostrar Payloads de Requisição e Resposta nos Logs.

A seção é dividida em dois painéis:

  • Corpo da Requisição: O payload enviado com a requisição da API.

  • Corpo da Resposta: O payload retornado pela API. Se o payload de resposta exceder o limite de exibição, ele é exibido com um rótulo (Truncado).

Cada painel fornece os seguintes controles:

  • Pesquisar: Pesquise o payload por uma sequência específica.

  • Copiar: Copie o payload para sua área de transferência.

  • Baixar: Baixe o payload como um arquivo.

Entradas de log de operação

Aba Mensagens

Quando uma entrada de log de Operação é selecionada, a aba Mensagens exibe o seguinte:

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

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

  • Mensagem: Detalhes do log incluindo qualquer um dos seguintes:

    • Mensagens geradas pelo sistema indicando que a operação foi concluída sem erros.
    • Mensagens de informação e aviso retornadas pelos sistemas de origem ou destino.
    • Avisos de validação retornados pelos serviços de transformação, validação e scripts do Jitterbit.
    • Mensagens definidas pelo usuário geradas pela ferramenta Invoke Operation (quando Raise error if operation fails está habilitado) ou pela função WriteToOperationLog().

    As mensagens de log são exibidas como blocos individuais rotulados por tipo de mensagem (por exemplo, Mensagem, Erro ou Erro fatal ao processar operação). Cada bloco fornece para copiar ou para baixar seu conteúdo.

    Nota

    • 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.
    • Mensagens de log que excedem ~100 KB de tamanho (~99.000 caracteres) são truncadas, indicadas com message truncated aparecendo no final do log.
  • Mensagens registradas em scripts de pré-transformação: Mensagens geradas durante a execução de scripts de pré-transformação. Clique em para copiar ou para baixar.

Para visualizar as mensagens de log de uma operação na aba Messages, o seguinte deve ser verdadeiro:

  • Você deve ser membro de uma função com no mínimo permissão de organização Read e acesso ao ambiente View Logs.
  • O log em nuvem está habilitado no grupo de agentes privados. (O log em nuvem está sempre habilitado em grupos de agentes em nuvem.) Quando desabilitado, e se sua configuração de rede permite conectar diretamente ao host do agente, as mensagens de log podem ser visualizadas com segurança clicando no link View log messages from Agent.

Aba Activity Logs

Activity logs tab

Esta aba contém links para arquivos de sucesso ou falha criados pelas atividades Salesforce, Salesforce Service Cloud ou ServiceMax executadas em um agente privado.

Os arquivos estão em formato CSV. Para baixar um, clique em seu link.

Os arquivos de log de atividade são automaticamente deletados após 14 dias pelo serviço de limpeza de arquivos do agente privado. Você pode alterar esse comportamento na seção [ResultFiles] do arquivo jitterbit.conf do agente privado, ou alterando as regras de serviço de limpeza de arquivos.

Os downloads de log de atividade estão desabilitados para agentes em nuvem. Você pode ver links de download para logs de atividade de agentes em nuvem, mas tentar baixar logs gera uma mensagem de erro.

Aba Debug Files

Debug files tab

Quando o log de depuração está habilitado para agentes privados, esta aba contém um link para baixar arquivos de log de depuração de operação. Os arquivos de depuração são removidos após 1 dia por padrão, ou conforme configurado nas regras de limpeza de um agente privado.

Nota

Esta aba não é exibida para operações que executam em agentes em nuvem.

Aba Debug Logging

Quando o log de depuração está 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, esta aba exibe os detalhes da hierarquia de execução completa de uma operação do Studio. A visualização de log de operação exibe uma visualização dividida com logs de operação no painel esquerdo e informações de log detalhadas para a operação selecionada no painel direito. A visualização usa os controles de tabela selecionados para filtrar resultados. Se as operações estão encadeadas com ações de operação ou a função RunOperation, essas operações são listadas sob a operação pai.

Quando o registro de debug de operação está ativado, essa aba também pode exibir dados de entrada e saída do componente e dados de solicitação e resposta de API (quando a operação é acionada por uma API do API Manager). A carga da solicitação e resposta é incluída apenas quando a opção Show Request & Response Payloads in Logs também está ativada na aba Settings da API.

As operações pai (e quaisquer operações filho abaixo delas) são classificadas em ordem crescente por Started. A tabela pode ser classificada (apenas para operações de nível superior) por Name, Started, Finished, Duration ou Status clicando na respectiva linha do cabeçalho.

Debug Logging tab

Ao abrir a visualização do registro de operação, o primeiro registro de operação da lista é selecionado por padrão. As informações detalhadas do registro dessa operação aparecem no painel à direita.

  • Name: O nome da operação ou etapa de operação. Os circunflexos , que podem ser usados para expandir ou recolher linhas adicionais, são mostrados nas operações pai e nas operações para as quais os dados de entrada e saída do componente estão disponíveis:

    • Operações pai: Quando uma operação pai é expandida, linhas adicionais para suas operações filho 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 para recolher ou expandir todas as operações pai.
  • Started: 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.

  • Finished: 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.

  • Duration: O tempo decorrido entre Started e Finished, informado em segundos para operações e em milissegundos para etapas de operação.

  • Status: O status da operação ou etapa de operação. Para uma entrada de registro, consulte Status values. Para uma etapa de operação, este é um dos seguintes:

    • Complete: A etapa de operação foi executada e concluída sem erros.
    • Error: A etapa de operação foi executada, mas não pôde ser concluída devido a um erro.
    • Incomplete: A etapa de operação não foi executada ou concluída. As possíveis razões para esse status incluem que a etapa de operação está aguardando execução ou que houve um erro em uma etapa de operação anterior impedindo que a etapa seguinte fosse executada.
  • Actions: Essas ações não estão disponíveis para etapas de operação e diferem por tipo de linha:

    • Linhas de entrada de registro de API: Essa ação está disponível em linhas para a entrada de registro de API que acionou a operação.

      • Go to API: Abre a página de detalhes da API correspondente no API Manager, com seu painel aberto automaticamente.
    • Linhas de operação: Essas ações estão disponíveis em linhas para a operação em si, incluindo quaisquer operações filho encadeadas.

      • Cancel operation: Habilitada para operações com status Submitted, Received, Pending ou Running. Cancel operation envia uma solicitação ao agente para parar a operação. Após clicar, o status Cancel Requested é 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. As operações que têm um status Cancel Requested podem ainda ser executadas, dependendo do estado de execução atual do agente.

      • Go to operation: Abre o projeto no Studio e seleciona a operação.

  • Refresh: Clique para atualizar a lista de registros de operação.

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

filter columns

  • 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.

  • Log de operação: Para mostrar ou ocultar um log de uma operação individual, clique em uma operação na lista.

    • 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 das permissões e níveis de acesso do usuário atual e se o log em nuvem está ativado. Para mais informações, consulte Guia Mensagens anteriormente nesta página.

      Nota

      As datas e horas exibidas nas próprias mensagens de log não são convertidas para a hora local do navegador, mas são relatadas em seu formato original da origem da mensagem de log.

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

    • Download: Faz download das mensagens de log como um arquivo de texto.
    • Mostrar / ocultar: Mostra ou oculta as mensagens de log.

Dados de entrada e saída de componentes

Os dados de entrada e saída de componentes são gerados quando uma operação tem o log de debug de operação ativado no nível da 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.

Nota

A geração de dados de entrada e saída de componentes não é afetada pela configuração de grupo de agentes Log em nuvem ativado. Os dados de entrada e saída de componentes serão registrados na nuvem Harmony mesmo se o log em nuvem estiver desativado.

Para desativar a geração de dados de entrada e saída de componentes em um grupo de agentes privados, no arquivo de configuração do agente privado na seção [VerboseLogging], configure verbose.logging.enable=false.

Aviso

Quando os dados de entrada e saída de componentes são gerados, todos os dados de solicitação e resposta dessa 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 sensíveis, como credenciais fornecidas em um payload de solicitação, estarão visíveis em texto simples nos dados de entrada e saída nos logs da nuvem Harmony.

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.

Ícones de atividades e transformações usadas como etapas de operação são exibidos. Você pode clicar em uma etapa de operação para mostrar ou ocultar os dados de entrada e saída de componentes dessa etapa de operação individual. Cada entrada de log de entrada ou 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.

log table operation steps header

  • Pesquisar: Pesquisa os dados pelo texto inserido.
  • Copiar: Copia os dados de log para a área de transferência.
  • Download: Faz download dos 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 de API

Nova interface de usuário obrigatória

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

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 Enable debug mode until (uma configuração do API Manager) ou Operation debug logging (uma configuração do agente) está ativa. indica que a configuração adiciona essa capacidade; indica que não adiciona:

Configurações habilitadas Execuções bem-sucedidas nos logs de operação do Studio Dados brutos de solicitação/resposta no log de chamadas Cargas de solicitação/resposta
Nenhuma (padrão)
Verbose logging (configurações de API personalizada, API OData ou API de proxy)
Enable debug mode until (configurações de API personalizada, API OData ou API de proxy)
Operation debug logging (agentes na nuvem ou agentes privados)

Nota

Para capturar todos os três tipos de dados simultaneamente, use Enable debug mode until ou combine Operation debug logging com Show Request & Response Payloads in Logs e Verbose logging.

api information

Informações de API

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

api information

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

  • Método de solicitaçã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 solicitação de API: Um identificador único para a solicitação de API. Você pode usar este ID para correlacionar logs em diferentes sistemas e para procurar solicitações específicas. Clique no ícone de cópia para copiar o valor.

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

  • Gateway de API: O gateway de API que processou a solicitaçã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 consumida pelo cliente.

  • Aplicação de origem: O aplicativo ou navegador que fez a solicitaçã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 solicitação HTTP enviados com a chamada de API. Cada cabeçalho é exibido como um par de 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 chamadas

O log de operações também exibe uma seção de Log de chamadas com informações detalhadas de rastreamento sobre o processamento da solicitação da API. Essas informações podem ser usadas para solucionar problemas do 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 chamadas varia dependendo da configuração da API, das configurações do gateway e se houve algum problema durante o processamento da solicitação.