finodigital/mongodb_exporter

Percona MongoDB Exporter镜像

镜像概述

本镜像基于percona/mongodb_exporter分叉开发，是一款用于MongoDB的Prometheus指标导出工具，支持自动识别MongoDB部署类型（分片集群、副本集、单节点）并输出对应指标，满足多场景下的MongoDB监控需求。

核心功能

• 收集MongoDB服务器状态指标（游标、操作、索引、存储等）
• 支持副本集指标（成员状态、延迟、心跳等）
• 提供 oplog 指标（大小、时间长度等）
• 分片集群指标（分片、块、平衡器操作等）
• 存储引擎指标（RocksDB：层级、压缩、缓存；WiredTiger：缓存、块管理、票据等）
• 集合级Top指标（写锁、读锁、查询等）

使用场景

• 企业级MongoDB集群实时监控
• 性能瓶颈分析与优化
• 故障预警与根因排查
• 资源使用情况统计（存储、CPU、内存等）

配置说明

环境变量

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

认证设置

用户名密码认证

1. 在MongoDB中创建具有clusterMonitor角色和local库只读权限的用户：

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

2. 设置环境变量MONGODB_URL：

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

X.509证书认证

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

mongodb://CN=your_name,OU=your_org_unit,O=your_org,L=your_locality,ST=your_state,C=your_country@localhost:27017/?authMechanism=MONGODB-X509

Docker部署示例

基本运行

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

带HTTP认证运行

bash
docker run -d \
  -p 9216:9216 \
  -e MONGODB_URL=mongodb://mongodb_exporter:your_password@localhost:27017 \
  -e HTTP_AUTH=monitor:monitor_pass \
  finodigital/mongodb_exporter

Docker Compose示例

yaml
version: '3'
services:
  mongodb_exporter:
    image: finodigital/mongodb_exporter
    ports:
      - "9216:9216"
    environment:
      - MONGODB_URL=mongodb://mongodb_exporter:your_password@mongo:27017
      - HTTP_AUTH=monitor:monitor_pass
    depends_on:
      - mongo
  mongo:
    image: mongo:latest
    ports:
      - "27017:27017"