b. Microsserviços
Cada microsserviço precisa de duas mudanças: as dependências Maven necessárias no pom.xml e a configuração do endpoint do actuator no application.yaml.
1 Dependências
Adicione as seguintes dependências ao pom.xml de cada microsserviço (gateway-service, auth-service e account-service):
<!-- metrics collection -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-actuator</artifactId>
</dependency>
<!-- export in prometheus format -->
<dependency>
<groupId>io.micrometer</groupId>
<artifactId>micrometer-registry-prometheus</artifactId>
<scope>runtime</scope>
</dependency>
spring-boot-starter-actuatorhabilita endpoints de gerenciamento prontos para produção, incluindo health checks e métricas.micrometer-registry-prometheusexporta essas métricas no formato de texto que o Prometheus espera coletar.
2 Configuração
Configure o application.yaml de cada serviço para expor o endpoint do Prometheus sob o context path do próprio serviço. Assim, todos os endpoints ficam acessíveis pela única porta do balanceador de carga, sem conflitos:
Por que base paths diferentes?
Cada microsserviço usa o seu próprio prefixo de contexto, de modo que o endpoint do Prometheus fica acessível como /gateway/actuator/prometheus, /auth/actuator/prometheus e /accounts/actuator/prometheus — sem conflitos de porta e sem expor diretamente as portas internas.
O metrics_path de cada job no prometheus.yml (Prometheus) precisa ser esse base-path seguido de /prometheus, caractere por caractere; senão a coleta recebe um 404 e o alvo aparece como DOWN:
flowchart LR
yml["prometheus.yml\nmetrics_path: /accounts/actuator/prometheus"] -->|"GET account:8080"| svc{"o base-path é\n/accounts/actuator?"}
svc -->|sim| up["200 com as métricas\nalvo UP"]
svc -->|não| down["404 Not Found\nalvo DOWN"]