ssheehy/mongodb-exporter

Percona MongoDB Exporter

基于David Cuadrado的MongoDB Exporter fork优化，提供MongoDB分片集群完整支持，用于采集MongoDB各类监控指标，可无缝集成Prometheus实现可视化监控。

核心功能

• MongoDB服务器状态指标：游标、操作、索引、存储等
• MongoDB副本集指标：成员状态、ping、复制延迟等
• MongoDB Oplog指标：大小、时间长度等
• MongoDB分片指标：分片、块、数据库/集合、均衡器操作等
• RocksDB存储引擎指标：层级、压缩、缓存使用、I/O速率等
• WiredTiger存储引擎指标：缓存、块管理器、ticket等
• 按集合的Top指标：写锁、读锁、查询等

使用场景

• MongoDB单机/集群性能监控与分析
• 副本集复制延迟、分片均衡状态追踪
• 存储引擎资源使用监控
• 集成Prometheus+Grafana构建MongoDB监控dashboard

配置说明

环境变量

• MONGODB_URI：MongoDB连接地址（优先级高于--mongodb.uri参数）
• HTTP_AUTH：HTTP基础认证的用户名密码对（格式：user:password）

认证设置

用户名密码认证

1. 创建具有clusterMonitor角色和local数据库读权限的用户：

js
db.getSiblingDB("admin").createUser({
    user: "mongodb_exporter",
    pwd: "your_password",
    roles: [
        { role: "clusterMonitor", db: "admin" },
        { role: "read", db: "local" }
    ]
})

2. 设置环境变量启动：

bash
export MONGODB_URI=mongodb://mongodb_exporter:your_password@localhost:27017

X.509证书认证

通过连接字符串传递用户名和认证机制：

mongodb://CN=myName,OU=myOrgUnit,O=myOrg,L=myLocality,ST=myState,C=myCountry@localhost:27017/?authMechanism=MONGODB-X509

部署示例

Docker Run

bash
docker run -d \
  -e MONGODB_URI=mongodb://mongodb_exporter:your_password@mongo-host:27017 \
  -p 9216:9216 \
  ssheehy/mongodb-exporter

Kubernetes部署

使用Helm稳定仓库的prometheus-mongodb-exporter chart：

bash
helm repo add stable [***]
helm install my-mongodb-exporter stable/prometheus-mongodb-exporter \
  --set mongodb.uri=mongodb://mongodb_exporter:your_password@mongo-host:27017