Pular para o conteúdo principal

Debugging

debugging-de Workflows

O debugging é uma habilidade essencial para desenvolver workflows robustos e confiáveis no n8n. Esta seção aborda técnicas e ferramentas para identificar e resolver problemas em suas automações.

ionicicon nameinformation circle outline style fontsize​

  1. Clique em "View Execution"
  2. Navegue pelas abas de cada node
  3. Analise os dados de entrada e saída

informaes disponveis input​

data Dados recebidos pelo node

  • Output Data: Dados enviados pelo node
  • Error Details: Detalhes de erros (se houver)
  • Performance: Tempo de execução
  • Status: Estado da execução

data viewer o data​

viewer permite visualizar dados em tempo real:

recursos estrutura de​

dados Visualização hierárquica

  • Tipos de Dados: Identificação automática
  • Valores: Dados reais em cada campo
  • Filtros: Busca e filtragem de dados

como usar​

1-clique-em um node após execução 2. Abra a aba "Output" 3. Use o Data Viewer para explorar dados 4. Identifique problemas de estrutura

step by step execution execute workflows​

node por node:

processo​

1-desative-nodes-que não precisa testar 2. Execute um node por vez 3. Verifique dados de entrada e saída 4. Corrija problemas encontrados 5. Ative próximo node e repita

benefcios isola problemas​

em nodes específicos

  • Valida dados em cada etapa
  • Testa lógica incrementalmente
  • Reduz complexidade do debugging

ionicicon namecode slash outline style fontsize​

console.log('Dados recebidos:', $json);

// Log com contexto console.log('Processando usuário:', $json.name, 'ID:', $json.id);

// Log condicional if ($json.status === 'error') console.log('Erro detectado:', $json.message);} } 

\n\n## id \n2-validao-de-dados-valide dados em cada etapa:\n\n
javascript\n// Verificar se campo existe\nif (!$json.email) \n throw new Error('Campo email não encontrado');}\n}\n\n// Validar formato\nif (!/^[^\s@]+@[^\s@]+.[^\s@]+$/.test($json.email)) \n throw new Error('Email inválido');}\n}\n\n// Verificar tipo de dados\nif (typeof $json.age !== 'number') \n throw new Error('Idade deve ser um número');}\n}\n```

id​

3-teste-de-credenciais-teste conectividade separadamente:

  1. Vá para Credentials
  2. Selecione a credencial
  3. Clique em "Test"
  4. Verifique se a conexão funciona

id​

4-simulao-de-dados-use Data Pinning para testes:

  1. Execute node com dados reais
  2. Pine os dados de saída
  3. Desenvolva lógica com dados fixos
  4. Teste sem pinning antes de publicar

problemas-comuns

erros de​

conectividade

sintomas timeout​

errors Connection refused

  • SSL certificate errors
  • Rate limiting

solues​

1-verifique-credenciais-esto corretas 2. Teste conectividade de rede 3. Verifique rate limits da API 4. Ajuste timeouts se necessário

erros de​

dados

sintomas missing​

fields Wrong data types

  • Invalid formats
  • Null values

solues​

1-valide-estrutura-dos dados 2. Use transformações para corrigir 3. Adicione validações nos nodes 4. Trate valores nulos adequadamente

erros de​

lgica

sintomas workflow no​

executa como esperado

  • Condições não funcionam
  • Loops infinitos
  • Dados incorretos

solues​

1-revise-expresses-javascript 2. Teste condições individualmente 3. Verifique ordem de execução 4. Use step-by-step execution

ionicicon nameanalytics outline style fontsize​

Debugging eficiente leva a workflows robustos!