Registros de Operação¶
Introduçã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.
Os logs de operação, incluindo mensagens de log detalhadas de agentes de nuvem e agentes privados, e dados de entrada e saída de componentes dentro dos logs de operação, são retidos por 30 dias pelo Harmony.
Os logs de operação também podem ser visualizados no Management Console Operações de tempo de execução página.
Importante
Por padrão, operações de API bem-sucedidas (configuradas para APIs personalizadas ou serviços OData) não estão incluídos nos registros de operação a menos que uma destas configurações esteja habilitada:
EnableLogging=true
no [APIoperation]
seção do arquivo de configuração do agente privado. Logs de Operação de Acesso¶
Os logs de operação podem ser acessados no Cloud Studio no nível do projeto, workflow ou operação. Dependendo de onde eles são acessados, a tela de log de operação inclui um máximo de 1.000 logs para um determinado período de tempo para operações que foram executadas em um projeto, em um workflow específico ou para uma operação específica, respectivamente. Se as operações forem vinculadas com ações de operação, registros para operações abaixo também estão incluídos.
Por Projeto¶
A opção Exibir Logs para um projeto, que mostra logs para operações que foram executadas dentro de um projeto, pode ser acessada a partir destes locais:
- A página Projetos (veja Exibição de cartão ou Visualização de lista em Projetos).
- A barra de ferramentas do projeto (veja menu de ações do projeto em Barra de ferramentas do projeto).
Por Workflow¶
A opção Exibir Logs para um workflow, que mostra logs para operações que foram executadas dentro de um workflow específico, pode ser acessada na aba Workflows do painel do projeto (consulte menu de ações do Workflow na aba Workflows do painel Projeto).
Por Operação¶
A opção Exibir logs para uma operação pode ser acessada nestes locais:
- A aba Workflows do painel do projeto (consulte menu de ações do componente na aba Workflows do painel Projeto).
- A aba Componentes do painel do projeto (consulte menu de ações do componente na aba Componentes do painel Projeto).
- A quadro de design (veja menu de ações do componente em Tela de design).
Além disso, após executar uma operação manualmente, você pode clicar no status da operação na quadro de design para exibir os logs (consulte Status da operação em Implantação e execução da operação).
Visualizações do Log de Operação¶
A tela de log de operação tem duas visualizações: tela cheia e gaveta. A visualização que é exibida depende de onde os logs são acessados:
-
Tela cheia: Ao visualizar logs por projeto, a visualização em tela cheia é carregada, com a tela de log de operação sendo carregada em uma nova aba:
- Nome do projeto: O nome do projeto (após o texto Log para:) é listado na parte superior da tela de registro de operação.
- Fechar: Para retornar à tela anterior, clique no ícone de fechar.
-
Gaveta: Ao visualizar logs por workflow ou operação, uma gaveta de log de operação é aberta na parte inferior do designer de projeto para manter seu contexto no projeto:
- Guias: As guias na parte superior da gaveta de logs de operação são rotuladas com Registro seguido pelo nome da operação ou workflow (dependendo de onde os logs foram acessados). Quando você acessa logs adicionais, novas guias são adicionadas. Para reordenar as guias, arraste e solte uma aba. Para fechar uma aba, clique em seu ícone de fechamento. Fechando a última aba ou usando o ícone mais à direita ícone de fechamento fecha a gaveta de log.
- Redimensionar: A barra ao longo da parte superior da gaveta de log pode ser usada para redimensionar a gaveta de log. Passe o mouse sobre a barra e arraste o redimensionar ícone para cima ou para baixo para redimensionar a gaveta de log.
- Recolher: Recolhe a gaveta de logs para que todos os logs fiquem ocultos. Depois de recolhido, clique no ícone de retorno para retornar à visualização anterior.
- Expandir: Expande a gaveta de log para tela cheia para que quaisquer logs adicionais sejam exibidos. Uma vez expandido, clique no ícone de retorno para retornar à visualização anterior.
- Abrir em uma nova aba: Abre a visualização do log de operação em tela cheia em uma nova aba.
- Fechar: Fecha a gaveta de log.
As informações no restante do corpo dessas visualizações são as mesmas em ambas as visualizações e são abordadas nas subseções a seguir.
Controles da Tabela de Log de Operação¶
Ambas as telas de log de operação visualizações têm os mesmos controles na parte superior da tabela de registro de operação, incluindo um filtro para período de tempo, capacidade de atualizar a tabela de log, um filtro em status da operação, e uma caixa de pesquisa.
Prazo¶
Para um determinado período de tempo, um máximo de 1.000 logs são incluídos na tabela de logs de operação.
Por padrão, o Intervalo de tempo de início é configurado para que as últimas 24 horas de logs desde a última execução de uma operação sejam exibidas:
A data e a hora para seleção do intervalo de tempo usam o horário local do navegador. Passe o mouse sobre a dica de ferramenta Intervalo de tempo de início para ver o fuso horário local do navegador:
Para alterar o período de tempo pelo qual os logs são filtrados, clique em um campo Start time range para abrir o seletor de data/hora. Em seguida, use os controles dentro do seletor para ajustar a data e/ou hora:
-
Mês: O mês atual é usado por padrão. Use o setas para navegar para um mês diferente.
-
Ano: O ano atual é usado por padrão. Clique no ano e use o setas para navegar para um ano diferente. Em seguida, selecione o mês desejado do ano no seletor de mês. Selecionar um mês retorna você ao seletor de data/hora.
-
Dia: Selecione o dia desejado no calendário.
-
Hora: Use os controles deslizantes para ajustar a hora (controle deslizante superior) e os minutos (controle deslizante inferior).
Atualizar¶
Os logs iniciais são exibidos com base na data e hora em que a última operação foi executada, conforme exibido na parte superior da tabela. Os logs são atualizados automaticamente a cada cinco segundos se qualquer operação ainda estiver em um estado de execução (status de Recebido, Enviado, Pendente ou Em execução). A data e a hora em que a exibição foi atualizada pela última vez são relatadas abaixo do Intervalo de tempo de início:
Você também pode atualizar manualmente os logs a qualquer momento para exibir informações atualizadas. Para atualizar manualmente os logs, clique em Atualizar no canto superior direito:
Status¶
A tabela pode ser filtrada por status da operação conforme descrito abaixo. Status da etapa da operação também está listado na tabela.
Status da Operação¶
Para filtrar logs por status de operação, use o menu no canto superior direito:
-
Tudo: Todas as operações são exibidas independentemente do status.
-
Erro: Se o agente concluir a execução de uma operação, mas houver um erro fatal na gravação no sistema de destino, ou houver um erro fatal de validação na transformação, ou a lógica de transformação tiver acionado o
RaiseError
função, então o status da operação é definido como Erro e a execução da operação é encerrada. -
Falha SOAP: Se o agente concluir a execução de uma operação e o resultado for uma falha SOAP, o status será definido como Falha SOAP. Esse status é aplicável somente para operações que usam Salesforce, Salesforce Service Cloud, ServiceMax, SOAP, ou Workday atividades.
-
Enviado: Quando as operações são enviadas para a fila Harmony, mas ainda não foram selecionadas por um agente para execução, elas têm um status Enviado. As operações podem ser enviadas por vários meios:
- Serviço de agendamento Jitterbit ou serviço de agendamento externo
- Execução manual da operação no Cloud Studio
- Um
RunOperation
função de um script ou transformação - Qualquer ferramenta, incluindo
JitterbitUtils
, que chama a API Harmony
-
Recebido: Depois que um agente é escolhido e o agente reconhece que recebeu a solicitação para executar uma operação, o status é alterado para Recebido.
-
Pendente: Depois que uma operação é agendada para ser executada no mecanismo de operação de um agente, o status é alterado para Pendente. As operações não devem ficar no status Pendente por longos períodos, pois os agentes devem pegar a solicitação e começar a executar as operações em um curto espaço de tempo.
-
Em execução: Assim que o agente começar a executar uma operação, o status deve mudar para Em execução. As operações permanecem nesse status até que sejam concluídas ou encontrem um erro. O agente começa a registrar mensagens geradas pela operação conforme ela é executada para que os usuários possam rastrear qual parte da operação está sendo executada no momento.
-
Cancelamento Solicitado: Indica que uma solicitação para interromper a operação foi enviada. Se um usuário quiser interromper uma operação que esteja no status Enviado, Recebido, Pendente ou Em Execução, ele pode fazer isso a partir destes locais:
- A operação (veja status da operação em Tela de design).
- A tabela de log de operação.
- As Operações de Tempo de Execução página do Management Console (veja Cancelamento de operações de tempo de execução).
Alternativamente, eles podem habilitar outra operação para cancelar uma operação usando uma combinação de
GetOperationQueue
eCancelOperation
funções. Uma vez que um cancelamento é solicitado, o status da operação muda para Cancelamento Solicitado. Uma operação não deve permanecer neste status por muito tempo, pois o agente deve cancelar a operação em um período de tempo relativamente curto. -
Cancelado: Quando um agente cancela uma operação, ele define o status como Cancelado e a operação é encerrada. Todas as informações de log até o ponto de cancelamento estão disponíveis para revisão nas mensagens de log para que você saiba em que ponto a operação foi cancelada.
-
Sucesso: Uma vez que um agente conclui a execução de uma operação, se o resultado foi um sucesso sem avisos do sistema de destino, ou aviso escrito na transformação usando o
WriteToOperationLog
função, então o status é definido como Sucesso. -
Sucesso com informações: Se o agente concluir a execução de uma operação, mas houver problemas não fatais na transformação ou na publicação no sistema de destino ou no
WriteToOperationLog
a função foi usada para escrever mensagens no log, então o status é definido como Sucesso com Info. Isso alerta o usuário para verificar informações nas mensagens de log. -
Sucesso com Aviso: Se o agente concluir a execução de uma operação, mas houver problemas não fatais na transformação ou na publicação no sistema de destino, e houver um aviso, o status será definido como Sucesso com Aviso. Isso alerta o usuário para verificar se há avisos 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: Se o agente concluir a execução bem-sucedida de uma operação, mas dentro de uma ou mais operações filho, houve um erro fatal na gravação no sistema de destino, ou houve um erro fatal de validação na transformação, ou a lógica da transformação acionou o
RaiseError
function, então o status da operação é definido como Success with Child Error. Esse status não se aplica a operações assíncronas. -
Status Atrasado: Se o agente não retornar um log de operação por qualquer motivo, Status Atrasado será exibido. O Harmony tentará buscar logs seis vezes, com um tempo limite de 10 segundos entre cada chamada. Atualize ou verifique os logs novamente mais tarde. Você não pode filtrar operações com Status Atrasado, mas pode vê-las nos logs de operação.
Status da Etapa da Operação¶
As etapas da operação aparecem somente quando a 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.
As etapas da operação podem ter estes possíveis status:
- 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 que a etapa de operação está aguardando para ser executada ou que houve um erro em uma etapa de operação anterior impedindo a execução da etapa seguinte.
Procurar¶
Clique no ícone de pesquisa para mostrar uma caixa de pesquisa para inserir palavras-chave no formato especificado a serem pesquisadas na tela de log de operação.
Um símbolo de porcentagem (%
) pode ser usado como curinga no início e/ou no final de uma palavra-chave.
Por Projeto Ou Workflow¶
Ao visualizar logs para todo o projeto ou para um workflow, você pode pesquisar pelo nome da operação ou pela mensagem na tela de log da operação:
- Operação: As pesquisas pelo nome da operação devem ser especificadas no formato de
operation=keyword
. - Mensagem: As pesquisas por mensagem devem ser especificadas no formato de
message=keyword
.
Apenas uma única palavra-chave de operação e uma única palavra-chave de mensagem são suportadas. Quando uma palavra-chave de operação e uma palavra-chave de mensagem são fornecidas, as palavras-chave são tratadas como uma combinação; ou seja, os logs de operação são retornados que correspondem ambas à palavra-chave de operação e à palavra-chave de mensagem.
Por Operação¶
Ao visualizar logs de uma única operação, você pode pesquisar somente pela mensagem do log de operação:
- Mensagem: As pesquisas por mensagem devem ser especificadas no formato de
message=keyword
.
Dica
Para recursos adicionais de pesquisa de log, você também pode visualizar logs por meio de Operações de tempo de execução página do Management Console.
Tabela de Log de Operação¶
A tabela de log de operação exibe os logs de operação usando os controles de tabela selecionados. Se as operações estiverem vinculadas 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 Hora de Início. A tabela pode ser classificada (somente para operações de nível superior) por Nome, Hora de Início, Hora de Conclusão ou Duração clicando na respectiva linha de cabeçalho.
São exibidas no máximo 250 linhas de operação. Para visualizar logs de operações adicionais, ajuste os filtros adequadamente ou use o Management Console Runtime Operations página, que não tem o limite de 250 logs.
Dica
A configuração básica do que está incluído em um log de operação é especificada na aba Opções das configurações de operação (consulte Opções de operação). Veja outras opções de registro (para agentes de nuvem ou para agentes privados).
-
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.
-
Operação com dados de entrada e saída: Quando uma operação com dados de entrada e saída é expandida, linhas adicionais para cada etapa de operação aparecem na ordem em que foram executadas. Mais informações são fornecidas em Dados de entrada e saída do componente.
-
-
Entrada/Saída: Esta coluna é exibida somente quando a tabela contém uma operação que 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. 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.
-
Hora de início: 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.
-
Hora de conclusão: A data e a hora em que a operação ou etapa de operação parou de ser executada, exibida como hora local do navegador.
-
Duração: Tempo decorrido entre Hora de início e Hora de conclusão, 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 Status anteriormente nesta página.
-
Cancelar: Para operações que estão em status Enviado, Recebido, Pendente ou Em execução, um botão Cancelar é exibido ao lado do status:
Clique em Cancelar para enviar uma solicitação ao agente para interromper a operação. Clicar em Cancelar envia uma solicitação ao agente para interromper a operação e um status Cancelamento Solicitado é exibido ao lado do status da operação em tempo real:
Nota
As operações com status Cancelamento Solicitado ainda podem ser executadas.
-
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 (se houver):
-
Registros de origem: Uma contagem de registros que foram lidos do sistema de origem.
-
Registros de destino: Uma contagem de registros que foram publicados no sistema de destino.
-
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 a seção Mensagens de log no Management Console Operações de Tempo de Execução documentação da página.
Em certas circunstâncias, um botão Tentar novamente pode ser exibido, abordado em Repetição da operação, abaixo.
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. Quando clicado, um ícone da área de transferência é exibido temporariamente.
-
Fechar: Oculta o log de operação.
-
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 Habilitar registro em nuvem. 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.
-
Copiar: Copia os dados de log para sua área de transferência. Quando clicado, um ícone da área de transferência é exibido temporariamente.
-
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.
Operação de Repetição¶
Se uma operação falhar com um erro relacionado a dependências de arquivo, esse problema pode ser resolvido ressincronizando o projeto entre o agente e o Harmony. Nesse cenário, um botão Tentar Novamente aparece no log de operação:
Ao clicar em Tentar novamente, o projeto é ressincronizado entre o agente e o Harmony.
Após a ressincronização ser concluída, a execução da operação é automaticamente repetida. Em casos em que uma operação pai ou filho falhou, toda a cadeia de operação é repetida do nível superior para todas as operações abaixo.
Se bem-sucedido, um status de sucesso é exibido no novo log de operação. Se a operação falhar novamente, tentativas adicionais de sincronizar o agente não ajudarão e o motivo da falha pode ser devido a outra coisa (entre em contato com suporte Jitterbit para assistência).