Página de Operações em Tempo de Execução no Console de Gerenciamento do Jitterbit

Introdução

A página de Operações em Tempo de Execução é 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 e quaisquer mensagens de log. A exibição de mensagens de log detalhadas depende dos níveis de permissão e acesso, além de estar habilitado o registro em log na nuvem. Quando o registro de log de depuração da operação (para agentes na nuvem ou para agentes privados) está habilitado para uma operação individual, cada log de operação também contém dados de entrada e saída para a operação.

Para abrir a página de Operações em Tempo de Execução, use o menu do portal Harmony para selecionar Console de Gerenciamento > Operações em Tempo de Execução.

Para acessar esta página, você deve ser um administrador da organização Harmony (um membro de um papel com a permissão Admin), ou um membro de um papel com Executar ou Visualizar Logs acesso ao ambiente.

Por padrão, a página de Operações em Tempo de Execução não exibe operações de API personalizadas ou serviços OData bem-sucedidas. Para incluí-las, habilite o registro de log de depuração da operação na operação ou, apenas para agentes privados, defina EnableLogging=true na seção [APIOperation] do arquivo de configuração do agente privado.

Os ferramentas e regiões da página são mencionadas ao longo deste documento. Elas são identificadas na imagem abaixo:

Tabela de detalhes da operação

As colunas disponíveis são as seguintes:

• Operação: O nome da operação do Integration Studio ou do Design Studio. Se uma operação tiver filhos, clique no ícone Expandir para revelar toda a cadeia. Clique no ícone Minimizar para colapsar uma operação e seus filhos.

• Projeto: O nome do projeto onde a operação está sendo executada.

• Agente: O nome do agente.

• Ambiente: O nome do ambiente para o qual a operação foi implantada.

• Status: O status da operação, um dos seguintes:

  • Enviado: Uma operação foi enviada para a fila do Harmony, mas ainda não foi aceita por um agente para execução.
  • Recebido: Um agente reconhece o recebimento da solicitação para executar uma operação.
  • Pendente: Uma operação está na fila para ser executada em um agente.
  • Executando: Um agente está executando a operação.
  • Cancelamento Solicitado: Uma solicitação para cancelar a operação foi feita. As operações podem mostrar esse status e continuar a ser executadas após o cancelamento.
  • Cancelada: 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 pode geralmente ser ignorado. Este aviso indica que a carga útil da API de um conector retornou mais nós ou campos de dados do que os definidos no esquema de dados da resposta.

• Sucesso com Erro de Filho: 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.)
• Erro: A operação falhou.
• Falha SOAP: A operação falhou com uma falha SOAP. (Aplica-se a operações com SOAP ou Salesforce como pontos finais do Integration Studio, ou serviços web ou Salesforce como pontos finais do Design Studio.)

Se uma operação tiver o registro de depuração da operação ativado no nível da operação, e a operação foi executada em um agente 10.48 ou posterior, a coluna Status na aba de Registro de Depuração mostra o status da etapa da operação:

• Completo: A etapa da operação foi executada e concluída sem erros.
• Erro: A etapa da operação foi executada, mas não pôde ser concluída devido a um erro.

• Incompleto: A etapa da operação não foi executada ou concluída. Possíveis razões para esse status incluem que a etapa da operação está aguardando para ser executada ou que houve um erro em uma etapa anterior da operação impedindo a execução da etapa seguinte.

• Iniciado: O momento em que a execução da operação foi solicitada.

• Concluído: O momento em que o status da operação foi alterado pela última vez.
• ID da Operação: O identificador exclusivo global (GUID) da operação. (Esta coluna está oculta por padrão.)

• Guid da Instância da Operação Raiz: O identificador exclusivo global (GUID) da operação raiz (de nível superior) da operação. Este campo está vazio para operações raiz, e a coluna está oculta por padrão. Para copiar o valor, passe o mouse sobre ele e clique em Copiar conteúdo.

  Nota

  Root Operation Instance Guid é um recurso beta que será desenvolvido ainda mais no futuro.

• Ações: Passe o mouse sobre uma operação para revelar as seguintes ações:

  • Cancelar Operações: Pare uma operação que está com status Submetido, Recebido, Pendente ou Em Execução.
  • Ir para operação: Abra o projeto no Integration Studio e selecione a operação.

Quando há mais de 100 operações, elas são divididas em páginas de 100 cada. Você pode navegar por elas usando os 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.

Para ver os detalhes do log de uma operação, selecione uma na tabela. Um painel se abre na parte inferior da janela com quatro abas, Mensagens, Logs de Atividade, Arquivos de Depuração e Registro de Depuração.

Aba Mensagens

Esta aba mostra o seguinte:

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

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

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

  • Mensagens geradas pelo sistema indicando que a operação foi concluída sem erro.
  • 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 script do Jitterbit.
  • Mensagens definidas pelo usuário geradas pela ferramenta Invoke Operation (Beta) (quando Levantar erro se a operação falhar está habilitado) ou pela função WriteToOperationLog().

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

• Você deve ser membro de um papel com permissão mínima de Leitura na organização e acesso Executar ao ambiente. (Um nível de acesso ao ambiente de Visualizar Logs não é suficiente.)
• O registro em nuvem está ativado no grupo de agentes privados. (O registro em nuvem está sempre ativado em grupos de agentes em nuvem.) Quando desativado, e se a configuração da sua rede permitir que você se conecte diretamente ao host do agente, as mensagens de log podem ser visualizadas de forma segura clicando no link Visualizar mensagens de log do Agente.

Aba de Logs de Atividade

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

Os arquivos estão no formato CSV. Para baixar um, clique no 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 logs 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 de Arquivos de Depuração

Quando o registro de depuração está ativado 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.

Os downloads de arquivos de log de depuração estão desativados para agentes em nuvem. Você pode ver links de download para arquivos de depuração de agentes em nuvem, mas tentar baixar arquivos gera uma mensagem de erro.

Aba de Registro de Depuração

Quando o registro de depuração está habilitado no nível da operação (para agentes em nuvem ou para agentes privados) e a operação foi executada em um agente 10.48 ou posterior, esta aba mostra os detalhes da hierarquia completa de execução de uma operação do Integration Studio. Quando a operação selecionada está vinculada a ações de operação, os logs para operações subsequentes também estão incluídos.

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

• Nome: O nome da operação ou etapa da operação. Os triângulos de divulgação , que podem ser usados para expandir ou colapsar linhas adicionais, são mostrados nas operações pai e nas 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 colapsar lista ou expandir lista para colapsar ou expandir todas as operações pai.

• Entrada/Saída: Os dados de entrada e saída acessados através desta parte da tabela de log são descritos em Dados de entrada e saída do componente.

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

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

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

• Status: O status da operação ou etapa de operação. Para uma lista completa de possíveis status, consulte a tabela de detalhes da operação mais acima nesta página.

• Ações: Estas ações estão disponíveis:

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

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

    Nota

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

  • Ir para operação: Abra o projeto no Integration Studio e selecione a operação.

• Registro da operação: Para mostrar ou ocultar um registro de uma operação individual, clique em qualquer lugar em uma linha de operação, exceto nos ícones mostrados na coluna Entrada/Saída:

  

  • Mensagens de log: As mensagens de log incluem os detalhes do log para a operação selecionada. Se as mensagens de log são exibidas depende das permissões e níveis de acesso do usuário atual e se o registro em nuvem está habilitado. Para mais informações, consulte a aba Mensagens mais acima nesta página.

    Nota

    Datas e horas exibidas dentro das mensagens de log não são convertidas para o horário local do navegador, mas são reportadas 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 registro de depuração de operação habilitado no nível da operação (para agentes em nuvem ou para agentes privados) e a operação foi executada em um agente 10.48 ou posterior.

Quando os dados de entrada e saída de componentes estão presentes, uma coluna Entrada/Saída mostrando uma representação gráfica da operação ou etapa da operação é exibida na tabela de registros da operação.

Na coluna Entrada/Saída, ícones para atividades e transformações usadas como etapas da operação podem ser clicados para mostrar ou ocultar os dados de entrada e saída do componente para essa etapa de operação individual. Cada entrada de registro de entrada e saída é limitada a 100MB. Se os dados de uma entrada de registro de entrada ou saída individual excederem 100MB, nenhum dado será exibido.

• Pesquisar: Pesquise os dados pelo texto inserido.
• Copiar: Copia os dados do registro 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 da operação seguido de _input ou _output, conforme apropriado.

Queries

Uma consulta é um ou mais termos 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, os valores podem incluir um caractere curinga, %, que corresponde a qualquer string.

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

Quando o toggle Visualização da árvore de execução está ativado, uma consulta usando a chave operation (descrita abaixo) retorna resultados para toda a hierarquia de quaisquer operações pai ou filho vinculadas à operação. A string da palavra-chave é destacada em azul dentro dos resultados. Quando o toggle Visualização da árvore de execução está desativado, apenas operações que correspondem à consulta são retornadas.

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

Exemplos de consulta

Os seguintes são exemplos de termos de consulta:

Saved queries

As consultas podem ser salvas e usadas, e depois editadas ou excluídas, da seguinte forma:

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

  

  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. Você pode adicionar termos das seguintes maneiras:
    • Clique no campo para mostrar uma lista de termos de pesquisa disponíveis. Selecione um para inseri-lo no campo de consulta, depois 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 serem exibidas nos resultados da pesquisa.

    

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

  

  Clique em Consultas salvas para fechá-lo.

• Para usar uma consulta salva, clique em Consultas salvas, 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 no painel 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, depois clique no ícone Excluir da que deseja excluir. Um diálogo Excluir Consulta Salva pede para você confirmar. Clique em Excluir para continuar ou Cancelar para cancelar.

Intervalo de tempo

A página de Operações em Tempo de Execução 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, você pode filtrar operações com base nas datas dos campos Iniciado e Finalizado:

  

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

  

  Defina uma ou ambas as datas de ou até usando o calendário. O idioma do seu navegador determina como as datas são exibidas.

  Para definir um horário, insira a hora e o minuto no formato HH:MM e o período do dia (AM ou PM).

  Clique em qualquer lugar na caixa de diálogo Tempo Personalizado para fechar o seletor de datas.

  Quando uma ou ambas as faixas de datas dos campos estiverem definidas, clique em Aplicar. Para limpar o intervalo, clique em Limpar. Para limpar as datas de um campo, clique no ícone correspondente.

Configurações da página

Você pode classificar a tabela, reorganizar suas colunas ou atualizar seu conteúdo:

• Classificar: Para classificar a tabela em ordem crescente, clique em qualquer cabeçalho de coluna. Clique novamente para inverter a ordem de classificação.

• Colunas: Para alterar a disposição e a visibilidade das colunas, clique em Filtrar Colunas. A gaveta Colunas se 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 mostrá-la.
  • Salvar: Salvar as colunas.
  • Cancelar: Fechar a gaveta de colunas sem salvar as alterações.

• Atualizar: A tabela é atualizada automaticamente.

  Para alterar o intervalo de atualização automática, clique em Configurações. O painel de Configurações se abre:

  

  Selecione um intervalo de atualização automática, sendo 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.