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.
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.
Nome do ambiente, como
production, que o n8n e o task runner informam ao Sentry junto de cada erro.Configuração do endpoint de telemetria do backend, no formato
chave;urlBase. A imagem oficial já define o valor.Configuração do endpoint de telemetria do editor, no formato
chave;urlBase. A imagem oficial já define o valor.Envia ao n8n diagnósticos anônimos e telemetria de uso da instância. Defina
falsepara desligar o envio.Endereço da API do PostHog usada na análise de uso do produto. O padrão passou a
https://ph.n8n.iona 2.x.Chave do projeto PostHog usada na análise de uso do produto. A chave padrão mudou na 2.x.
DSN do Sentry para os erros do editor.
Liga o rastreamento com OpenTelemetry. Com
false, o n8n nem carrega o SDK.URL base do endpoint OTLP que recebe os traces, com
http://ouhttps://. No protocolohttp/protobuf, o n8n acrescenta o caminho deN8N_OTEL_EXPORTER_OTLP_TRACING_PATH.Cabeçalhos enviados em cada requisição OTLP, no formato
chave=valorseparados por vírgula, comoauthorization=Bearer <token>. No protocologrpc, viram metadados do gRPC.Protocolo de envio dos traces:
http/protobufougrpc.Caminho acrescentado ao endpoint OTLP para enviar traces. Ignorado no protocolo
grpc.Valor do atributo
service.namedos spans enviados.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.
Objeto JSON que troca ou remove o prefixo dos atributos personalizados dos spans, como
{"project":"","node":""}.Envia um span de duração zero
node.execute.startedno início de cada Node. ExigeN8N_OTEL_TRACES_INCLUDE_NODE_SPANSligada.Envia um span de duração zero
workflow.execute.startedno início de cada execução.Gera um span
node.executepara cada Node executado. Comfalse, só os spans do workflow são enviados.Acrescenta os cabeçalhos W3C
traceparentetracestatenas requisições HTTP feitas pelos Nodes, para ligar o trace aos serviços chamados.Envia traces só das execuções de produção. Com
false, envia de todas as execuções.Fração dos traces enviados, de 0 a 1. Todos os spans de um trace entram ou saem juntos.
DSN do Sentry para os erros do backend.
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.
Quantidade máxima de eventos de event loop travado enviados ao Sentry por hora em cada instância.
Tempo em milissegundos de event loop parado a partir do qual o Sentry registra o travamento.
Fração das transações com profiling no Sentry, de 0 a 1. Com
0, o profiling fica desligado.Fração das transações enviadas como trace ao Sentry, de 0 a 1. Com
0, os traces ficam desligados.Tempo mínimo em milissegundos para um span de banco ou HTTP sem erro ser enviado ao Sentry. Spans mais curtos são descartados.
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.