n8n 2.40.7: correção nos atributos de projeto dos registros de nodes

O n8n 2.40.7 corrige a identificação de projetos nos registros de telemetria de cada node de um workflow. Antes, o registro da execução do workflow podia conter os atributos do projeto sem que esses dados aparecessem também nos registros dos nodes. Com a correção, quem acompanha execuções pelo OpenTelemetry consegue relacionar cada etapa ao projeto correspondente.

O que são esses registros?

O n8n é uma plataforma para automatizar processos por meio de workflows, formados por etapas chamadas nodes. O OpenTelemetry é uma forma de coletar dados sobre a execução de sistemas. Nesse contexto, cada registro de rastreamento, chamado span, representa uma parte da execução: há um registro para o workflow e registros para seus nodes.

O que mudou na versão 2.40.7?

A nota oficial descreve uma correção no núcleo do n8n: os atributos de projeto do registro workflow.execute passam a ser propagados para cada registro node.execute correspondente. Isso inclui n8n.project.id e atributos personalizados com o prefixo n8n.project.custom.*.

Na prática, se um workflow pertence a um projeto, a telemetria de cada node agora pode carregar a mesma identificação de projeto que já aparece na execução geral. Segundo a descrição da correção, execuções sem projeto permanecem inalteradas.

Para quem isso importa?

A mudança interessa principalmente a equipes que usam rastreamento OpenTelemetry e atributos de projeto para examinar execuções de automações. Por exemplo, ao investigar um node em um sistema de observabilidade, fica mais fácil associar seu registro ao projeto do workflow. A release não anuncia alterações na lógica dos workflows nem afirma que nodes passarão a executar de outra maneira.

Como validar depois de atualizar?

  1. Em um ambiente de teste, habilite o rastreamento OpenTelemetry e execute um workflow que pertença a um projeto com atributos personalizados.
  2. No destino que recebe a telemetria, abra os registros node.execute dessa execução.
  3. Confirme que contêm n8n.project.id e n8n.project.custom.*, assim como o registro pai workflow.execute.

Se sua operação não usa esse rastreamento, a correção pode não produzir nenhuma diferença perceptível na interface. Antes de atualizar uma instância de produção, confira as notas da versão e mantenha o procedimento habitual de backup e teste.

Conclusão

O n8n 2.40.7 corrige a associação entre projetos e registros de telemetria dos nodes. É um ajuste pontual de observabilidade: o ganho está em identificar a qual projeto pertence cada etapa monitorada, sem mudar execuções que não têm projeto.

Fontes oficiais: release n8n 2.40.7 e descrição da correção #39457.