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.

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 disparador 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é 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.