Detalhes do gatilho

Visualize detalhes do gatilho, incluindo trabalhos associados e histórico de falhas, no painel lateral do gatilho.

Selecionar um gatilho da lista abre um painel lateral com informações detalhadas sobre esse gatilho, organizado nas seguintes guias:

• Trabalhos: a lista de trabalhos iniciados pelo gatilho.
• Histórico: a lista de todas as instâncias em que um gatilho de Evento correspondeu a um registro e tentou iniciar um trabalho do Orchestrator.
• Traces: detalhes sobre eventos recebidos por meio de pesquisas ou da execução de webhooks, bem como eventos que correspondem ao gatilho selecionado.
  Observação:

  A guia Traces está disponível apenas para gatilhos de eventos.

Aba Trabalhos

Para acessar os trabalhos iniciados por um gatilho:

1. Navegue até a página Gatilhos.
2. Escolha a aba do gatilho correspondente.
3. Selecione o gatilho relevante na lista.
4. Navegue até a aba Trabalhos para exibir a lista de todos os trabalhos iniciados pelo gatilho selecionado.
   Observação:

   Você pode usar o botão Ir para Auditoria para navegar até a página Auditoria e verificar informações detalhadas para cada evento. Para obter mais informações, consulte a página Auditoria .

A tabela contém os seguintes detalhes para cada trabalho:

• Estado: o estado atual do trabalho. Para obter mais informações, consulte a página Estados de trabalho .
• Iniciado: o carimbo de data/hora quando o trabalho foi iniciado.
• Concluído: o carimbo de data/hora quando o trabalho terminou.
• Duração: o período total em que o trabalho foi executado.

Histórico

Esta seção rastreia todas as instâncias em que um gatilho de evento correspondeu a um registro e tentou iniciar um trabalho do Orchestrator.

Para acessá-lo:

1. Navegue até a página Gatilhos.
2. Escolha a aba do gatilho correspondente.
3. Selecione o botão Mais ações
4. Escolha Ver histórico na lista suspensa.
   Dica:

   Você também pode selecionar o gatilho necessário na lista e navegar até a guia Histórico no painel lateral.

Observação:

O histórico de gatilhos é excluído quando o próprio gatilho é excluído. Além disso, o histórico de gatilhos é mantido por 30 dias antes de ser removido automaticamente.

Observação:

Você pode usar o botão Ir para Auditoria para navegar até a página Auditoria e verificar informações detalhadas para cada evento. Para obter mais informações, consulte a página Auditoria .

A tabela contém os seguintes detalhes para cada gatilho:

• Tempo: mostra quando o gatilho de evento iniciou a criação do trabalho.
• Nome do evento: exibe o nome do gatilho específico.
• Status: indica se o trabalho foi iniciado com sucesso.
• Detalhes: fornece o motivo da falha para entradas com falha ; permanece em branco para trabalhos bem-sucedidos.

Tipos de erros potenciais

Confira a lista a seguir de tipos de falhas em potencial e sua descrição:

Licença ausente

Descrição: uma licença válida é exigida para iniciar trabalhos.

Solução: para continuar executando trabalhos, certifique-se de ter uma licença válida.

Licença expirada

Descrição: a licença expirou.

Solução: para continuar executando trabalhos, você precisa renovar sua licença.

Desabilitado: falhas no trabalho

Descrição: o gatilho foi desabilitado devido a pelo menos duas falhas de trabalhos consecutivas.

Solução: você pode configurar esse ajuste usando a opção Desabilitar quando a execução consecutiva do trabalho falhar na contagem ao criar ou editar um gatilho.

Desabilitado: falhas consecutivas

Descrição: o gatilho foi desabilitado após falhar na criação de trabalhos um número específico de vezes dentro de um número definido de dias.

Solução: por padrão, isso ocorre após 10 falhas em 1 dia. Você pode configurar esse limite usando os campos Gatilhos - Desabilitar quando a contagem de falhas na criação de trabalhos e Gatilhos - Período de cortesia quando a criação de trabalhos mantém a contagem de falhas (dias) em conjunto a partir da página Configurações do tenant. Para obter mais informações, consulte a página Configurações .

Tarefas Pendentes

Descrição: já há trabalhos pendentes.

Solução: certifique-se de que a execução do processo não esteja com falha, fazendo com que o trabalho permaneça no estado pendente. Você também pode revisar a lista de trabalhos pendentes e reduzir o número de trabalhos, se necessário. Para obter mais informações, verifique a página Gerenciamento de trabalhos .

Erro ao disparar

Descrição: o gatilho não conseguiu criar trabalhos.

Criação de trabalho parcial

Descrição: apenas alguns trabalhos do número total de solicitações foram criados porque já havia alguns trabalhos pendentes.

Solução: certifique-se de que a execução do processo não esteja com falha, fazendo com que o trabalho permaneça no estado pendente. Você também pode revisar a lista de trabalhos pendentes e reduzir o número de trabalhos, se necessário. Para obter mais informações, verifique a página Gerenciamento de trabalhos .

O trabalho de teste não é compatível

Descrição: os trabalhos de automação de testes não são suportados por APIs de trabalhos padrão.

Robô não encontrado

Descrição: nenhum robô foi localizado na pasta para executar este trabalho.

Solução: certifique-se de que um robô seja provisionado na pasta de destino. Para obter mais informações sobre como criar uma configuração que permita que você execute trabalhos em pastas, consulte a página Gerenciamento de robôs .

Unattended robot não encontrado

Descrição: nenhum usuário com um Unattended Robot foi localizado.

Solução: certifique-se de que um robô seja atribuído a um usuário na pasta. Para obter mais informações sobre como atribuir um robô, consulte a página Gerenciamento de robôs .

Gatilho desabilitado

Descrição: o gatilho não está habilitado.

Solução: selecione o botão Mais ações no gatilho correspondente e, em seguida, Habilitar. Um gatilho de tempo habilitado é marcado pelo ícone na frente dele. Um gatilho de fila habilitado é marcado pelo em frente a ele.

O usuário não tem nenhum robô

Descrição: o usuário não tem um robô para disparar o evento.

Solução: atribuir um robô ao usuário na pasta apropriada.

Processo não encontrado

Descrição: o processo associado ao trabalho não pôde ser encontrado.

Solução

• Verifique se o processo está publicado.
• Verifique se o processo foi criado. Se o processo existir como um pacote, você precisa criar um processo correspondente dentro do Orchestrator
• Verifique se o robô está conectado e disponível no Orchestrator.

Nenhuma máquina disponível

Descrição: nenhuma máquina compatível com runtimes foi localizada.

Solução: certifique-se de que:

• As máquinas não estão ocupadas.
• As máquinas têm as licenças exigidas.
• As máquinas estão configuradas corretamente para o trabalho.

O usuário não tem robôs

Descrição: o usuário não tem um Unattended Robot atribuído.

Solução: atribua um robô não assistido ao usuário. Para obter mais informações sobre como atribuir um robô, consulte a página Gerenciamento de robôs .

Credenciais de robô ausentes

Descrição: credenciais ausentes para o Unattended Robot.

Solução: adicione credenciais dependendo do método de autenticação escolhido. Para obter mais informações sobre como as credenciais dos Robots funcionam, consulte a página Autenticação dos Robots com Credenciais do Cliente .

Retorno de chamada não habilitado

Descrição: o gatilho requer um retorno de chamada que não está habilitado.

Solução: acesse o gatilho da API e habilite o retorno de chamada.

Configuração de gatilho incorreta

Descrição: solicitações usando o método HTTP GET não podem incluir um cabeçalho Content-Type de tipo form ou json.

Solução: ajuste a configuração do gatilho para estar em conformidade com os padrões do método HTTP.

Traces

Importante:

As informações exibidas na guia Traces estão disponíveis apenas para a versão mais recente do gatilho. Quando você edita um gatilho, os traces disponíveis para a versão anterior não estarão mais visíveis na guia Traces.

A aba Traces fornece visibilidade sobre execuções de pesquisa ou eventos de webhook recebidos para um gatilho de evento, incluindo detalhes sobre eventos recuperados e quais deles correspondem aos critérios do filtro do gatilho.

Para acessar detalhes de pesquisas ou execuções de webhook e informações de eventos:

Observação:

Essa guia está disponível apenas para gatilhos de Evento.

1. Navegue até sua Automação.
2. Selecione Gatilhos.
3. Escolha a aba Gatilhos de eventos.
4. Selecione o Gatilho de evento.

O painel lateral é exibido com as guias Trabalhos, Histórico e Traces .

A grade Traces exibe uma lista cronológica de registros de execução de gatilhos.

• Para gatilhos de pesquisa, cada entrada representa uma execução do pesquisador.
• Para gatilhos de webhook, cada entrada representa um evento de webhook recebido.

Cada entrada inclui a hora de início da execução e seu resultado, permitindo que você revise a atividade do gatilho por um período específico.

Detalhes dos traces

Quando você seleciona uma entrada de trace, um painel Detalhes é exibido no lado direito, com informações agrupadas em Dados do evento e Trabalhos correlacionados.

Dados do evento

Detalhes do gatilho — as seguintes informações estão disponíveis:

• traceId: um identificador exclusivo para a tentativa de execução do gatilho.
• triggerId: um identificador exclusivo para o gatilho.
• timestamp: a data e hora em que a execução da pesquisa ou evento do webhook ocorreu.
• nome: o nome do gatilho.
• TipoDeEvento: o tipo de evento que iniciou o gatilho (por exemplo, FILE_CREATED).
• ObjectName: o tipo de registro para o qual o gatilho está configurado, por exemplo, um contato ou conta.
• FilterExpression: a expressão de filtro aplicada ao evento, conforme configurado para o gatilho.
• InputArguments: os argumentos de entrada do pacote.
• ConnectionId: um identificador exclusivo da conexão à qual o gatilho pertence.
• processKey: um identificador exclusivo do processo.

Resposta — contém a carga recebida do provedor, incluindo informações sobre o corpo da carga e parâmetros de consulta.

Resultado do filtro — mostra quais dados corresponderam ou não com base em qualquer filtro de dados configurado no gatilho.

Observação:

Apenas os campos que fazem parte do filtro são mostrados, não a carga inteira.

Trabalhos correlacionados

Esta seção exibe informações sobre os trabalhos que o gatilho iniciou, com links para navegar até eles.

Observação:

Pode haver mais de um trabalho nesta seção, porque uma execução de pesquisador pode capturar muitos eventos, e cada evento correspondente inicia um novo trabalho no Orchestrator.