Expondo métricas com Actuator e Prometheus
Disponibilize a integridade do gateway e as métricas de rota por meio do Spring Boot Actuator e colete-as com o Prometheus para obter observabilidade completa.
Expondo métricas com Actuator e Prometheus é uma aula grátis de API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) no CoddyKit. Esta é a aula 4 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway), e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) inclui 4 aulas no total.
Partes desta aula ainda não foram traduzidas e aparecem em inglês.
Seeing Inside the Gateway
Tracing shows individual request journeys, but you also need aggregate metrics: request rates, error counts, latency. Spring Boot Actuator plus Micrometer expose these for the gateway.
Adding Actuator
The Actuator starter adds production-ready endpoints for health, info, and metrics.
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-actuator</artifactId>
</dependency>Exposing Endpoints
By default most endpoints are hidden over HTTP. Expose the ones you need explicitly.
management:
endpoints:
web:
exposure:
include: health,info,metrics,prometheus,gatewayThe Gateway Endpoint
The gateway actuator endpoint lists all active routes and their configuration, invaluable for debugging routing in a running system.
curl http://localhost:8080/actuator/gateway/routesMicrometer Metrics
Micrometer is the metrics facade. The gateway records timers like spring.cloud.gateway.requests tagged by route id, status, and method.
Enabling Gateway Metrics
Make sure metric collection for the gateway is turned on so per-route timers are recorded.
spring:
cloud:
gateway:
metrics:
enabled: trueThe Prometheus Registry
Add the Prometheus registry so metrics are published in Prometheus' text format at /actuator/prometheus.
<dependency>
<groupId>io.micrometer</groupId>
<artifactId>micrometer-registry-prometheus</artifactId>
</dependency>Inspecting the Scrape Endpoint
Hit the endpoint to see raw metrics. Prometheus will scrape this same URL on a schedule.
curl http://localhost:8080/actuator/prometheusConfiguring a Scrape Job
Point Prometheus at the gateway with a scrape job describing the path and target.
scrape_configs:
- job_name: gateway
metrics_path: /actuator/prometheus
static_configs:
- targets: ['gateway:8080']Useful Metrics to Watch
Key signals include request count, error rate (5xx), and p95 latency per route. Alert when error rate or latency crosses a threshold.
spring_cloud_gateway_requests_seconds_countspring_cloud_gateway_requests_seconds_max
Securing the Endpoints
Actuator endpoints can leak internals. In production restrict them to an internal network or protect them with authentication.
management:
endpoints:
web:
base-path: /internal/actuatorQuick Check
Which actuator endpoint exposes metrics in a format Prometheus can scrape?
Recap
You made the gateway observable:
- Actuator exposes health, metrics, and the gateway route view
- Micrometer records per-route timers
- The Prometheus registry serves
/actuator/prometheus - Prometheus scrapes and you alert on errors and latency
With tracing plus metrics you have end-to-end visibility into gateway traffic.
Perguntas Frequentes
A aula “Expondo métricas com Actuator e Prometheus” é grátis?
Sim — o texto completo de “Expondo métricas com Actuator e Prometheus” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway), atualize para CoddyKit PRO. O curso de API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) inclui 4 aulas no total.
O que vou aprender em “Expondo métricas com Actuator e Prometheus”?
Disponibilize a integridade do gateway e as métricas de rota por meio do Spring Boot Actuator e colete-as com o Prometheus para obter observabilidade completa. Você pratica API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway)?
Nenhuma experiência prévia é necessária. API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 4 de 4.
Quanto tempo leva a aula “Expondo métricas com Actuator e Prometheus”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway)?
Sim. Cada aula de API Gateway & Reverse Proxy (Nginx + Spring Cloud Gateway) inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- Autenticação e Autorização com JWT
- Rastreamento Distribuído com Sleuth e Zipkin
- Configuração Centralizada com Config Server
- Expondo métricas com Actuator e Prometheus