Ir para o conteúdo
Promovaweb

Variáveis de ambiente: Observabilidade e telemetria

30 variáveis das versões 1.123.92, 2.45.7 e 3.0.1

Rastreamento com OpenTelemetry, envio de erros ao Sentry e a telemetria de diagnóstico enviada ao n8n. A lista sai do código de cada versão e das páginas de variáveis da documentação oficial, conferidos em 3 de novembro de 2026. Toda variável aceita o sufixo _FILE para ler o valor de um arquivo, útil para senhas e chaves em secrets do Docker.

  • DEPLOYMENT_NAME
    • Fora da documentação

    Nome da implantação que o n8n e o task runner informam ao Sentry junto de cada erro. Só tem efeito quando o envio de erros ao Sentry está ligado.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x aceita2.x aceita3.x aceita
  • ENVIRONMENT
    • Fora da documentação

    Nome do ambiente, como production, que o n8n e o task runner informam ao Sentry junto de cada erro.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x aceita2.x aceita3.x aceita
  • Configuração do endpoint de telemetria do backend, no formato chave;urlBase. A imagem oficial já define o valor.

    Tipo
    String
    Padrão
    1zPn7YoGC3ZXE9zLeTKLuQCB4F6;https://telemetry.n8n.io/v1/batch
    Versões
    1.x aceita2.x aceita3.x aceita
  • Configuração do endpoint de telemetria do editor, no formato chave;urlBase. A imagem oficial já define o valor.

    Tipo
    String
    Padrão
    1zPn9bgWPzlQc0p8Gj1uiK6DOTn;https://telemetry.n8n.io
    Versões
    1.x aceita2.x aceita3.x aceita
  • Envia ao n8n diagnósticos anônimos e telemetria de uso da instância. Defina false para desligar o envio.

    Tipo
    Boolean
    Padrão
    true
    Versões
    1.x aceita2.x aceita3.x aceita
  • N8N_DIAGNOSTICS_POSTHOG_API_HOST
    • Fora da documentação

    Endereço da API do PostHog usada na análise de uso do produto. O padrão passou a https://ph.n8n.io na 2.x.

    Tipo
    String
    Padrão
    1.xhttps://us.i.posthog.com2.xhttps://ph.n8n.io3.xhttps://ph.n8n.io
    Versões
    1.x aceita2.x aceita3.x aceita
  • N8N_DIAGNOSTICS_POSTHOG_API_KEY
    • Fora da documentação

    Chave do projeto PostHog usada na análise de uso do produto. A chave padrão mudou na 2.x.

    Tipo
    String
    Padrão
    1.xphc_4URIAm1uYfJO7j8kWSe0J8lc8IqnstRLS7Jx8NcakHo2.xphc_kMstNfAgBcBkWSh6KdsgN09heqqNe5VNmalHP1Ni9Q43.xphc_kMstNfAgBcBkWSh6KdsgN09heqqNe5VNmalHP1Ni9Q4
    Versões
    1.x aceita2.x aceita3.x aceita
  • N8N_FRONTEND_SENTRY_DSN
    • Fora da documentação

    DSN do Sentry para os erros do editor.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x aceita2.x aceita3.x aceita
  • Liga o rastreamento com OpenTelemetry. Com false, o n8n nem carrega o SDK.

    Tipo
    Boolean
    Padrão
    false
    Versões
    1.x não aceita2.x aceita3.x aceita
  • URL base do endpoint OTLP que recebe os traces, com http:// ou https://. No protocolo http/protobuf, o n8n acrescenta o caminho de N8N_OTEL_EXPORTER_OTLP_TRACING_PATH.

    Tipo
    String
    Padrão
    http://localhost:4318
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Cabeçalhos enviados em cada requisição OTLP, no formato chave=valor separados por vírgula, como authorization=Bearer <token>. No protocolo grpc, viram metadados do gRPC.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Protocolo de envio dos traces: http/protobuf ou grpc.

    Tipo
    String
    Padrão
    http/protobuf
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Caminho acrescentado ao endpoint OTLP para enviar traces. Ignorado no protocolo grpc.

    Tipo
    String
    Padrão
    /v1/traces
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Valor do atributo service.name dos spans enviados.

    Tipo
    String
    Padrão
    n8n
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Tempo limite em milissegundos do teste de conexão com o endpoint OTLP na inicialização. Se o endpoint não responde, o n8n registra um erro.

    Tipo
    Number
    Padrão
    2000
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Objeto JSON que troca ou remove o prefixo dos atributos personalizados dos spans, como {"project":"","node":""}.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Envia um span de duração zero node.execute.started no início de cada Node. Exige N8N_OTEL_TRACES_INCLUDE_NODE_SPANS ligada.

    Tipo
    Boolean
    Padrão
    false
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Envia um span de duração zero workflow.execute.started no início de cada execução.

    Tipo
    Boolean
    Padrão
    false
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Gera um span node.execute para cada Node executado. Com false, só os spans do workflow são enviados.

    Tipo
    Boolean
    Padrão
    true
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Acrescenta os cabeçalhos W3C traceparent e tracestate nas requisições HTTP feitas pelos Nodes, para ligar o trace aos serviços chamados.

    Tipo
    Boolean
    Padrão
    true
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Envia traces só das execuções de produção. Com false, envia de todas as execuções.

    Tipo
    Boolean
    Padrão
    true
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Fração dos traces enviados, de 0 a 1. Todos os spans de um trace entram ou saem juntos.

    Tipo
    Number
    Padrão
    1.0
    Versões
    1.x não aceita2.x aceita3.x aceita
  • N8N_SENTRY_DSN
    • Fora da documentação

    DSN do Sentry para os erros do backend.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x aceita2.x aceita3.x aceita
  • Liga a detecção do Sentry para o event loop travado. Um monitor nativo captura a pilha da thread principal quando o travamento passa do limite.

    Tipo
    Boolean
    Padrão
    false
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Quantidade máxima de eventos de event loop travado enviados ao Sentry por hora em cada instância.

    Tipo
    Number
    Padrão
    5
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Tempo em milissegundos de event loop parado a partir do qual o Sentry registra o travamento.

    Tipo
    Number
    Padrão
    500
    Versões
    1.x não aceita2.x aceita3.x aceita
  • N8N_SENTRY_PROFILES_SAMPLE_RATE
    • Fora da documentação

    Fração das transações com profiling no Sentry, de 0 a 1. Com 0, o profiling fica desligado.

    Tipo
    Number
    Padrão
    0
    Versões
    1.x não aceita2.x aceita3.x aceita
  • N8N_SENTRY_TRACES_SAMPLE_RATE
    • Fora da documentação

    Fração das transações enviadas como trace ao Sentry, de 0 a 1. Com 0, os traces ficam desligados.

    Tipo
    Number
    Padrão
    0
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Tempo mínimo em milissegundos para um span de banco ou HTTP sem erro ser enviado ao Sentry. Spans mais curtos são descartados.

    Tipo
    Number
    Padrão
    1000
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Fração dos traces de webhooks de produção bem-sucedidos enviados ao Sentry, de 0 a 1. Webhooks com erro entram independentemente da taxa.

    Tipo
    Number
    Padrão
    0.05
    Versões
    1.x não aceita2.x aceita3.x aceita