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

O n8n 2.41.3 corrige a identificação de projetos nos registros de telemetria de cada node. Antes, a execução geral do workflow podia trazer informações do projeto sem que elas acompanhassem os registros das etapas individuais. Com a correção, fica possível identificar o projeto também ao examinar o rastreamento de um node.

O que são registros de telemetria?

O n8n organiza automações em workflows, cada um formado por etapas chamadas nodes. Quando o rastreamento OpenTelemetry está habilitado, a execução gera registros chamados spans: um para o workflow e outros para os nodes. Eles ajudam equipes técnicas a investigar o que aconteceu em cada etapa.

O que mudou na versão 2.41.3?

A nota oficial descreve a propagação dos atributos de projeto do registro workflow.execute para os registros node.execute. Segundo a descrição da correção vinculada à release, isso inclui n8n.project.id e os atributos personalizados n8n.project.custom.*. Execuções sem projeto permanecem inalteradas.

A mudança está nos dados de rastreamento, não no funcionamento anunciado dos workflows. Ela é relevante principalmente para quem usa atributos de projeto para filtrar ou analisar execuções no destino que recebe a telemetria. Quem não utiliza esse rastreamento pode não notar uma diferença visível na interface.

Como validar após atualizar?

  1. Em um ambiente de teste, habilite o rastreamento OpenTelemetry e execute um workflow de um projeto que tenha atributos personalizados.
  2. No sistema que recebe a telemetria, compare o registro workflow.execute com os registros node.execute daquela execução.
  3. Confirme que o ID e os atributos personalizados do projeto também aparecem nos registros dos nodes.

Antes de atualizar a instância de produção, mantenha o procedimento de backup e teste usado pela sua equipe.

Conclusão

O n8n 2.41.3 faz um ajuste específico de observabilidade: os registros dos nodes passam a carregar os atributos do projeto associados ao workflow. A versão pode ter um tema semelhante ao da 2.40.7, mas esta é a release oficial da linha 2.41.x e deve ser avaliada por sua própria nota.

Fontes oficiais: release n8n 2.41.3 e descrição da correção vinculada à release.