Visualizador de fluxo de requisições · ASP.NET Core
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.
Manifesto de engenharia
01
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
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
Um pacote NuGet, poucas linhas de código, uma URL local. Filtro por rota e por tenant, compostos numa API fluente.
04
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
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.
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.
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
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.
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.
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.
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.
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
Nenhum serviço separado para fazer deploy. O dashboard vem embutido no pacote e roda junto da sua API.
// 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
Estado nunca é só cor. Continua legível em escala de cinza, para quem tem daltonismo, e numa impressão em preto e branco.