Visualizador de fluxo de requisições · ASP.NET Core

NETAPIFLOW

Integrações complexas. Fluxos lineares.

Biblioteca open source para ASP.NET Core que mostra, ao vivo, o caminho de cada requisição HTTP dentro da sua API, do endpoint ao comando SQL, com duração, falhas, lentidão e o que nunca chegou a executar.

O grafo de fluxo do NetApiFlow acendendo ao vivo durante uma requisição real

Manifesto de engenharia

Quatro princípios não negociáveis

01

Tipagem forte (.NET)

Integração nativa com DI e middleware do ASP.NET Core. Eventos de rastreamento tipados, sem strings mágicas nem reflexão no caminho crítico.

02

Diagnóstico ativo

Mostra onde a falha começou, o que ficou lento e o que nunca executou. Estado sempre com cor, ícone e texto. Nunca só cor.

03

Configuração fluente

Um pacote NuGet, poucas linhas de código, uma URL local. Filtro por rota e por tenant, compostos numa API fluente.

04

Overhead medido

Coleta assíncrona e desligável por ambiente. Com rastreamento ligado, o custo medido é de cerca de 20 microssegundos por requisição, benchmark publicado, não estimado.

O que ele faz

Três pilares

Live

Rastreamento ao vivo

Grafo em tempo real do caminho da requisição. Endpoint, depois Handler, depois Services, depois Repositories, depois SQL. Funciona com Clean Architecture, Vertical Slices e MediatR.

Diagnose

Diagnóstico de falha e lentidão

Duração por etapa, ponto de origem da exceção, etapas lentas acima do limite e o que deixou de executar, sem abrir debugger nem garimpar log.

Replay

Telemetria e replay

Histórico de execuções com trace ID, filtro por tenant e rota, e timeline de replay com controle de velocidade para rever exatamente o que aconteceu.

Além do essencial

O resto do pacote

Rastrear a requisição é só o começo. O resto do ecossistema ajuda a achar problema antes do incidente, e a levar o trace pra onde você já trabalha.

MCP

Pronto pra um agente de IA

Sua própria API expõe um servidor MCP: um agente lista traces recentes, busca um por id e lê estatística por componente, sem nenhum cliente REST escrito à mão.

OTLP

Interopera com seu stack

Exporta o mesmo trace pro Jaeger, Tempo, Aspire Dashboard, Honeycomb ou qualquer coletor compatível com OpenTelemetry. Ingestão nativa de Npgsql e HttpClient, sem duplicar span.

Insights

Acha o que não dá pra ver numa execução só

Detector de N+1 automático no grafo, mapa de arquitetura construído a partir de centenas de execuções reais, e uma visão agregada das rotas mais lentas e com mais erro.

Runner

Testa uma rota sem sair do dashboard

Monta o formulário direto do documento OpenAPI da sua própria API e dispara a requisição de verdade. Numa rota protegida, cole o token uma vez: o header certo é aplicado automaticamente em cada requisição, sem copiar e colar de novo.

E mais: diff entre duas execuções lado a lado, trace exportado como arquivo pra levar pra qualquer lugar, sampling inteligente pra reter só o que importa, log/exceção correlacionados por etapa, e um marco de deploy na linha do tempo do histórico, pra correlacionar um incidente com um deploy de outra pessoa.

Para começar

Instale um pacote, adicione poucas linhas

Nenhum serviço separado para fazer deploy. O dashboard vem embutido no pacote e roda junto da sua API.

Program.csexemplo ilustrativo
// 1. instale o pacote
dotnet add package NetApiFlow

// 2. registre e monte o dashboard
using NetApiFlow;
using NetApiFlow.Dashboard;
using NetApiFlow.Dashboard.Endpoints;

builder.Services.AddNetApiFlow();
builder.Services.AddNetApiFlowDashboard();
// ...
app.UseNetApiFlowDashboard(); // montado em /flow por padrão

Toda etapa, cor, ícone e texto

Estado nunca é só cor. Continua legível em escala de cinza, para quem tem daltonismo, e numa impressão em preto e branco.

Aguardando Em execução Concluído Lento Erro Não executado Cancelado Tempo esgotado