boube/mongodb-exporter

Percona MongoDB Exporter Docker镜像文档

镜像概述

本镜像基于Percona MongoDB Exporter构建，用于暴露MongoDB的Prometheus兼容指标，支持监控副本集、分片集群及多种关键运行指标。通过该镜像，用户可轻松将MongoDB的性能和状态数据集成到Prometheus监控系统中，实现可视化和告警。

• 项目源码：https://github.com/percona/mongodb_exporter
• 自动化构建：[***]
• Dockerfile来源：https://github.com/percona/mongodb_exporter/blob/master/Dockerfile

核心功能和特性

• 多场景支持：兼容MongoDB副本集、分片集群及单节点部署
• Prometheus兼容：暴露符合Prometheus规范的指标接口，支持直接采集
• 丰富指标集：涵盖数据库连接数、操作延迟、副本集同步状态、分片集群健康度等关键指标
• 轻量部署：基于官方Dockerfile构建，镜像体积小，资源占用低

使用场景和适用范围

• 生产环境监控：适用于需要对MongoDB副本集或分片集群进行实时监控的生产环境
• 性能分析：通过Prometheus+Grafana组合，实现MongoDB性能指标的可视化分析
• 告警配置：结合Prometheus告警规则，对异常指标（如连接数过高、副本集延迟）进行及时告警
• CI/CD集成：可作为监控组件集成到容器化部署流程中

使用方法和配置说明

基本部署（Docker Run）

bash
docker run -d \
  --name mongodb-exporter \
  -p 9216:9216 \
  percona/mongodb-exporter \
  --mongodb.uri="mongodb://<username>:<password>@<mongodb-host>:27017/admin?authSource=admin"

Docker Compose配置

yaml
version: '3'
services:
  mongodb-exporter:
    image: percona/mongodb-exporter
    ports:
      - "9216:9216"
    command:
      - --mongodb.uri=mongodb://user:password@mongodb:27017/admin?authSource=admin
    depends_on:
      - mongodb
    restart: always

关键配置参数

指标访问

启动容器后，可通过 http://<容器IP>:9216/metrics 访问Prometheus格式的指标数据，例如：

mongodb_up 1
mongodb_replset_member_state 1
mongodb_connections_current 10
mongodb_operations_insert_total 1234