Variáveis de ambiente: Logs e event bus
23 variáveis das versões 1.123.92, 2.45.7 e 3.0.1
Nível, formato e destino dos logs, rotação de arquivos, event bus, log streaming e registro de atividades. 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.
Envia para a saída padrão do processo os logs do Code node gerados por
console.logouprint, só nas execuções de produção.Quantidade máxima de registros no log de atividades da instância. Com
0, a limpeza por quantidade fica desligada.Dias que os registros do log de atividades ficam guardados. Com
0, a limpeza por idade fica desligada.Intervalo em milissegundos para procurar e reenviar mensagens do event bus que não saíram. Com
0, a checagem fica desligada. Ligada, pode haver envio duplicado ocasional.Quantidade de arquivos de log de eventos mantidos na rotação.
Nome-base dos arquivos de log de eventos. O n8n acrescenta extensão e sufixo de rotação.
Caminho absoluto do arquivo principal de log de eventos, terminado em
.log. Com o valor definido, o n8n usa o caminho sem sufixo de processo e cria a pasta. Em Kubernetes, garanta um caminho diferente por pod.Tamanho máximo em KB de cada arquivo de log de eventos antes da rotação. O padrão equivale a 10 MB.
Limite de mensagens sem confirmação mantidas em memória por arquivo ao ler os logs de eventos na inicialização. Acima do limite, o arquivo é descartado para evitar falta de memória com logs antigos.
Limite total de linhas lidas de cada arquivo de log de eventos, incluindo linhas inválidas, para conter o uso de memória com arquivos corrompidos.
Fazia o acesso aos arquivos de log de eventos de forma síncrona. A documentação ainda cita a variável, mas o código das três linhas não a lê.
Recuperação depois de uma queda:
extensivereconstrói os detalhes das execuções esimplesó marca as execuções como interrompidas.Intervalo em minutos para registrar no log os agendamentos ativos. Com
0, o registro fica desligado.Quantidade máxima de arquivos de log, ou de dias de log com o sufixo
d, como7d. Só vale com saída em arquivo.Caminho do arquivo de log dentro de
~/.n8n. Só vale com saída em arquivo.Tamanho máximo em MiB de cada arquivo de log. Só vale com saída em arquivo.
Formato do log:
textmostra só a mensagem legível ejsongrava um objeto por linha com mensagem, nível, horário e metadados.Nível mínimo das mensagens de log:
error,warn,infooudebug. Comsilent, o log fica desligado.Destino do log:
console,fileou os dois separados por vírgula.Escopos que filtram o log, separados por vírgula, como
scaling,redis,pruningoutask-runner-js. Vazio, nada é filtrado.Lista JSON dos destinos de log streaming, como webhook, syslog ou Sentry. Só tem efeito com
N8N_LOG_STREAMING_MANAGED_BY_ENVligado.Faz a lista de
N8N_LOG_STREAMING_DESTINATIONSdefinir os destinos de log streaming a cada inicialização.Com qualquer valor, o log sai sem cores ANSI.