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 pesquisas ou da execução de webhooks, bem como eventos que correspondem ao gatilho selecionado.
  Observação: a aba 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 do 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 aba Histórico no painel lateral.

Observação: o histórico do gatilho é excluído quando o próprio gatilho é excluído. Além disso, o histórico do gatilho é retido 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 criação do trabalho falhar na contagem e Gatilhos - Período de carência quando a contagem de falhas continua na criação do trabalho (dias) em conjunto na 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, consulte 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, consulte 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ô esteja 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ô esteja 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 em frente a ele. 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 Unattended Robot 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 do robô funcionam, consulte a página Autenticação do Robô 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: as solicitações que usam o método HTTP GET não podem incluir um cabeçalho Content-Type do 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: esta guia está disponível apenas para gatilhos de eventos.

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 aba 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:

• TriggerDetails: as seguintes informações estão disponíveis para cada trace:
  • traceID: um identificador exclusivo para a tentativa de execução do gatilho.
  • Carimbo de data/hora: a data e a hora em que a execução de pesquisa ou o evento do webhook ocorreu.
  • status: indica se a execução do gatilho foi Bem-sucedida ou com Falha.
  • 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).
  • FiltrarExpressão: a filtragem de expressão aplicada ao evento, conforme configurada 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 de pesquisas ou tratamento de webhooks.
    • 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 quando o evento foi criado.

    • Atualizado: o carimbo de data/hora de quando o evento foi atualizado pela última vez.

• DataFilter: quando os eventos são recebidos, esta seção exibe como os eventos recuperados foram avaliados em relação à expressão do filtro de gatilho.
  • Correspondentes: o número de eventos que correspondem aos critérios do filtro de gatilho.
    • ID
    • Criado
    • atualizou
  • Não correspondentes: o número de eventos que não correspondem aos critérios do filtro de gatilho.