Ir para o conteúdo
Promovaweb

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.log ou print, só nas execuções de produção.

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

    Quantidade máxima de registros no log de atividades da instância. Com 0, a limpeza por quantidade fica desligada.

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

    Dias que os registros do log de atividades ficam guardados. Com 0, a limpeza por idade fica desligada.

    Tipo
    Number
    Padrão
    0
    Versões
    1.x não aceita2.x aceita3.x aceita
  • 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.

    Tipo
    Number
    Padrão
    0
    Versões
    1.x aceita2.x aceita3.x aceita
  • Quantidade de arquivos de log de eventos mantidos na rotação.

    Tipo
    Number
    Padrão
    3
    Versões
    1.x aceita2.x aceita3.x aceita
  • Nome-base dos arquivos de log de eventos. O n8n acrescenta extensão e sufixo de rotação.

    Tipo
    String
    Padrão
    n8nEventLog
    Versões
    1.x aceita2.x aceita3.x aceita
  • 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.

    Tipo
    String
    Padrão
    ''
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Tamanho máximo em KB de cada arquivo de log de eventos antes da rotação. O padrão equivale a 10 MB.

    Tipo
    Number
    Padrão
    10240
    Versões
    1.x aceita2.x aceita3.x aceita
  • 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.

    Tipo
    Number
    Padrão
    10000
    Versões
    1.x não aceita2.x aceita3.x aceita
  • 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.

    Tipo
    Number
    Padrão
    500000
    Versões
    1.x não aceita2.x aceita3.x aceita
  • 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ê.

    Tipo
    Boolean
    Padrão
    false
    Versões
    1.x não aceita2.x não aceita3.x não aceita
  • N8N_EVENTBUS_RECOVERY_MODE
    • Fora da documentação

    Recuperação depois de uma queda: extensive reconstrói os detalhes das execuções e simple só marca as execuções como interrompidas.

    Tipo
    Enum
    Padrão
    extensive
    Versões
    1.x aceita2.x aceita3.x aceita
    Valores
    • simple
    • extensive
  • Intervalo em minutos para registrar no log os agendamentos ativos. Com 0, o registro fica desligado.

    Tipo
    Number
    Padrão
    0
    Versões
    1.x aceita2.x aceita3.x aceita
  • Quantidade máxima de arquivos de log, ou de dias de log com o sufixo d, como 7d. Só vale com saída em arquivo.

    Tipo
    Number
    Padrão
    100
    Versões
    1.x aceita2.x aceita3.x aceita
  • Caminho do arquivo de log dentro de ~/.n8n. Só vale com saída em arquivo.

    Tipo
    String
    Padrão
    logs/n8n.log
    Versões
    1.x aceita2.x aceita3.x aceita
  • Tamanho máximo em MiB de cada arquivo de log. Só vale com saída em arquivo.

    Tipo
    Number
    Padrão
    16
    Versões
    1.x aceita2.x aceita3.x aceita
  • Formato do log: text mostra só a mensagem legível e json grava um objeto por linha com mensagem, nível, horário e metadados.

    Tipo
    Enum
    Padrão
    text
    Versões
    1.x aceita2.x aceita3.x aceita
    Valores
    • text
    • json
  • Nível mínimo das mensagens de log: error, warn, info ou debug. Com silent, o log fica desligado.

    Tipo
    Enum
    Padrão
    info
    Versões
    1.x aceita2.x aceita3.x aceita
    Valores
    • error
    • warn
    • info
    • debug
    • silent
  • Destino do log: console, file ou os dois separados por vírgula.

    Tipo
    Lista
    Padrão
    console
    Versões
    1.x aceita2.x aceita3.x aceita
  • N8N_LOG_SCOPES
    • Fora da documentação

    Escopos que filtram o log, separados por vírgula, como scaling, redis, pruning ou task-runner-js. Vazio, nada é filtrado.

    Tipo
    Lista
    Padrão
    sem padrão
    Versões
    1.x aceita2.x aceita3.x aceita
  • Lista JSON dos destinos de log streaming, como webhook, syslog ou Sentry. Só tem efeito com N8N_LOG_STREAMING_MANAGED_BY_ENV ligado.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Faz a lista de N8N_LOG_STREAMING_DESTINATIONS definir os destinos de log streaming a cada inicialização.

    Tipo
    Boolean
    Padrão
    false
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Com qualquer valor, o log sai sem cores ANSI.

    Tipo
    any
    Padrão
    undefined
    Versões
    1.x aceita2.x aceita3.x aceita