用 Docker Compose 整合外部监控看板的核心是：业务容器暴露 Prometheus 指标，通过 cadvisor、node-exporter、Prometheus 和 Grafana 四组件协同采集、存储与可视化，再扩展 Loki/Jaeger 实现日志与链路追踪。
直接用 Docker Compose 整合外部监控看板，核心是让业务容器暴露指标、引入采集器、对接时序数据库、再由 Grafana 渲染。不依赖复杂开发，靠配置就能跑起来。
一、让业务服务输出标准监控指标
多数现代应用（如 Spring Boot、Node.js Express、Go Gin）默认支持 Prometheus 格式指标端点，比如 /actuator/prometheus 或 /metrics。确认你的服务已启用该功能，并确保该路径在容器内可被访问。
若服务本身不支持，可加一层轻量 exporter，例如：
- Nginx：用
nginx-prometheus-exporter镜像监听 Nginx stub_status，转换为 Prometheus 指标 - MySQL：部署
mysqld-exporter，连接数据库拉取慢查询、连接数等指标 - 自定义应用：引入 client_golang 或 micrometer 库，暴露
/metrics
关键点：指标必须能被 Prometheus 主动抓取，即 HTTP 可达、返回文本格式（Content-Type: text/plain），且端口在容器网络中开放。
二、在 docker-compose.yml 中集成监控组件栈
无需新建文件，直接扩展现有 docker-compose.yml，追加 cadvisor（容器层）、node-exporter（主机层）、prometheus（存储+抓取）、grafana（可视化）四个服务：
-
cadvisor：挂载宿主机关键路径（
/sys、/var/run、/var/lib/docker），监听:8080/metrics -
node-exporter：用
--path.procfs=/host/proc等参数适配容器内路径，暴露:9100/metrics -
prometheus：通过
scrape_configs配置多个 job，包括业务服务（如http://web:8080/actuator/prometheus）、cadvisor、node-exporter -
grafana：映射
3000端口，预置数据源指向http://prometheus:9090，可挂载初始化仪表盘 JSON 文件
所有服务建议共用一个自定义网络（如 monitor_net），避免跨网络 DNS 解析失败。
三、配置 Prometheus 抓取业务指标
在 prometheus.yml 中添加 job，重点注意两点：
MiniMax 图片理解 + 网络搜索 MCP 工具。适配 Docker 环境（极空间等），支持图片 OCR 识别、图像内容理解、网络搜索。API Key 安全存储在本地 credentials 文件，不暴露在代码中。
- 目标地址写容器名+端口（如
web:8080），不是localhost——Docker 内部网络中localhost指当前容器自身 - 设置合理的
scrape_interval（如15s），避免高频抓取拖慢业务服务
示例片段：
scrape_configs:
- job_name: 'spring-boot-app'
static_configs:
- targets: ['web:8080']
metrics_path: '/actuator/prometheus'启动后访问 http://localhost:9090/targets，确认状态为 UP，说明指标已成功接入。
四、Grafana 中快速导入业务看板
登录 Grafana（默认 admin/admin），完成以下操作即可出图：
- 添加 Prometheus 数据源，URL 填
http://prometheus:9090（同网络内容器名可达） - 导入现成模板：搜索 ID
4701（Spring Boot Actuator）、12654（Node.js Express）、或1860（通用容器监控） - 替换面板中的数据源和 job 名称，例如把
job="prometheus"改成job="spring-boot-app"
不需要从零画图。真实业务中，优先关注：HTTP 请求成功率、平均响应时间、JVM 内存使用率、数据库连接池等待数、队列积压量——这些指标直连业务健康度。
五、补充可观测性：日志与链路协同
监控看板只回答“发生了什么”，配合日志和链路才能定位“为什么”。可在同一 compose 文件中加入：
- Loki + Promtail：收集容器 stdout 日志，Grafana 内联动查看对应时间段日志
- Jaeger：业务代码埋点（如 OpenTelemetry SDK），追踪请求完整链路，定位慢接口
它们共享网络和 volume，复用 Prometheus 的服务发现机制，形成日志-指标-链路（Logs-Metrics-Traces）三位一体视图。
