Página Runtime no Jitterbit Management Console
Visão geral
| Objetivo | Visualizar logs de operação 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 |
| Acesso ao ambiente | Usuários com níveis de acesso ao ambiente Visualizar Logs |
Introdução
A página Runtime é uma tabela de logs de operaçã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, o número de registros de origem e destino processados, além de 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 em nuvem está ativado.
Nota
O Harmony mantém logs de operação por 30 dias.
Importante
Operações acionadas por uma API personalizada ou API OData do API Manager possuem logs adicionais que podem ser ativados. Para detalhes, consulte Dados de solicitação e resposta da API.
Valores de status
Para entradas de log de API Personalizada, API Proxy e API OData, 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 confirma o recebimento da solicitação para executar uma operação. | — | |
| Pendente | Uma operação está na fila para ser executada em um agente. | — | |
| Em execução | 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 em execução após o cancelamento. | Você também pode solicitar um cancelamento a partir da tela de Design 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 de subelemento extra nas mensagens de log geralmente pode ser ignorado. Este aviso indica que a carga útil 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 filho | A operação foi concluída com sucesso, mas uma ou mais operações filhas 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 acionando a função RaiseError. |
|
| Falha SOAP | A operação falhou com uma falha SOAP. | Aplica-se a operações usando o conector 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. Não é possível 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 consiste em um ou mais termos de chave/valor. Múltiplos termos são separados por ponto-e-vírgula. Um termo tem a forma <chave><operador><valor>. 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 valor% ou valor* para corresponder a valores que começam com o texto. Um curinga no início não amplia a correspondência: %valor% e *valor* são ambos tratados como valor% (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.
Nota
Para obter resultados precisos ao usar o operador não-igual (!=), desative o botão de alternância Exibição em árvore de execução.
Para usar uma consulta, insira uma especificação de consulta válida na barra de pesquisa e pressione Enter:

Quando o botão de alternância Exibição em árvore de execução está ativado, 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 botão de alternância Exibição em árvore de execução está desativado, 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 de chave | Operadores permitidos |
Valor | Notas |
|---|---|---|---|---|
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 de Operation, o nome do status mostrado na coluna Status da tabela de detalhes da operação. Para entradas de log de 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. |
started |
Started | <= |
Data/hora | Data/hora: formato de data mês/dia/ano, com hora opcional hora:minuto:segundo 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; |
Exibe a operação "New Delete". |
operation=New%; |
Exibe logs de operação para operações com nomes que começam com "New". |
operation!=New%; |
Exibe logs de operação para operações com nomes que não começam com "New". |
project=SFDC-SAP; |
Exibe logs de operação para operações no projeto "SFDC-SAP". |
project=SFDC%; |
Exibe logs de operação para operações em qualquer projeto com nomes que começam com "SFDC". |
project!=SFDC-SAP; |
Exibe logs de operação para operações que não estão no projeto "SFDC-SAP". |
environment=DEnv; |
Exibe logs de operação para operações implantadas no ambiente "DEnv". |
environment=DE%; |
Exibe logs de operação para operações implantadas em ambientes com nomes que começam com "DE". |
environment!=DEnv; |
Exibe logs de operação para operações não implantadas no ambiente "DEnv". |
agent=Windows%; |
Exibe logs de operação para operações em execução em agentes com nomes que começam com "Windows". |
agent!=Windows%; |
Exibe logs de operação para operações em execução em agentes com nomes que não começam com "Windows". |
status=success; |
Exibe logs de operação para operações com status "SUCCESS". |
status!=success; |
Exibe logs de operação para operações com status diferente de "SUCCESS". |
status=200; |
Exibe entradas de log de API com código de status HTTP 200. |
status!=200; |
Exibe entradas de log de API com código de status HTTP diferente de 200. |
started>=9/12/2024; |
Exibe logs de operação para operações iniciadas em ou após 9/12/2024. |
started>=9/12/2024 11:59:00 AM; |
Exibe logs de operação para operações iniciadas em ou após 11:59 da manhã de 9/12/2024. |
finished<=10/04/2024; |
Exibe logs de operação para operações ativas pela última vez em ou antes de 10/04/2024. |
finished>=10/04/2024 01:00:00 PM; |
Exibe logs de operação para operações ativas pela última vez em ou após 10/04/2024 às 13h. |
message=1201 alarm; |
Exibe logs de operação para operações contendo a string de mensagem "1201 alarm". |
rootOperationInstanceGuid=0f04b6f6-4129-45dd-8388-abd19fe6a4f7; |
Exibe 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%; |
Exibe entradas de log para chamadas de API cuja URL de serviço de API começa com "https://acme2.jitterbit.net/defaultUrlPrefix". |
apiServiceUrl=https://acme2.jitterbit.net/defaultUrlPrefix/v1/customers; |
Exibe entradas de log para a chamada de API com a URL de serviço de API exata 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:

Insira ou selecione valores para os campos a seguir 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 formas:
- 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 de ponto e vírgula.
-
Colunas: selecione as colunas a exibir nos resultados da pesquisa.

Quando salva, o formulário Consultas salvas é aberto:

Clique em Consultas salvas para fechá-lo.
-
Para usar uma consulta salva, clique em Consultas salvas e depois 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:

Edite a consulta e clique em Salvar para salvá-la ou em Cancelar para cancelar.
-
Para excluir uma consulta salva, clique em Consultas salvas e depois clique no ícone Excluir da que deseja excluir. Uma caixa de diálogo Excluir Consulta Salva solicita confirmação. Clique em Excluir para continuar ou em Cancelar para cancelar.
Intervalo de tempo
A página Runtime retorna o período de tempo mostrado no menu de intervalo de tempo:

Para alterar o período, abra o menu e selecione uma das seguintes opções:
-
Últimas 24 horas
-
Últimas 48 horas
-
Últimas 72 horas
-
Tempo personalizado: selecione para abrir a caixa de diálogo Tempo personalizado. Com isso, é possível filtrar operações com base nas datas dos campos Iniciado e Concluído:

Clique em um ícone de calendário para abrir um seletor de data para um campo:

Defina as datas de ou até (ou ambas) usando o calendário. A localidade do seu navegador determina como as datas são exibidas.
O seletor de data permite selecionar apenas datas dos últimos 30 dias. Datas fora desse intervalo não são selecionáveis.
Para definir uma hora, insira a hora e o minuto no formato
HH:MMe o período (AMouPM).Clique em qualquer lugar da caixa de diálogo Tempo Personalizado para fechar o seletor de data.
Quando um ou ambos os intervalos de datas dos campos estão definidos, clique em Aplicar. Para limpar o intervalo, clique em Limpar. Para limpar as datas de um campo, clique no ícone dele.
Baixar como CSV
Clique em Baixar como CSV para abrir a caixa de diálogo Baixar logs. A exportação tem as seguintes características:
- Escopo: a exportação usa a consulta de pesquisa, filtros e intervalo de tempo aplicados, refletindo todas as entradas de log correspondentes. Isso é equivalente ao conjunto de resultados completo 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 hora de Início do pai (decrescente), com registros filhos ordenados por sequência de execução (crescente).
- Fuso horário: os registros de data e hora de 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 as seguintes opções:
- 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 Download 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. A gaveta Configurações abre:

Selecione um intervalo de atualização automática, um de Nunca (o 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 a visibilidade das colunas, clique em Filtrar Colunas. A gaveta Colunas abre:

A gaveta possui os seguintes controles:
- 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.
- Salvar: Salve as colunas.
- Cancelar: Feche a gaveta de colunas sem salvar as alterações.
Tabela de detalhes da operação
Para classificar a tabela por uma coluna, clique no cabeçalho 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 toda a cadeia. Clique no ícone Minimizar para recolher uma operação e seus filhos. (Aplica-se a todos os tipos de log.)
-
Tipo de Log: O tipo de entrada de log: API Personalizada, API de Proxy ou API OData para operações acionadas por uma chamada de API, ou Operação para operações executadas diretamente. (Aplica-se a todos os tipos de log.)
-
Ambiente: O nome do ambiente no qual a operação foi implantada. (Aplica-se a todos os tipos de log.)
-
Status: O status da entrada de log. Consulte Valores de status.
-
Iniciado: A hora em que a execução da operação foi solicitada. (Aplica-se a todos os tipos de log.)
-
Concluído: A hora em que o status da operação foi alterado pela última vez. (Aplica-se a todos os tipos de log.)
-
Duração: O tempo decorrido entre Iniciado e Concluído. (Aplica-se a todos os tipos de log.)
-
ID: O identificador exclusivo da entrada de log. (Aplica-se a todos os tipos de log.)
-
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 coluna é preenchida apenas para entradas de log API Personalizada, API de Proxy e API OData.
-
Agente: O nome do agente. Esta coluna é preenchida apenas para entradas de log Operação.
-
Projeto: O nome do projeto onde a operação está em execução. Esta coluna é preenchida apenas para entradas de log Operação.
-
GUID da Operação Raiz: O identificador globalmente exclusivo (GUID) da operação raiz (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 Operação. Para copiar o valor, passe o mouse sobre ele e clique em Copiar conteúdo.
-
ID da Operação: O identificador globalmente exclusivo (GUID) da operação. Esta coluna é preenchida apenas para entradas de log Operação. (Esta coluna fica oculta por padrão.)
-
Ações: Passe o mouse sobre uma operação para revelar as ações disponíveis. As ações variam de acordo com o tipo de log:
Para entradas de log API Personalizada, API de Proxy e API OData:
- Visualizar: Abra os detalhes do log.
- Abrir API: Abra a API no API Manager.
Para entradas de log de Operação:
- Visualizar: Abra os detalhes do log.
-
Cancelar operação: Habilitado para operações com status Enviada, Recebida, 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 da 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.
-
Ir para operação: Abra o projeto no Studio e selecione 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 exibido em uma página são incluídas nessa página, mesmo que o total ultrapasse 100. Você pode navegar pelas páginas usando estes botões de navegação na parte inferior da tabela:
- Página anterior: Vá para a página anterior.
- Próxima página: Vá para a próxima página.
Detalhes da entrada de log
Para ver os detalhes de uma entrada de log, selecione uma na tabela. A gaveta Mensagens e logs abre na parte inferior da janela com as seguintes abas, dependendo do tipo de log:
- Entradas de log de API personalizada, API de proxy e API OData: Mensagens e Log de depuração.
- Entradas de log de Operação: Mensagens, Logs de atividade, Arquivos de depuração e Log de depuração.
Aba Mensagens
O conteúdo da aba Mensagens varia dependendo do tipo de log da entrada selecionada.
Entradas de log de API
Quando uma entrada de log de API personalizada, API de proxy ou API OData é selecionada, a aba Mensagens exibe detalhes sobre a chamada de API nas seguintes seções recolhíveis: Informações de API, Informações de chamada, Log de chamada e Carga de API (quando habilitado).
Informações de API
A seção Informações de API exibe os seguintes detalhes:
-
API: O nome da API que acionou a operação. Clique em para abrir a configuração de 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:
- CUSTOM_API: Uma API personalizada criada no API Manager.
- ODATA: Uma API OData criada no API Manager.
-
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 pesquisar solicitações específicas. Clique em 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 em 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 completa do serviço de API conforme consumida pelo cliente.
-
Aplicação de origem: O aplicativo ou navegador que fez a solicitação de API.
Informações da chamada
A seção Informações da chamada exibe os cabeçalhos de solicitação HTTP enviados com a chamada da API sob um rótulo Cabeçalhos de solicitaçã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 contêm credenciais ou dados de sessão são mascarados, conforme descrito em Cabeçalhos mascarados.
Log de chamadas
A seção Log de chamadas exibe mensagens de log em nível de sistema geradas durante o processamento da solicitação da API. Clique em para copiar o log para a área de transferência.
Carga da API
A seção Carga da API exibe os dados de carga de solicitaçã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 guia Configurações da API: Ativar modo de depuração até ou Mostrar Cargas de Solicitação e Resposta nos Logs.
A seção é dividida em dois painéis:
-
Corpo da solicitação: A carga enviada com a solicitação da API.
-
Corpo da resposta: A carga retornada pela API. Se a carga de resposta exceder o limite de exibição, ela será exibida com um rótulo
(Truncado).
Cada painel fornece os seguintes controles:
-
Pesquisar: Pesquise a carga por uma string específica.
-
Copiar: Copie a carga para a área de transferência.
-
Baixar: Baixe a carga como um arquivo.
Entradas do log de operações

Quando uma entrada de log de Operação é selecionada, a guia 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 mostra
0independentemente 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 mostra
0independentemente 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 informativas e de aviso retornadas pelos sistemas de origem ou destino.
- Avisos de validação retornados pelos serviços de transformação, validação e script do Jitterbit.
- Mensagens definidas pelo usuário geradas pela ferramenta Invocar Operação (quando Gerar erro se a operação falhar 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 truncatedaparecendo no final do log.
-
Mensagens registradas em scripts de pré-transformação: Mensagens geradas durante a execução do script de pré-transformação. Clique em para copiar ou para baixar.
Para ver as mensagens de log de uma operação na guia Mensagens, o seguinte deve ser verdadeiro:
- Você deve ser membro de uma função com no mínimo permissão de organização Leitura e acesso ao ambiente Visualizar 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 a configuração de rede permitir conexão direta ao host do agente, as mensagens de log podem ser visualizadas com segurança clicando no link Visualizar mensagens de log do Agente.
Aba Logs de Atividade

Esta aba contém links para arquivos de sucesso ou falha criados pelas atividades do Salesforce, Salesforce Service Cloud ou ServiceMax em execução 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. É possível alterar esse comportamento na seção [ResultFiles] do arquivo jitterbit.conf do agente privado ou alterando as regras do serviço de limpeza de arquivos.
Os downloads de logs de atividade estão desabilitados para agentes em nuvem. É possível ver links de download para logs de atividade de agentes em nuvem, mas tentar baixar os logs gera uma mensagem de erro.
Aba Arquivos de Debug

Quando o log de debug está habilitado para agentes privados, esta aba contém um link para baixar arquivos de log de debug de operação. Os arquivos de debug 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 executadas em agentes em nuvem.
Aba Debug Logging
Quando o log de debug 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 completa de execução de uma operação do Studio. A visualização do 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 estiverem encadeadas com ações de operação ou a função RunOperation, essas operações serão listadas sob a operação pai.
Quando o log de debug de operação está habilitado, esta aba também pode exibir dados de entrada e saída de componente e dados de solicitação e resposta de API (quando a operação é acionada por uma API do API Manager). A carga útil de solicitação e resposta é incluída apenas quando Show Request & Response Payloads in Logs também está habilitado na aba Settings da API.
As operações pai (e quaisquer operações filhas 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 de cabeçalho.

Ao abrir a visualização do log de operação, o primeiro log de operação na lista é selecionado por padrão. As informações de log detalhadas para esta operação aparecem no painel direito.
-
Name: O nome da operação ou etapa de operação. Os símbolos , que podem ser usados para expandir ou recolher linhas adicionais, são exibidos em operações pai e em operações para as quais dados de entrada e saída de componente estão disponíveis:
- Operações pai: Quando uma operação pai é expandida, 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 recolher lista ou expandir lista para recolher ou expandir todas as operações pai.
-
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, informado 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 entrada de log, consulte Valores de status. Para uma etapa da operação, este é um dos seguintes:
- Concluído: 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. As possíveis razões para este status incluem que a etapa da operação está aguardando execução ou que houve um erro em uma etapa anterior que impediu a execução da etapa seguinte.
-
Ações: Estas ações não estão disponíveis para etapas da operação e diferem por tipo de linha:
-
Linhas de entrada de log da API: Esta ação está disponível em linhas para a entrada de log da API que acionou a operação.
- Ir para API: Abre a página de detalhes da API correspondente no API Manager, com sua gaveta aberta automaticamente.
-
Linhas de operação: Estas ações estão disponíveis em linhas para a operação em si, incluindo qualquer operação filha encadeada.
-
Cancelar operação: Habilitado para operações 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 da 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.
-
Ir para operação: Abre o projeto no Studio e seleciona a operação.
-
-
-
Atualizar: Clique para atualizar a lista de logs de operação.
-
Filtrar colunas: Clique para abrir uma gaveta 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.
-
Log de operação: Para mostrar ou ocultar um log de uma operação individual, clique em uma operação da 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á habilitado. Para mais informações, consulte Aba 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 informadas em seu formato original da fonte da mensagem de 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 log 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 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 Cloud logging enabled. Os dados de entrada e saída de componentes serão registrados na nuvem Harmony mesmo se o registro em nuvem estiver desabilitado.
Para desabilitar 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], defina verbose.logging.enable=false.
Aviso
Quando 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 uma carga de solicitação, ficarão visíveis em texto simples nos dados de entrada e saída nos registros 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 para 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 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.

- Search: Pesquisa os dados pelo texto inserido.
- Copy: 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
_inputou_output, conforme apropriado.
Dados de solicitação e resposta da API
Nova interface de usuário necessária
O recurso de dados de solicitação e resposta da API está disponível apenas para organizações que foram atualizadas para as novas interfaces Analytics e API Logs. Essa atualização está sendo implementada gradualmente. Se você estiver interessado em acesso antecipado, entre em contato com o suporte Jitterbit.
Quando uma operação é acionada por uma API personalizada ou API OData do API Manager, as informações exibidas nos registros de operação dependem de quais configurações estão habilitadas. Operações malsucedidas são sempre registradas. Execuções bem-sucedidas aparecem nos registros de operação do Studio apenas quando Enable debug mode until (uma configuração do API Manager) ou Operation debug logging (uma configuração de agente) está ativa. indica que a configuração adiciona essa capacidade; indica que não:
| Configurações habilitadas | Execuções bem-sucedidas nos registros de operação do Studio | Dados brutos de solicitação/resposta no registro de chamadas | Cargas de solicitação/resposta |
|---|---|---|---|
| Nenhuma (padrão) | |||
| Verbose logging (configurações de API personalizada, API OData ou API proxy) | |||
| Enable debug mode until (configurações de API personalizada, API OData ou API proxy) | |||
| Operation debug logging (agentes em nuvem ou agentes privados) |
Nota
Para capturar 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.

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