percona/mongodb-exporter 镜像文档

1. 镜像概述和主要用途

percona/mongodb-exporter 镜像包含 percona/mongodb_exporter 可执行文件，是一个轻量级工具，用于从MongoDB实例（包括独立实例、复制集和分片集群）收集性能、状态及运行指标，并以Prometheus兼容格式导出，便于集成到Prometheus监控体系中实现可视化监控和告警。

2. 核心功能和特性

• 全面指标收集：支持收集MongoDB关键指标，包括连接数（当前/可用连接）、操作统计（插入/查询/更新/删除操作量）、复制集状态（成员健康、同步延迟、投票状态）、索引性能（命中/未命中次数）、内存使用（缓存命中率、内存映射大小）等。
• Prometheus兼容：导出的指标符合Prometheus数据规范，可直接被Prometheus抓取并存储。
• 轻量级设计：基于精简基础镜像构建，资源占用低，部署便捷。
• 灵活配置：支持通过命令行参数或环境变量自定义MongoDB连接信息、监听端口、指标收集范围等。

3. 使用场景和适用范围

• MongoDB监控需求：适用于需实时监控MongoDB运行状态的场景，如生产环境性能监控、开发/测试环境问题排查。
• Prometheus监控栈集成：作为Prometheus与MongoDB间的指标桥梁，配合Grafana可构建可视化监控面板。
• 多环境适配：支持独立MongoDB实例、复制集及分片集群架构，兼容主流MongoDB版本。

4. 使用方法和配置说明

4.1 基本使用（docker run）

通过docker run命令启动容器，需指定MongoDB连接信息及必要配置：

docker run -d \
  --name mongodb-exporter \
  -p 9216:9216 \  # 导出器默认监听端口
  percona/mongodb-exporter \
  --mongodb.uri=mongodb://<user>:<password>@<mongodb-host>:27017/ \  # MongoDB连接URI（必填）
  --web.listen-address=:9216 \  # 导出器监听地址（默认:9216）
  --collect-all  # 启用全量指标收集（默认仅核心指标）

4.2 核心配置参数

4.3 环境变量配置

支持通过环境变量简化配置，常用变量如下：

示例：

docker run -d \
  --name mongodb-exporter \
  -p 9216:9216 \
  -e MONGODB_URI="mongodb://admin:pass@mongo-1:27017/admin?authSource=admin" \
  -e LISTEN_PORT=9216 \
  percona/mongodb-exporter --collect-replset

4.4 docker-compose配置示例

在docker-compose.yml中集成，实现MongoDB与exporter联动部署：

version: '3.8'
services:
  mongodb:
    image: mongo:6.0
    container_name: mongodb
    ports:
      - "27017:27017"
    environment:
      - MONGO_INITDB_ROOT_USERNAME=admin
      - MONGO_INITDB_ROOT_PASSWORD=secret
    restart: unless-stopped

  mongodb-exporter:
    image: percona/mongodb-exporter
    container_name: mongodb-exporter
    ports:
      - "9216:9216"
    command:
      - --mongodb.uri=mongodb://admin:secret@mongodb:27017/admin?authSource=admin
      - --collect-all
    depends_on:
      - mongodb
    restart: unless-stopped

4.5 与Prometheus集成

在Prometheus配置文件（prometheus.yml）中添加抓取配置：

scrape_configs:
  - job_name: 'mongodb'
    static_configs:
      - targets: ['mongodb-exporter:9216']  # 指向exporter容器地址:端口（需确保网络互通）
    scrape_interval: 10s  # 抓取频率

启动Prometheus后，可在UI（默认http://<prometheus-host>:9090）中查询MongoDB指标，如mongodb_connections_current（当前连接数）、mongodb_ops_insert_total（插入操作总量）等。

4.6 注意事项

• 权限配置：连接MongoDB的用户需具备readAnyDatabase和clusterMonitor角色（复制集/分片集群），确保可读取监控指标。
• 网络互通：exporter容器需与MongoDB实例网络互通，可通过Docker网络（如--network参数）或宿主机网络配置实现。
• 版本兼容性：建议使用与MongoDB版本匹配的exporter版本，版本对应关系可参考官方文档。