O n8n fornece alguma API para buscar análises ou métricas de fluxo de trabalho, ou existe algum recurso desse tipo disponível através do servidor MCP do n8n?
Olá @mylearnings_abu
A API REST pública do n8n expõe dados de execução que você pode consultar de forma programática. Os principais endpoints incluem:
-
GET /api/v1/executions— listar execuções com filtros (ID do workflow, status, intervalo de datas) -
GET /api/v1/executions/{id}— obter detalhes de uma execução específica -
GET /api/v1/workflows— listar workflows (para referenciar IDs)
Esta é a forma primária de extrair histórico de execução e agregar suas próprias métricas (contagem de sucessos/falhas, tempos de execução, etc.). Está disponível tanto no Cloud quanto no self-hosted.
Para métricas operacionais em tempo real, o n8n expõe um endpoint /metrics quando você o ativa via variáveis de ambiente:
N8N_METRICS=true
N8N_METRICS_INCLUDE_QUEUE_METRICS=true # para modo de fila
Isso fornece gauges e contadores como:
-
n8n_scaling_mode_queue_jobs_active— jobs em execução no momento -
n8n_scaling_mode_queue_jobs_completed— total concluído desde o início -
n8n_scaling_mode_queue_jobs_failed— total falhado desde o início
O endpoint /metrics não está disponível no n8n Cloud — apenas self-hosted.
Para rastreamento profundo por execução, o n8n suporta spans de OpenTelemetry, que incluem atributos ricos:
-
n8n.workflow.id,n8n.workflow.name,n8n.execution.status -
n8n.execution.mode(manual, webhook, trigger, retry) -
n8n.execution.error_typeem falhas
Isso se integra a plataformas de observabilidade como Grafana, Jaeger ou Datadog
A referência de ferramentas do servidor MCP inclui uma ferramenta para executar um workflow por ID e recuperar o ID da execução. No entanto, o servidor MCP é focado em execução e gerenciamento de workflows (acionamento, listagem, gerenciamento de workflows), não em extrair análises ou métricas agregadas. Não existe uma ferramenta MCP dedicada para buscar estatísticas de execução ou dados de análise.
Você pode consultar abaixo para referência rápida
Isso ajuda?
Obrigado pela resposta rápida!
Oi @mylearnings_abu
O recurso de análise integrado do n8n é o Insights, e ele tem seu próprio endpoint na API pública:
GET /api/v1/insights/summary?startDate=2026-07-01T00:00:00Z&endDate=2026-07-29T00:00:00Z
Ele retorna execuções totais em produção, contagem de falhas, taxa de falha, tempo economizado e tempo médio de execução, cada um com um desvio em relação ao período anterior, além de um filtro projectId opcional. Uma chave de API com escopo precisa de insights:read. Apenas as execuções em produção dos fluxos de trabalho principais são contadas, portanto execuções manuais e execuções de sub-fluxos de trabalho são excluídas desses números.
Obrigado @Anshul_Namdev por compartilhar isso. Temos algum endpoint por base de fluxo de trabalho?
@Anshul_Namdev não consigo encontrar esse escopo na minha configuração atual do n8n hospedado.
@mylearnings_abu Não há endpoint por fluxo de trabalho na API pública, /insights/summary é a única rota de insights e projectId é seu único filtro. Os números por fluxo de trabalho existem na tabela do painel Insights, não pela API.
No escopo, insights:read foi lançado em 2.16 e o endpoint summary em 2.17, então qualquer instância mais antiga que isso não o listará ao criar uma chave de API. A atualização oferece ambos, a versão estável atual é 2.32.6.
Como você é auto-hospedado, o endpoint Prometheus oferece números por fluxo de trabalho hoje, com o rótulo de ID do fluxo de trabalho ativado:
N8N_METRICS=true
N8N_METRICS_INCLUDE_MESSAGE_EVENT_BUS_METRICS=true
N8N_METRICS_INCLUDE_WORKFLOW_ID_LABEL=true
Estou usando n8n Enterprise Edition v2.27.4. Quando tento criar uma chave de API, não vejo nenhum escopo relacionado a Insights
Há alguma configuração adicional a ser feita?
1)Primeiro, por favor atualize para a versão estável mais recente do n8n.
2)Se sua instância tem N8N_DISABLED_MODULES=insights definido no seu ambiente, o escopo não aparecerá na UI, pois o recurso está desativado.
3)Apenas proprietários de instâncias e administradores têm visibilidade do Insights. Verifique sua função de usuário em Configurações > Usuários.
4)Confirme que sua licença Enterprise está devidamente ativada. Acesse Configurações > Uso e Plano para verificar.
Isso ajuda?
@mylearnings_abu 2.27.4 já vem com o escopo, então isto é o direito de licença em vez da compilação. O seletor de escopo oferece apenas insights:read quando a licença da instância inclui o recurso Enterprise insights, e uma chave Enterprise emitida sem esse direito não o listará. Verifique o que a sua realmente concede:
docker exec -u node -it <your-n8n-container-name> n8n license:info
Remova a parte docker exec se você instalou com npm. Se insights não estiver nos direitos que ele imprime, a chave precisa ser reemitida de acordo com seu plano, support@n8n.io pode fazer isso.