Ir para o conteúdo

Erros

Quando se trata de tarefas automatizadas, você pode mapear cenários que são possibilidades de falha, assim fazer o tratamento dessas falhas.

Usando o recurso Erros, você pode carregar informações sobre um erro, quando ele ocorre, para que os times de sustentação possam agir de forma mais certeira.

Captura de tela do Orquestrador da BotCity, apresentando o menu de Erros. A página apresenta os erros emitidos na plataforma filtrados pelo nome de uma automação em formato de tabela com as colunas: ID do erro, ID da tarefa, Data, Tipo de erro, Mensagem, Automação e Versão. Acima da tabela, campos de busca e filtros de erros. No canto superior direito, o botão Gerador de Snippet.

Gerador de Snippet

As ações de manipulação de erros podem ser realizadas diretamente na plataforma do Orquestrador BotCity ou via código, utilizando o BotCity Maestro SDK ou a BotCity Orquestrador API.

Explore o botão Gerador de Snippet para obter exemplos de código que facilitam as manipulações de erros utilizando o SDK do BotCity Maestro. Gere trechos de código para as ações: criar um erro simples e criar um erro customizado.

Os snippets gerados podem estar disponiveis nas linguagens Python, Java, JavaScript e TypeScript.

Gerador de Snippet

Emitir erros

Os erros são emitidos diretamente via código, sendo possivel disparar inumeros erros no mesmo processo, dependendo da implementação de tratamento.

Esses erros ficam registrados no Orquestrador BotCity, sempre vinculados a uma tarefa específica.

Maestro SDK

Para mais informações de como implementar a funcionalidade de erros em código, veja na seção Erros do Maestro SDK.

Visualizar erros

Existem duas formas de visualizar os erros disparados no Orquestrador BotCity.

Ao acessar Erros no menu lateral, você encontrará todos os erros disparados no Orquestrador no formato de tabela.

Você encontra as colunas:

  • ID do Erro: Número de identificação do erro como link para acessar os detalhes do erro.
  • ID da Tarefa: Número de identificação da tarefa que disparou o erro.
  • Data: Data e hora que o erro ocorreu.
  • Tipo de erro: Tipo de erro retornado pela exceção.
  • Mensagem: Mensagem da exceção referente ao erro ocorrido.
  • Automação: Nome da automação que disparou o erro.
  • Versão: Versão do robô que executou a tarefa.

Captura de tela do Orquestrador da BotCity, apresentando o menu de Erros. A página apresenta os erros emitidos na plataforma em formato de tabela com as colunas: ID do erro, ID da tarefa, Data, Tipo de erro, Mensagem, Automação e Versão. Cada página apresenta 10 itens mais recentes, com opção de selecionar a quantidade de linhas por página e botão de navegação de avançar e voltar páginas na parte inferior.

Os erros podem ser acessados através do menu Tarefas, ao acessar os detalhes de uma tarefa navegando até a aba Erros.

Você encontra as colunas:

  • ID do Erro: Número de identificação do erro como link para acessar os detalhes do erro.
  • Data: Data e hora que o erro ocorreu.
  • Tipo de erro: Tipo de erro retornado pela exceção.
  • Mensagem: Mensagem da exceção referente ao erro ocorrido.

Captura de tela do Orquestrador da BotCity, apresentando os detalhes de uma tarefa. A página apresenta o ID da tarefa como título, na aba Erros. Na tabela, os erros emitidos pela tarefa com as colunas: ID do erro, Data, Tipo de erro e Mensagem.

Detalhes do erro

Ao acessar a página de detalhes de um erro, você encontrará os blocos de informações:

  • Informações da Automação: ID da tarefa, Automação, Repositório, ID do bot, Versão, Runner e Linguagem.
  • Detalhes do Erro: Data, ID do Erro e a Mensagem retornada da exceção.
  • StackTrace: Rastreamento do erro no código.
  • Captura de tela: (opcional) Captura de tela no momento do erro.
  • Tags: (opcional) Dados de tempo de execução.
  • Anexos: (opcional) Arquivos em qualquer formato.

Erro detalhado

Nos blocos iniciais, você encontra as informações gerais sobre a automação e sobre o erro.

Captura de tela do Orquestrador da BotCity, apresentando os primeiros blocos de detalhes de um erro. A página apresenta o tipo de erro como título, abaixo os blocos de Informações da Automação: ID da tarefa, Automação, Repositório, ID do bot, Versão e Runner; Detalhes do Erro: Data, ID do Erro e a Mensagem.

StackTrace

Nesse bloco, você encontra os detalhes do rastreamento do erro no código, sendo possivel analisar a linha de código exata onde ocorreu o erro.

Captura de tela do Orquestrador da BotCity, apresentando a continuação blocos de detalhes de um erro. A página apresenta o Rastreamento do erro no código (StackTrace) no momento em que o erro ocorreu.

Captura de tela

É possivel carregar uma captura de tela no momento em que o erro ocorre. Essa informação é opcional, mas é importante para entender o que o ambiente apresenta visualmente.

Captura de tela do Orquestrador da BotCity, apresentando a continuação blocos de detalhes de um erro. Apresentando a captura de tela feita no momento em que o erro ocorreu.

Tags

As tags apresentam uma visualização rapidamente dos dados de tempo de execução.

Existem tags padrões para captura de informações sobre o ambiente de execução e tags opcionais podem ser adicionadas com qualquer informação de texto que seja relevante para o entendimento do erro.

Captura de tela do Orquestrador da BotCity, apresentando a continuação blocos de detalhes de um erro. Apresentando a tabela com as tags padrões e adicionais do erro em duas colunas: Tag e Valor.

Anexos

Nesse bloco, você tem acesso a todos os arquivos anexados no momento em que o erro ocorre.

O anexo padrão ajuda a replicar o ambiente para uma solução de problemas rápida, e com a opção de adicionar seus próprios arquivos em qualquer formato você pode entender mais facilmente o que deu errado no processo.

Captura de tela do Orquestrador da BotCity, apresentando o bloco final de detalhes de um erro. Apresentando a tabela com os arquivos anexos padrões e adicionais do erro, ao lado de cada anexo um ícone para baixar o arquivo.

Busca e filtros

É possível combinar vários filtros para fazer buscas no menu Erros, conforme as suas necessidades.

Busca por:

  • ID da tarefa: Busca pela identificação da tarefa.

Filtros disponíveis:

  • Automação: Seleciona uma ou mais automações.
  • Período: Seleciona um período (1 dia, 1 semana, 15 dias, 1 mês, 1 ano).

Ordenação:

  • Mais recente primeiro
  • Mais antigo primeiro

Gif do Orquestrador da BotCity, apresentando os filtros para busca de erros. Mostra os três campos principais disponiveis para filtro: Busca por ID de tarefa, Filtro, Ordenação.