elarasu/mongodb_exporter

Percona MongoDB Exporter

镜像概述

本镜像基于Percona开发的MongoDB Exporter（开源项目），用于向Prometheus提供MongoDB的监控指标。该工具支持分片集群、副本集及独立实例的指标采集，当前处于实验阶段，部分字段和功能可能调整。

核心功能

• MongoDB服务器状态指标：游标、操作、索引、存储等
• 副本集指标：成员状态、延迟、ping等
• Oplog指标：大小、时间长度等
• 分片集群指标：分片、块、平衡器操作等
• 存储引擎指标：RocksDB（层级、压缩、缓存、IO速率）、WiredTiger（缓存、块管理、票据）

使用场景

• 监控独立MongoDB实例的运行状态
• 跟踪副本集的复制延迟和成员健康状况
• 分析分片集群的平衡器效率和块分布
• 监控存储引擎的性能指标（缓存使用率、IO情况）

配置说明

环境变量

• MONGODB_URL：MongoDB连接地址（优先级高于-mongodb.uri参数），示例：mongodb://user:pass@localhost:27017
• HTTP_AUTH：HTTP基本认证的用户名密码对，示例：user:password

运行参数

• -web.listen-address：监听地址（默认：:9104）
• -log_dir：日志文件目录（默认：/tmp）
• -h/--help：查看所有参数

认证设置（MongoDB授权）

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

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

2. 设置MONGODB_URL环境变量：

bash
export MONGODB_URL=mongodb://mongodb_exporter:s3cr3tpassw0rd@localhost:27017

Docker部署示例

基础运行（无认证）

bash
docker run -d \
  -p 9104:9104 \
  -e MONGODB_URL=mongodb://localhost:27017 \
  elarasu/mongodb_exporter

带认证运行

bash
docker run -d \
  -p 9104:9104 \
  -e MONGODB_URL=mongodb://mongodb_exporter:s3cr3tpassw0rd@localhost:27017 \
  -e HTTP_AUTH="monitor:monitor123" \
  elarasu/mongodb_exporter

注意事项

• 工具处于实验阶段，字段和功能可能变更
• 支持自动识别MongoDB节点类型（mongos、副本集成员、独立实例），无需按类型部署多个 exporter
• 建议使用环境变量MONGODB_URL而非命令行参数传递敏感信息