Página de operações de tempo de execução no Management Console Jitterbit
Introdução
A página Operações de Tempo de Execução é uma tabela de registros 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, e se o registro em nuvem está habilitado. Quando o registro 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 na 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 estão identificadas na imagem abaixo:
Lenda
①Alternar visualização da árvore de execução ② Ícone Configurações da página ③Barra de pesquisa
④Menu de intervalo de tempo
⑤ Ícones Salvar Consulta e Consultas Salvas
⑥ Ícones Atualização de tabela e Filtrar colunas
⑦Tabela de detalhes da operação
⑧Ferramentas do Paginador
Tabela de detalhes da operação
As colunas disponíveis são os seguintes:
-
Operação: O nome do Integration Studio ou Design Studio operação. Se uma operação tiver filhos, clique em Expanda o ícone para revelar a cadeia inteira. Clique em um Ícone Minimizar para recolher uma operação e seus filhos.
-
Projeto: O nome do projeto onde a operação está sendo executada.
-
Agente: O agente nome.
-
Ambiente: O nome do ambiente a operação foi implantada.
-
Status: O status da operação, um dos seguintes:
- Enviado: Uma operação foi enviada para a fila 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 de cancelamento da operação foi feita. As operações podem apresentar este status e continuar em execução 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
O 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 o Integration Studio SOAP ou Salesforce endpoints ou Design Studio serviços web ou Salesforce endpoints.)
Se uma operação tiver registro de depurar de operação habilitado no nível de operação e a operação foi executada em um agente 10.48 ou posterior, a coluna Status na aba Registro de depuração mostra o status da etapa de operação:
- Concluído: A etapa de operação foi executada e concluída sem erros.
- Erro: A etapa de operação foi executada, mas não pôde ser concluída devido a um erro.
- Incompleto: A etapa de operação não foi executada ou concluída. Possíveis motivos para esse status incluem: a etapa de operação está aguardando execução ou ocorreu um erro em uma etapa de operação anterior, impedindo a execução da etapa seguinte.
-
Iniciado: O horário em que a operação foi solicitada.
- Concluído: A hora em que o status da operação foi alterado pela última vez.
- ID da operação: O identificador global exclusivo (GUID) da operação. (Esta coluna está oculta por padrão.)
-
Guia de Instância de Operação Raiz: O identificador global exclusivo (GUID) da operação raiz (nível superior) da operação. Este campo fica vazio para operações raiz, e a coluna fica 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 posteriormente.
-
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 Enviada, Recebida, Pendente ou Em execução.
- Ir para a 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 entre 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 registro de operação, selecione um na tabela. Uma gaveta é aberta na parte inferior da janela com quatro abas: Mensagens, Registros de atividades, Arquivos de depuração e Registro de Depuração.
Aba Mensagens
Esta aba mostra o seguinte:
-
Registros de origem: Ao usar um FTP ou Banco de Dados atividade como fonte, 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 um FTP ou Banco de Dados atividade como alvo, 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 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 pela Operação de Invocação (Beta) ferramenta (quando Levantar erro se a operação falhar estiver habilitado) ou o
WriteToOperationLog()
função.
Para ver as mensagens de log de uma operação na aba Mensagens, o seguinte deve ser verdadeiro:
- Você deve ser membro de uma papel com, no mínimo, permissão de Leitura da organização e acesso ao ambiente de Execução. (Um nível de acesso ao ambiente de Exibição de 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 a configuração da sua 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 logs de atividades estão desabilitados para agentes de nuvem. Você pode ver links para download dos logs de atividades dos agentes de nuvem, mas qualquer tentativa de baixar os 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 Integration Studio selecionado ou Design Studio operações executadas 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 da hierarquia de execução completa de uma operação do Integration Studio. Quando a operação selecionada estiver vinculada a ações da 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 (apenas 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 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 hora local do navegador.
- Concluído: A data e a hora em que a operação ou etapa de operação parou de ser executada, exibidas como hora local do navegador.
- Duração: Tempo decorrido entre Iniciado e Concluído, relatado em segundos para operações e em milissegundos para etapas da operação.
- Status: O status da operação ou etapa de operação. Para obter uma lista completa dos status possíveis, 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 em 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
Operações com status Cancelamento Solicitado ainda podem ser executadas.
-
Ir para a operação: Abra o projeto no 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. A exibição das mensagens de log 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
As datas e horas exibidas nas 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 a 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 Registro na nuvem habilitado. 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, estarão visíveis em texto não criptografado nos dados de entrada e saída nos registros 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 registro da operação.
Na coluna Entrada/Saída, os ícones de 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 aquela 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.
- Pesquisar: Pesquisar os dados do texto inserido.
- Copiar: Copia os dados do log para a 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 é composta por um ou mais termos-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:
Quando a alternância Visualização da árvore de execução está habilitada, uma consultar usando o operation
chave (descrita abaixo) retorna resultados para a hierarquia completa de quaisquer operações pai ou filho vinculadas à operação. A sequência de palavras-chave é destacada em azul nos resultados. Quando a opção Visualização em árvore de execução está desabilitada, apenas as operações correspondentes à consultar são retornadas.
A tabela a seguir mostra os componentes dos 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 root |
1 Tipos de valor
- Nome do status: A sequência de caracteres mostrada na coluna Status da tabela de detalhes da operação .
- Data/hora: formato de data
mês/dia/ano
, com horáriohora: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 que comecem 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 as últimas operações ativas em ou antes de 10/04/2024. |
finished>=10/04/2024 01:00:00 PM; | Mostrar logs de operação para as últimas operações ativas 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 em Salvar consultar. O formulário de consultar será aberto:
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 exibir uma lista de termos de pesquisa disponíveis. Selecione um para inseri-lo no campo de consultar e adicione um operador e um valor.
- Selecione uma das sugestões de consultar.
- Insira um termo de consultar, seguido por um ponto e vírgula.
-
Colunas: Selecione as colunas a serem exibidas nos resultados da pesquisa.
Após salvar, o formulário Consultas salvas será aberto:
Clique Consultas salvas para fechá-las.
-
Para usar uma consultar salva, clique em Consultas salvas e 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 é aberta na gaveta Editar consultar:
Edite a consultar e clique em Salvar para salvá-la ou Cancelar para cancelar.
-
Para excluir uma consultar salva, clique em Consultas salvas, depois clique em Ícone Excluir para a consulta que você deseja excluir. A caixa de diálogo Excluir Consulta Salva solicitará sua confirmação. Clique em Excluir para continuar ou em Cancelar para cancelar.
Intervalo de tempo
A página Operações de Tempo de Execução retorna o período 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
-
Horário personalizado: Selecione para abrir a caixa de diálogo Horário personalizado. Com isso, você pode filtrar as operações com base nas datas dos campos Iniciado e Concluído:
Clique em Ícone de calendário para abrir um seletor de data para um campo:
Defina uma ou ambas as datas de ou até 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 datas.
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 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 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.
- Exibir: A coluna está oculta. Clique para exibi-la.
- Salvar: Salva as colunas.
- Cancelar: Fecha 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. A gaveta Configurações abre:
Selecione um intervalo de atualização automática, um dos seguintes: Nunca (padrão), 1 minuto, 5 minutos, 15 minutos ou 30 minutos, e clique no botão Salvar.
Para atualizar a tabela a qualquer momento, clique em Atualizar.