Tutorial sobre criação de um sistema centralizado de tratamento de…
INEMA
Logger`. 8. Cuidar para o logger não ter erros internos. 9. Facilita manutenção e análise de múltiplos fluxos. 10. Pode ser usado para dezenas de workflows diferentes com 1 único logger.
Resumo Geral:⌗
O vídeo ensina como criar um fluxo de tratamento centralizado de erros no n8n. A ideia é que qualquer workflow ativo que apresentar erro, dispare um workflow específico de captura de erro, que registra o erro em uma planilha do Google Sheets e envia uma notificação por Slack ou e-mail. É possível associar esse fluxo de erro a múltiplos workflows.
Passo a Passo com Exemplos⌗
- Criar Workflow de Teste com Erro - Configure um fluxo com um trigger (ex: Telegram). - Adicione uma ação que pode falhar propositalmente (ex: modelo de chat sem configuração). - Ative esse fluxo.
Exemplo: - Workflow: “Ultimate Assistant” - Trigger: Telegram - Erro proposital: remover modelo de chat
- Criar Workflow de Tratamento de Erro (Error Logger)
- Crie novo fluxo chamado
Error Logger. - Primeiro nó:Error Trigger(não precisa configurar nada).
Esse nó escuta qualquer erro de fluxo ativo vinculado a ele.
- Vincular Workflow Principal ao Workflow de Erro
- Vá nas configurações do workflow principal.
- Configure o campo “Error Workflow” com o nome do fluxo
Error Logger.
Assim, sempre que o workflow principal falhar, o n8n executa automaticamente o workflow de erro.
- Registrar o erro em uma Planilha Google
- Adicione o nó “Google Sheets”.
- Ação:
Append Row. - Configure colunas para:- Timestamp (
{{$now}}com formatação opcional) - Nome do Workflow
- URL do Workflow
- Nome do Node que causou erro
- Mensagem do Erro
- Timestamp (
Exemplo de planilha:
| Timestamp | Workflow Name | URL | Node | Error Message |
|---------------------|---------------------|-------------------------------------|-------------------|----------------------------------------|
| 2025-04-22 18:20:33 | Ultimate Assistant | https://n8n.io/workflow/1234... | ChatModel | Chat model subnode must be connected. |
- Notificação por Slack (ou e-mail) - Adicione o nó “Slack” com ação “Send Message”. - Configure o canal (ex: #errors). - Monte a mensagem com expressões: ``` Workflow Error: {{$json["workflow"]["name"]}} Node: {{$json["node"]["name"]}} Time: {{$now}} Message: {{$json["error"]["message"]}} Ver execução
``` - Desative a opção “Include link to workflow” para evitar o texto padrão do n8n.
-
Exemplo de Disparo Real - Enviar mensagem “Hey” no Telegram. - Com erro proposital (sem modelo de chat), o workflow principal falha. - O Er
ror Logger éativado automaticamente. - Uma nova linha aparece na planilha. - Notificação aparece no Slack. -
Erros que NÃO Disparam o Workflow de Erro ** - Se o fluxo executa “verde” mas internamente algo falha (ex: API sem autenticação), nã**o será tratado como erro pelo n8n. - Para esses casos, seria necessário capturar a falha manualmente (ex: checando resposta da API).
-
Erro proposital para testar - Alterar uma variável mal intencionadamente (ex: se
ssionIDD em vez desessionID). - Executar novamente. - Verificação: linha na planilha + notificação no Slack com detalhes atualizados. -
Limitações e Cuidados - O próprio workflow de erro (
Error Logger) raramente deve falhar, já que apenas lê dados e os insere. - Caso falhe com frequência, é sinal de problemas mais profundos (ex: autenticação, excesso de lógica complexa).
Conclusão⌗
Esse método: - Centraliza o tratamento de erros. - Facilita o debug com link direto à execução. - Ajuda a manter registros para análise posterior.
Tópicos Resumidos em Lista⌗
- Criar workflow com erro proposital.
- Criar workflow de erro com nó Er
ror Trigger.3. Ativar e vincular workflow principal ao Error Logger.4. Logar dados em Google Sheets. - Enviar notificação via Slack ou outro canal.
- Testar com erro real.
- Entender quando o erro não dispara o `Error
dublado em portugues
Resumo direto em tópicos:
- Criar um fluxo chamado
Error Loggercom o nóError Trigger. - Vincular esse fluxo a todos os workflows ativos que deseja monitorar (em Settings > Error Workflow).
- Quando qualquer workflow falhar, o
Error Loggeré acionado automaticamente. - O logger registra os erros em uma planilha Google Sheets (timestamp, nome do workflow, nó, mensagem e link).
- Envia também uma notificação no Slack com os mesmos dados.
- Só erros que “quebram” o fluxo (executam em vermelho) disparam o logger.
- Ideal para centralizar e automatizar o controle de falhas em projetos com múltiplos fluxos.
Controle de Error Fluxo
1