Detalhes do gatilho

Você pode selecionar um gatilho da lista para verificar informações detalhadas relacionadas àquele gatilho. Após selecionado, um painel lateral é exibido com duas abas:

• Trabalhos: você pode verificar a lista de trabalhos iniciados pelo gatilho.
• Histórico: você pode verificar a lista de todas as instâncias quando o gatilho falhou ao iniciar trabalhos.
• Traces: você pode visualizar detalhes sobre eventos recebidos por meio de pesquisa ou execução de webhook, bem como eventos que corresponderam 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 do gatilho

Para acessar a lista de todas as instâncias quando o gatilho falhou ao iniciar trabalhos:

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: o carimbo de data/hora quando o gatilho falhou ao criar trabalhos.
• Tipo de falha: o tipo de falha.
• Descrição: uma breve descrição da falha.

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.

Solution: select the More Actions button on the corresponding trigger, and then Enable. An enabled time trigger is marked by the icon in front of it. An enabled queue trigger is marked by the in front of it.

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é a página Gatilhos.
2. Escolha a aba Gatilhos de eventos.
3. Selecione o botão Mais ações
4. Escolha Exibir traces na lista suspensa.
   Dica:

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

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, o painel Detalhes é exibido com as seguintes informações:

• Detalhes do gatilho: as seguintes informações estão disponíveis para cada trace:
  • traceID: um identificador exclusivo para a tentativa de execução do gatilho.
  • timestamp: a data e hora em que a execução da pesquisa ou evento do webhook ocorreu.
  • status: indica se a execução do disparador foi Bem-Sucedida ou Falhou.
  • dataReceived: indica se os dados do evento foram recebidos durante a execução do gatilho.
  • nome: o nome do gatilho.
  • TipoDeEvento: o tipo de evento que iniciou o gatilho (por exemplo, FILE_CREATED).
  • FilterExpression: a expressão de filtro aplicada ao evento, conforme configurado para o gatilho.
• Dados: fornece detalhes técnicos sobre como os eventos foram recuperados e processados durante a execução selecionada.
  • Solicitação: contém informações sobre a solicitação usada para recuperar eventos durante a execução da pesquisa ou processamento do webhook.
    • consulta: os parâmetros de consulta usados para a execução da pesquisa.
    • caminho: o caminho (URL) para o qual a solicitação foi enviada.
  • Resposta: uma matriz de eventos recebidos da origem do evento durante a execução.
    • ID: o identificador exclusivo do evento.
    • Criado: o carimbo de data/hora de quando o evento foi criado.
    • Atualizado: o carimbo de data/hora de quando o evento foi atualizado pela última vez.
• FiltroDeDados: quando os eventos são recebidos, essa seção exibe como os eventos recuperados foram avaliados em relação à expressão de filtro do gatilho.
  • Correspondido: o número de eventos que corresponderam aos critérios do filtro de gatilho.
    • ID
    • Criado
    • atualizou
  • Não correspondente: o número de eventos que não corresponderam aos critérios do filtro de gatilho.