Ir para o conteúdo

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 LeituraR
Acesso ao ambiente Usuários com níveis de acesso ao ambiente Visualizar LogsE

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, e quaisquer mensagens de log. Se as mensagens de log detalhadas são exibidas depende dos níveis de permissão e acesso, e se o registro em nuvem está ativado.

Página Runtime

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 têm registro adicional que pode ser ativado. Para detalhes, consulte Dados de solicitação e resposta da API.

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 <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 de não-igualdade (!=), desative o botão de alternância Visualização de árvore de execução.

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

Barra de pesquisa

Quando o botão de alternância Visualização de á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 Visualização de á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 Operação =, != Nome da operação
project Projeto =, != Nome do projeto
environment Ambiente =, != Nome do ambiente
agent Agente =, != Nome do agente
status Status =, != Nome do status ou código de status HTTP Para entradas de log de Operação, o nome do status mostrado na coluna Status da tabela de detalhes da operação. Para entradas de log de API personalizada, API proxy e API OData, 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 Iniciado <= 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 Concluído <= Data/hora
>=
rootOperationInstanceGuid GUID da Instância de Operação Raiz = GUID da operação raiz
apiServiceUrl URL do Serviço de API =, != 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 em execução em agentes com nomes que começam com "Windows".
agent!=Windows%; Mostra logs de operação para operações em execução 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.
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 ativas pela última vez em ou antes de 10/04/2024.
finished>=10/04/2024 01:00:00 PM; Mostra logs de operação para operações ativas pela última vez em ou após 10/04/2024 às 13h.
message=1201 alarm; Mostra logs de operação para operações contendo 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 de 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 de 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 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.

      Formulário de consulta

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

    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:

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:

    Tempo personalizado

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

    Seletor de data

    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:MM e o período (AM ou PM).

    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 estiverem 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 a seguinte opção:

  • Include messages: 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 Cancel para descartar.

Atualizar

A tabela é atualizada automaticamente. Para alterar o intervalo de atualização automática, clique em Settings. A gaveta Settings abre:

Settings

Selecione um intervalo de atualização automática, um de Never (padrão), 1 minute, 5 minutes, 15 minutes ou 30 minutes, e clique no botão Save.

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

Filtrar colunas

Para alterar a disposição e a visibilidade das colunas, clique em Filter Columns. A gaveta Columns abre:

Filter columns

A gaveta possui os seguintes controles:

  • Show All: Torna todas as colunas visíveis.
  • Move: Arraste e solte para alterar a posição da coluna em relação às outras.
  • Hide: A coluna está visível. Clique para ocultá-la.
  • Show: A coluna está oculta. Clique para exibi-la.
  • Save: Salve as colunas.
  • Cancel: 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:

  • Name: O nome da API ou operação associada à entrada de log. Para entradas de operação com filhos, clique no ícone Expand para revelar toda a cadeia. Clique no ícone Minimize para recolher uma operação e seus filhos. (Aplica-se a todos os tipos de log.)

  • Log Type: O tipo de entrada de log: Custom API, Proxy API ou OData API para operações acionadas por uma chamada de API, ou Operation para operações executadas diretamente. (Aplica-se a todos os tipos de log.)

  • Environment: 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. Para entradas de log Custom API, Proxy API e OData API, este é o código de status HTTP (consulte definições de código de status w3.org). Para entradas de log Operation, este é um dos seguintes:

    • Submitted: Uma operação foi enviada para a fila do Harmony, mas ainda não foi aceita por um agente para execução.
    • Received: Um agente reconhece o recebimento da solicitação para executar uma operação.
    • Pending: Uma operação está na fila para ser executada em um agente.
    • Running: Um agente está executando a operação.
    • Cancel Requested: Uma solicitação para cancelar a operação foi feita. As operações podem exibir este status e continuar a ser executadas após o cancelamento.
    • Canceled: A operação foi cancelada.
    • Success: A operação foi concluída com sucesso.
    • Success With Info: A operação foi concluída com sucesso com problemas não fatais.
    • Success With Warning: A operação foi concluída com sucesso com avisos conforme mostrado nas mensagens de log.

      Dica

      Um aviso extra subelement 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.

    • Success With Child Error: A operação foi concluída com sucesso, mas uma ou mais operações filhas sofreram erros fatais. (Aplica-se a operações síncronas.)

    • Error: A operação falhou.
    • Soap Fault: A operação falhou com uma falha SOAP. (Aplica-se a operações com endpoints SOAP ou Salesforce do Studio, ou endpoints web services ou Salesforce do Design Studio.)

Se uma operação tem o log de depuração da operação ativado no nível da operação e a operação foi executada em um agente versão 10.48 ou posterior, a coluna Status na aba Debug Logging mostra o status da etapa da operação:

  • 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 esse status incluem que a etapa da operação está aguardando execução ou que houve um erro em uma etapa anterior da operação que impediu a execução da etapa seguinte.

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

  • Finalizado: 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 Finalizado. (Aplica-se a todos os tipos de log.)

  • ID: O identificador único 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 Custom API, Proxy API e OData API.

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

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

  • GUID da Instância de Operação Raiz: O identificador globalmente único (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 Operation. Para copiar o valor, passe o mouse sobre ele e clique em Copiar conteúdo.

  • ID da Operação: O identificador globalmente único (GUID) da operação. Esta coluna é preenchida apenas para entradas de log Operation. (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 Custom API, Proxy API e OData API:

    • Visualizar: Abra os detalhes do log.
    • Abrir API: Abra a API no API Manager.

    Para entradas de log Operation:

    • Visualizar: Abra os detalhes do log.
    • Cancelar operação: Ativado 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: 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 da última operação pai exibida 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:

Aba Mensagens

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

Entradas de log da API

Quando uma entrada de log Custom API, Proxy API ou OData API é selecionada, a aba Mensagens exibe detalhes sobre a chamada da API nas seguintes seções expansíveis: Informações da API, Informações da chamada, Log da chamada 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.

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

  • API type: O tipo da API, um dos seguintes:

    • CUSTOM_API: Uma custom API criada no API Manager.
    • ODATA: Uma OData API criada no API Manager.
  • Request Method: O método HTTP usado para a chamada da API. Os valores possíveis incluem GET, POST, PUT, DELETE, PATCH e MERGE.

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

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

  • API gateway: O gateway de API que processou a solicitação. Este campo mostra o nome de domínio do cloud API gateway ou private API gateway que tratou a chamada da API.

  • API service URL: 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 API service URL completa conforme consumida pelo cliente.

  • Source Application: A aplicação ou navegador que fez a solicitação da 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 Request headers. Cada cabeçalho é exibido como um par chave-valor, como accept, accept_encoding, content_length, fulluri, host, user_agent e cabeçalhos de encaminhamento. Cabeçalhos que contêm credenciais ou dados de sessão são mascarados, conforme descrito em Masked headers.

Log da chamada

A seção Log da chamada 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 sua área de transferência.

API Payload

A seção API Payload exibe os dados de payload de solicitação e resposta para a chamada da API. Esta seção fica visível quando um ou ambos os seguintes estão habilitados na aba Settings da API: Enable debug mode until ou Show Request & Response Payloads in Logs.

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

  • Request body: O payload enviado com a solicitação da API.

  • Response body: O payload retornado pela API. Se o payload de resposta exceder o limite de exibição, ele é mostrado com um rótulo (Truncated).

Cada painel fornece os seguintes controles:

  • Search: Pesquisa o payload por uma string específica.

  • Copy: Copia o payload para sua área de transferência.

  • Download: Baixa o payload como um arquivo.

Entradas do log de operações

Aba Mensagens

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

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

  • Registros de Destino: Ao usar uma atividade de FTP ou Banco de Dados como destino, exibe-se a contagem de registros postados no sistema de destino. Para outros conectores, a contagem mostra 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 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á ativado) ou pela função WriteToOperationLog().

    As mensagens de log são exibidas como blocos individuais identificados pelo 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, indicado 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 ver as mensagens de log de uma operação na aba 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á ativado no grupo de agentes privados. (O log em nuvem está sempre ativado em grupos de agentes em nuvem.) Quando desativado, e se sua configuração de rede permitir conectar diretamente ao host do agente, as mensagens de log podem ser visualizadas com segurança clicando no link Visualizar mensagens de log do Agente.

Aba Activity Logs

Aba Activity logs

Esta aba contém links para arquivos de sucesso ou falha criados pelas atividades de 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 excluídos 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 do serviço de limpeza de arquivos.

Os downloads de log de atividade estão desativados 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

Aba Debug files

Quando o log de debug está ativado para agentes privados, esta aba contém um link para baixar arquivos de log de debug da 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 na nuvem.

Aba Debug Logging

Quando o log de debug está ativado no nível da operação (para agentes na 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 detalhadas de log 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 log de debug de operação está ativado, esta aba também pode exibir dados de entrada e saída de componentes 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á ativado na aba Settings da API.

As operações pai (e todas as 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 linha de cabeçalho respectiva.

Aba Debug Logging

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 detalhadas de log para esta operação aparecem no painel direito.

  • Name: O nome da operação ou etapa de operação. Os acento circunflexo, 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 componentes 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.
  • 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 lista completa de status possíveis, consulte Tabela de detalhes da operação anteriormente nesta página.

  • 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 log de API: Esta ação está disponível em linhas para a entrada de log de API que acionou a operação.

      • Go to API: Abra a página de detalhes da API correspondente no API Manager, com sua gaveta aberta automaticamente.
    • Linhas de operação: Essas ações estão disponíveis em linhas para a operação em si, incluindo qualquer operação filha encadeada.

      • Cancel operation: Ativado para operações que estão em 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. 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 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 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á 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 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 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 do componente não é afetada pela configuração do grupo de agentes Log em nuvem ativado. Os dados de entrada e saída do componente serão registrados na nuvem Harmony mesmo se o log em nuvem estiver desativado.

Para desabilitar a geração de dados de entrada e saída do componente 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 do componente 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, serã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 do componente 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 do componente 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.

log table operation steps header

  • Pesquisar: Pesquisa os dados pelo texto inserido.
  • Copiar: Copia os dados do log para 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 de operação seguido por _input ou _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 de Analytics e API Logs. Essa atualização está sendo implementada gradualmente. Se você estiver interessado em acesso antecipado, entre em contato com o suporte do 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 Ativar modo de depuração até (uma configuração do API Manager) ou Log de depuração de operação (uma configuração do agente) está ativo. indica que a configuração adiciona essa funcionalidade; indica que não:

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)
Log detalhado (configurações de API personalizada, API OData ou API proxy)
Ativar modo de depuração até (configurações de API personalizada, API OData ou API proxy)
Log de depuração de operação (agentes em nuvem ou agentes privados)

Nota

Para capturar todos os três tipos de dados simultaneamente, use Ativar modo de depuração até ou combine Log de depuração de operação com Mostrar Cargas de Solicitação e Resposta nos Logs e Log detalhado.

api information

Informações da 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 da API: Um identificador único para a solicitação de API. Você pode usar esse ID para correlacionar logs em diferentes sistemas e para pesquisar solicitações específicas. Clique no ícone copiar 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: A aplicação 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 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 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 solicitaçã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 solicitação.