Observabilidade com .NET, Prometheus e Grafana: Métricas, Docker e /metrics - Parte 2

Marcius Bezerra — Fri, 18 Sep 2026 06:20:31 +0000

Crie counters e histograms em uma Minimal API, consulte métricas no Prometheus e configure dashboards do Grafana com serviços executados via Docker Compose. Aprenda a implementar observabilidade em uma aplicação ASP.NET Core utilizando Prometheus, Grafana e Docker Compose.

Nesta etapa prática, são criadas métricas personalizadas com o pacote prometheus-net.AspNetCore. A aplicação disponibiliza os dados no endpoint /metrics, enquanto o Prometheus realiza o scrape periódico e fornece as séries temporais para consultas e visualizações no Grafana.

O tutorial demonstra como:

Criar uma métrica do tipo Counter com CreateCounter;
Incrementar valores utilizando Inc;
Medir a duração de operações com Histogram e CreateHistogram;
Controlar o timer com NewTimer e o descarte automático do using;
Criar um endpoint em uma Minimal API para disparar as métricas;
Executar a aplicação com dotnet watch;
Inspecionar manualmente o endpoint /metrics;
Interpretar séries de histogramas com os sufixos _sum, _count e buckets;
Consultar métricas pela interface do Prometheus;
Verificar o estado do scrape em Status - Targets;
Entender o intervalo entre coleta e atualização das métricas;
Configurar o Prometheus como Data Source do Grafana;
Utilizar o nome do serviço do Docker Compose em vez de localhost;
Criar painéis e executar consultas PromQL;
Escolher visualizações adequadas para counters e métricas de duração;
Salvar, editar, duplicar e organizar dashboards;
Importar dashboards prontos do Grafana Labs por ID.

O conteúdo é especialmente útil para observabilidade de APIs, microsserviços, aplicações distribuídas e sistemas ASP.NET Core que precisam acompanhar volume de requisições, duração de operações e evolução das métricas ao longo do tempo.

Índice de capítulos

00:00:00 Introdução e revisão da stack de observabilidade
00:03:34 Métricas personalizadas no Prometheus
00:05:13 Criando uma métrica Prometheus Counter no Program.cs
00:07:00 Criando um Histogram no Prometheus para duração de requisições
00:08:21 Endpoint /update, incremento e timer
00:10:38 Executando com dotnet watch e acessando /metrics
00:12:02 Analisando _sum, _count e buckets do Histogram no Prometheus
00:14:16 Consultando métricas na interface do Prometheus
00:16:57 Visualização Graph e intervalo de atualização (Prometheus)
00:18:05 Verificando o scrape em Status - Targets (Prometheus)
00:18:44 Configurando o Prometheus como Data Source no Grafana
00:20:03 Conectando Grafana e Prometheus pela rede Docker
00:22:06 Criando um dashboard no Grafana
00:23:10 Selecionando métricas e executando queries
00:24:08 Consultas PromQL e cálculo de rate no Grafana
00:25:29 Ajustando visualizações e salvando o dashboard no Grafana
00:26:07 Criando uma segunda visualização no Grafana
00:27:28 Editando, duplicando e nomeando painéis no Grafana
00:28:16 Procurando dashboards Grafana para ASP.NET Core
00:29:34 Importando dashboards do Grafana Labs por ID
00:30:19 Avaliando a compatibilidade dos dashboards

Observabilidade com .NET, Prometheus e Grafana: Métricas, Docker e /metrics

Marcius Bezerra — Fri, 18 Sep 2026 06:20:22 +0000

Observabilidade com .NET, Prometheus e Grafana: Métricas, Docker e /metrics

Configure uma Minimal API ASP.NET Core com Prometheus, Docker Compose e Grafana para expor e coletar métricas HTTP.

Descrição

Neste tutorial prático, você aprenderá os fundamentos de observabilidade com .NET, utilizando Prometheus para coleta de métricas e Grafana para visualização por meio de dashboards.

O projeto utiliza uma Minimal API em ASP.NET Core, configurada para expor o endpoint /metrics com a biblioteca prometheus-net.AspNetCore. A partir desse endpoint, o Prometheus realiza o processo de scraping (pull model) em intervalos configuráveis, armazenando métricas em séries temporais.

Também é criado um ambiente local reproduzível com Docker Compose, contendo os serviços do Prometheus e do Grafana. Você verá como configurar o arquivo prometheus.yml, integrar containers ao host usando host.docker.internal, publicar portas e validar o acesso à interface do Grafana.

Conteúdos abordados

Conceitos iniciais de observabilidade, métricas, logs e traces
Prometheus e métricas baseadas em séries temporais
PromQL e o modelo de coleta pull/scrape
Grafana como camada de visualização de dados
Ecossistema Prometheus, Grafana, Loki e Tempo
Criação de Minimal API com .NET 10 e ASP.NET Core
Endpoint HTTP /metrics
Instalação do pacote prometheus-net.AspNetCore
Configuração de scrape_interval e scrape_configs
Comunicação entre Docker e aplicação executada no host
Criação do docker-compose.yml
Execução e inspeção de containers com Docker
Configuração inicial e acesso ao Grafana
Coleta automática de métricas HTTP, CPU, memória e requisições

Este é o primeiro passo para instrumentar aplicações .NET e preparar uma stack de observabilidade. Na continuação, serão abordadas métricas customizadas, consultas no Prometheus e a criação de dashboards no Grafana.

Índice de capítulos

00:00:00 O que é Prometheus e métricas de séries temporais
00:03:40 Site do Prometheus, CNCF e PromQL
00:05:31 O que é Grafana e fontes de dados suportadas
00:07:48 Ecossistema de observabilidade: Prometheus, Loki, Tempo e Grafana
00:08:57 Como o Prometheus funciona: pull model, scrape e endpoint /metrics
00:10:48 Expondo métricas em aplicações web .NET
00:12:14 Preparação do ambiente e verificação do SDK .NET
00:15:07 Criando uma Minimal API ASP.NET Core com dotnet new web
00:19:00 Abrindo e conhecendo a estrutura do projeto no VS Code
00:24:57 Instalando o pacote prometheus-net.AspNetCore
00:29:32 Configurando o arquivo prometheus.yml
00:32:54 Acesso ao host a partir do Docker com host.docker.internal
00:34:29 Criando o docker-compose.yml para Prometheus e Grafana
00:37:58 Verificando containers e possíveis conflitos de portas
00:40:11 Subindo os serviços com Docker Compose
00:42:07 Acessando e validando o Grafana
00:43:25 Configurando UseMetricServer na Minimal API
00:45:17 Validando o endpoint /metrics
00:46:17 Habilitando métricas HTTP com UseHttpMetrics

DEV Community: Marcius Bezerra

Observabilidade com .NET, Prometheus e Grafana: Métricas, Docker e /metrics - Parte 2

Índice de capítulos

links:

Prometheus

CNCF

CNCF / Prometheus

Grafana

.Net Install Script

Observabilidade com .NET, Prometheus e Grafana: Métricas, Docker e /metrics

Descrição

Conteúdos abordados

Índice de capítulos

links:

Prometheus

CNCF

CNCF / Prometheus

Grafana

.Net Install Script