Página de operações de tempo de execução no Jitterbit Management Console
Introdução
A página Operações de tempo de execução é 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 mensagens de log detalhadas são exibidas depende dos níveis de permissão e acesso e se o log de nuvem está habilitado. Quando o log de depurar de operação (para agentes de nuvem ou para agentes privados) estiver 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 Operações de tempo de execução, selecione Management Console > Operações de tempo de execução no menu do portal Harmony:
Para acessar esta página, você deve ser um administrador da organização Harmony (um membro de uma papel com a permissão Admin permissão), ou um membro de uma papel com Executar ou Exibir Logs acesso ao ambiente.
Nota
O Harmony mantém registros de operação por 30 dias.
Por padrão, a página Operações de tempo de execução não mostra API personalizada bem-sucedida ou serviços OData Operações de API. Para incluí-las, habilite registro de depurar de operação sobre a operação, ou, apenas para agentes privados, definir EnableLogging=true
no [APIOperation]
seção do arquivo de configuração do agente privado.
As ferramentas e regiões da página são mencionadas ao longo deste documento. Elas são identificadas na imagem abaixo:
Lenda
①Barra de pesquisa
②Menu de intervalo de tempo
③ ícones Salvar consulta e Consultas salvas
④Atualização de tabela e ícones Filtrar colunas
⑤Ícone de configurações da página
⑥Tabela de detalhes da operação
⑦Ferramentas do paginador
Tabela de detalhes da operação
O padrão arranjo das colunas da tabela é o seguinte:
- Operação: O nome do Integration Studio ou Design Studio operação. Se uma operação tiver filhos, clique no ícone Expandir para revelar toda a cadeia. Clique em um Ícone Minimizar para recolher uma operação e seus filhos.
- Ambiente: O nome do ambiente a operação foi implantada.
- Agente: O agente nome.
-
Root Operation Instance Guid: (beta) O identificador globalmente exclusivo (GUID) da operação raiz (nível superior) da operação. Este campo está vazio para operações raiz, e a coluna está oculto por padrão. Para copiar o valor, passe o mouse sobre ele e clique em Copiar conteúdo.
Nota
Guia de Instância de Operação Root é um recurso beta que será desenvolvido no futuro.
-
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 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. As operações podem mostrar esse status, mas continuar a ser executadas após o cancelamento.
- 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, sem problemas fatais.
-
Sucesso com aviso: A operação foi concluída com sucesso com avisos, conforme mostrado nas mensagens de log.
Um
extra subelement
aviso nas mensagens de log geralmente pode ser ignorado. Este aviso indica que a 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 filho: A operação foi concluída com sucesso, mas uma ou mais operações filho sofreram erros fatais. (Aplica-se a operações síncronas.)
- Erro: A operação falhou.
- Falha de SOAP: A operação falhou com uma falha de SOAP. (Aplica-se a operações com Integration Studio SOAP ou Salesforce endpoints ou Design Studio serviços web ou Salesforce endpoints.)
-
Iniciado: O horário em que a execução da operação foi solicitada.
-
Concluído: A hora em que o status da operação foi alterado pela última vez.
-
Ações: Passe o mouse sobre uma operação para revelar as seguintes ações:
-
Cancelar operações: Interrompa uma operação que esteja no status Enviado, Recebido, Pendente ou Em execução.
-
Ir para a operação: Abra o projeto em 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 estes botões de navegação na parte inferior da tabela:
- Página anterior: Ir para a página anterior.
- Próxima página: Ir para a próxima página.
Para ver os detalhes de um log de operação, selecione um na tabela. Uma gaveta abre na parte inferior da janela com quatro abas, Messages, Registros de atividades, Arquivos de depuração e Registro de depuração.
Aba de mensagens
Esta aba mostra o seguinte:
- Registros de origem: O número de registros lidos do sistema de origem.
- Registros de destino: O número de registros postados no sistema 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 de destino.
- Avisos de validação retornados pelos serviços de transformação, validação e script do Jitterbit.
- Mensagens definidas pelo usuário geradas pelo
WriteToOperationLog()
função.
Para ver as mensagens de log de uma operação na abaMensagens, o seguinte deve ser verdadeiro:
- Você deve ser membro de uma papel com, no mínimo, permissão de Ler organização e acesso de Executar ambiente. (Um nível de acesso de ambiente de Exibir logs não é suficiente.)
- O registro em nuvem está habilitado no grupo de agentes privados. (O registro em nuvem está sempre habilitado em grupos de agentes em nuvem.) Quando desabilitado, e se sua configuração de rede permitir que você se conecte diretamente ao hospedar do agente, as mensagens de registro poderão ser visualizadas com segurança clicando no link Exibir mensagens de registro do Agente.
Aba Registros de atividades
Esta aba contém links para arquivos de sucesso ou falha criados pelo Salesforce, Salesforce Service Cloud, ou ServiceMax atividades em execução em um agente privado.
Os arquivos estão no formato CSV. Para baixar um, clique no link.
Os arquivos de log de atividades são excluídos automaticamente após 14 dias pelo serviço de limpeza de arquivos do agente privado. Você pode alterar esse comportamento no [ResultFiles]
seção do agente privado jitterbit.conf
arquivo ou alterando as regras do serviço de limpeza de arquivos.
Os downloads de log de atividade são desabilitados para agentes de nuvem. Você pode ver links de download para logs de atividade de agentes de nuvem, mas qualquer tentativa de baixar logs gera uma mensagem de erro.
Aba Arquivos de Depuração
Esta aba contém links para arquivos de log de depurar. Quando habilitados, eles são gerados para todas as operações em execução em um agente privado, ou para selecionados Integration Studio ou Design Studio operações em execução em qualquer tipo de agente.
Aba de registro de depuração
Quando o registro de depurar é habilitado no nível de operação (para agentes de nuvem ou para agentes privados) e a operação foi executada em um agente 10.48 ou posterior, esta aba mostra os detalhes de an Integration Studio hierarquia de execução completa da operação. Quando a operação selecionada é vinculada com ações de operação, registros para operações abaixo também estão incluídos.
As operações pai (e quaisquer operações filho abaixo delas) são classificadas em ordem crescente por Iniciado. A tabela pode ser classificada (somente para operações de nível superior) por Nome, Iniciado, Concluído, Duração ou Status clicando na respectiva linha de cabeçalho.
-
Nome: O nome da operação ou etapa de operação. O triângulos de divulgação, que podem ser usados para expandir ou recolher linhas adicionais, são mostrados em operações pai e em operações para as quais dados de entrada e saída de componentes estão disponíveis:
- Operações pai: Quando 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 o recolher lista ou expanda os ícones da lista no cabeçalho da coluna para recolher ou expandir todas as operações pai.
-
Entrada/Saída: Os dados de entrada e saída acessados por meio desta parte da tabela de log são descritos em Dados de entrada e saída do componente.
-
Iniciado: A data e a hora em que a operação ou etapa de operação começou a ser executada, exibida como o horário local do navegador.
-
Concluído: A data e a hora em que a operação ou etapa de operação parou de ser executada, exibida como o horário local do navegador.
-
Duração: Tempo decorrido entre Iniciado e Concluído, relatado 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 Tabela de detalhes da operação anteriormente nesta página.
-
Ações: Estas ações estão disponíveis:
-
Cancelar operação: Habilitado para operações que estão nos 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 Cancelar Solicitado é exibido ao lado do status da operação em tempo real.
Nota
Operações que têm um status Cancelamento Solicitado ainda podem ser executadas.
-
Ir para a operação: Abra o projeto em Integration Studio, e selecione a operação.
-
-
Registro de 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 obter mais informações, consulte aba Mensagens anteriormente nesta página.
Nota
Datas e horários exibidos nas próprias mensagens de log não são convertidos para o horário local do navegador, mas são relatados em seu formato original da fonte da mensagem de log.
-
Copiar: Copia os dados de log para sua área de transferência.
-
Download: 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 depurar de operação habilitado no nível da operação (para agentes de nuvem ou para agentes privados) e a operação foi executada em um agente 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 Cloud logging enabled. Os dados de entrada e saída do componente serão registrados na nuvem Harmony mesmo se o registro na nuvem estiver desativado.
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 sob o [VerboseLogging]
seção, conjunto verbose.logging.enable=false
.
Aviso
Quando os dados de entrada e saída do componente são gerados, todos os dados de solicitação e resposta para essa 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 confidenciais, como credenciais fornecidas em uma payload de solicitação, serão visíveis em texto não criptografado nos dados de entrada e saída dentro dos logs da nuvem Harmony.
Quando dados de entrada e saída do componente estão presentes, uma coluna Entrada/Saída mostrando uma representação gráfica da operação ou etapa de operação é exibida na tabela de log da operação.
Na coluna Entrada/Saída, os ícones para atividades e transformações usadas como etapas de 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 log de entrada e saída é limitada a 100 MB. Se os dados para uma entrada de log de entrada ou saída individual excederem 100 MB, nenhum dado será exibido.
-
Pesquisar: Pesquise os dados para o texto inserido.
-
Copiar: Copia os dados de log para sua área de transferência.
-
Download: 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.
Consultas
Uma consultar é um ou mais termos de chave/valor. Vários termos são separados por ponto e vírgula. Um termo tem o formato <key><operator><value>
. Para o operation
, project
, environment
, agent
chaves, valores podem incluir um caractere curinga, %
, que corresponde a qualquer string.
Para usar uma consultar, insira uma especificação de consultar válida na barra de pesquisa e pressione Enter:
A tabela a seguir mostra os componentes de termos de consultar disponíveis:
Chave | Coluna de chave | Operadores permitidos | Valor1 |
---|---|---|---|
operation | Operação | = | Nome da operação |
project | Projeto | = | Nome do projeto |
environment | Meio Ambiente | = | Nome do ambiente |
agent | Agente | = | Nome do Agente |
status | Estado | = | Nome do status |
started | Iniciado | <= | Data/hora |
>= | |||
finished | Concluído | <= | Data/hora |
>= | |||
rootOperationInstanceGuid | Guia de instância de operação raiz | = | GUID da operação raiz |
1 Tipos de valor
- Nome do status: A string mostrada na coluna Status da tabela de detalhes da operação .
- Data/hora: formato de data
mês/dia/ano
, com horahora:minuto:segundo
opcional no formato AM/PM:- Somente data:
MM/DD/AAAA
- Data e hora (AM):
MM/DD/AAAA HH:MM:SS AM
- Data e hora (PM):
MM/DD/AAAA HH:MM:SS PM
- Somente data:
Exemplos de consulta
A seguir estão alguns exemplos de termos de consultar:
Termo de consulta | Descrição |
---|---|
operation=New Delete; | Mostrar a operação"Nova Exclusão". |
operation=New%; | Mostrar logs de operação para operações com nomes que começam com "Novo". |
project=SFDC-SAP; | Mostrar logs de operação para operações no projeto "SFDC- SAP". |
project=SFDC%; | Mostrar logs de operação para operações em qualquer projeto com nomes começando com "SFDC". |
environment=DEnv; | Mostrar logs de operação para operações implantadas no ambiente"DEnv". |
environment=DE%; | Mostrar logs de operação para operações implantadas em ambientes com nomes que começam com "DE". |
agent=Windows%; | Mostrar logs de operação para operações em execução em agentes com nomes que começam com "Windows". |
status=success; | Mostrar logs de operação para operações com status "SUCESSO". |
started>=9/12/2024; | Mostrar logs de operação para operações iniciadas em ou após 12/09/2024. |
started>=9/12/2024 11:59:00 AM; | Mostrar registros de operação para operações iniciadas em ou após 11:59 na manhã de 12/09/2024. |
finished<=10/04/2024; | Mostrar 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; | Mostrar logs de operação para operações ativas pela última vez em ou após 10/04/2024 às 13h. |
message=1201 alarm; | Mostrar logs de operação para operações que contêm a sequência de mensagens "alarme 1201". |
rootOperationInstanceGuid=0f04b6f6-4129-45dd-8388-abd19fe6a4f7; | Mostrar logs de operação para operações que são filhas da operação raiz com o GUID mostrado. |
Nota
As datas são especificadas e exibidas no fuso horário do seu navegador.
Consultas salvas
As consultas podem ser salvas e usadas, depois editadas ou excluídas, da seguinte maneira:
-
Para salvar uma consultar, clique Salvar consultar. O formulário de consultar abre:
Insira ou selecione valores para os seguintes campos e clique em Salvar:
- Nome: Um nome para a consultar.
- Consulta: Um ou mais termos de consultar 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 consultar e, em seguida, adicione um operador e um valor.
- Selecione uma das sugestões de consultar.
- Insira um termo de consultar, seguido de ponto e vírgula.
-
Colunas: Selecione as colunas a serem exibidas nos resultados da pesquisa.
Quando salvo, o formulário Consultas salvas abre:
Clique Consultas salvas para fechá-la.
-
Para usar uma consultar salva, clique em Consultas salvas, então clique na consultar que deseja executar. Os termos da consultar são copiados para a barra de consultar, e a consultar é executada automaticamente.
-
Para editar uma consultar salva, clique em Consultas salvas, clique em Ícone Editar para a consultar que você deseja editar. A consultar abre na gaveta Editar consultar:
Edite a consultar e clique em Salvar para salvá-la ou em Cancelar para cancelar.
-
Para excluir uma consultar salva, clique em Consultas salvas, clique em ícone Excluir para aquele que você deseja excluir. Uma caixa de diálogo Excluir consulta salva pede para você confirmar. Clique em Excluir para continuar ou Cancelar para cancelar.
Intervalo de tempo
A página Operações de 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
-
Hora personalizada: Selecione para abrir a caixa de diálogo Hora personalizada. Com isso, você pode filtrar as 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 uma ou ambas as datas de ou para usando o calendário.
Para definir um horário, insira a hora e o minuto (em
HH:MM
) formato e o período de tempo (AM
ouPM
).Clique em qualquer lugar na caixa de diálogo Hora personalizada para fechar o seletor de data.
Quando um ou ambos os intervalos de datas do campo estiverem definidos, clique em Aplicar. Para limpar o intervalo, clique em Limpar. Para limpar as datas de um campo, clique em seu ícone.
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 título 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 abre:
A gaveta tem 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: Salva as colunas.
- Cancelar: Fecha a gaveta de colunas sem salvar as alterações.
-
Atualizar: A tabela é atualizada automaticamente. O intervalo padrão é de 5 minutos.
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 1, 5, 15 ou 30 minutos, e clique em Salvar.
Para atualizar a tabela a qualquer momento, clique em Atualizar.