Java应用接入Prometheus监控需引入micrometer-registry-prometheus依赖,配置management.endpoints.web.exposure.include=prometheus,暴露/actuator/prometheus端点;Docker中需监听0.0.0.0:8081并映射端口,Prometheus通过java-app:8081抓取指标,Grafana导入模板ID 4701或12856实现可视化。

Java 应用接入 Prometheus 监控
要在 Docker 容器中监控 Java 服务,核心是让应用暴露 Prometheus 格式的指标。推荐使用 micrometer + micrometer-registry-prometheus,它是 Spring Boot 2.0+ 默认的指标抽象层,兼容性好、侵入低。
在 pom.xml 中添加依赖:
<dependency> <groupId>io.micrometer</groupId> <artifactId>micrometer-registry-prometheus</artifactId> </dependency>
配置 application.yml 启用 Actuator 端点:
management:
endpoints:
web:
exposure:
include: health,info,metrics,prometheus
endpoint:
prometheus:
scrape-interval: 15s启动后,访问 http://<java-app>:8080/actuator/prometheus 即可看到标准指标(如 jvm_memory_used、http_server_requests_total)。
立即学习“Java免费学习笔记(深入)”;
Docker 化 Java 应用并暴露指标端口
构建镜像时确保应用监听在 0.0.0.0:8080(而非 localhost),否则容器内网络无法被外部采集。
Dockerfile 示例:
FROM openjdk:17-jre-slim COPY target/myapp.jar /app.jar EXPOSE 8080 8081 # 8080 是业务端口,8081 可选用于 Actuator(更安全分离) ENTRYPOINT ["java","-jar","/app.jar"]
运行时建议加健康检查和资源限制:
- 用 --health-cmd="curl -f https://www.php.cn/link/840b2c22efca496f247caa4063cadd8c || exit 1" 检查存活
- 用 -m 512m --memory-swap=1g 防止 OOM 影响宿主机
- 务必映射指标端口:-p 8081:8081,供 Prometheus 抓取
用 Docker Compose 编排 Prometheus + Grafana + Java 服务
一个最小可用的 docker-compose.yml 结构如下(同网段互通,无需额外网络配置):
version: '3.8'
services:
prometheus:
image: prom/prometheus:latest
ports: [ "9090:9090" ]
volumes: [ "./prometheus.yml:/etc/prometheus/prometheus.yml" ]
depends_on: [ java-app ]
<p>grafana:
image: grafana/grafana:latest
ports: [ "3000:3000" ]
environment:
GF_SECURITY_ADMIN_PASSWORD: admin
volumes: [ "./grafana-provisioning:/etc/grafana/provisioning" ]
depends_on: [ prometheus ]</p><p>java-app:
build: .
ports: [ "8080:8080", "8081:8081" ]
healthcheck:
test: ["CMD", "curl", "-f", "<a href="https://www.php.cn/link/840b2c22efca496f247caa4063cadd8c">https://www.php.cn/link/840b2c22efca496f247caa4063cadd8c</a>"]
interval: 30s
timeout: 5s
retries: 3prometheus.yml 关键配置(抓取 Java 应用指标):
scrape_configs:
- job_name: 'spring-boot-app'
static_configs:
- targets: ['java-app:8081'] # 容器名 + Actuator 端口,非 localhostGrafana 中快速搭建 Java 监控看板
启动后访问 http://localhost:3000(账号 admin/admin),导入现成模板更高效:
- 搜索 ID 4701(JVM Micrometer)——展示内存、线程、GC、HTTP QPS/延迟
- 搜索 ID 12856(Spring Boot 2.x Micrometer)——含数据库连接池、缓存命中率等
导入后需确认数据源为 Prometheus(URL 填 http://prometheus:9090,注意是容器名,不是 localhost)。
若需自定义面板:新建 Dashboard → Add new panel → 查询框输入类似 jvm_memory_used_bytes{application="myapp"},选择图形类型即可实时渲染。


















