MongoDB Exporter (Squashed Version) 镜像文档

1. 镜像概述

本镜像为Bitnami提供的MongoDB Exporter的压缩版本，基于bitnami-docker-mongodb-exporter项目构建。MongoDB Exporter是一款用于收集MongoDB数据库指标的工具，可将指标标准化并导出，供Prometheus等监控系统抓取，实现对MongoDB的实时监控与性能分析。压缩版本（Squashed version）通过优化镜像层结构减小体积，提升部署效率。

2. 核心功能与特性

2.1 指标收集能力

• 覆盖MongoDB核心指标：数据库状态（如up）、连接数（connections_current、connections_available）、查询性能（operations_insert、operations_query）、存储使用（dbstats_dataSize、dbstats_indexSize）、副本集状态（replicaset_member_state）等。
• 支持自定义指标过滤，可通过配置仅导出关注的指标。

2.2 监控集成

• 原生支持Prometheus：指标默认以Prometheus格式暴露，可直接被Prometheus抓取。
• 兼容Grafana：配合Grafana可实现指标可视化，支持***MongoDB监控面板模板。

2.3 轻量级设计

• 压缩版本镜像体积更小，减少存储空间占用和网络传输开销，适合资源受限环境部署。
• 基于Bitnami最小化基础镜像，降低依赖复杂度，提升安全性。

3. 使用场景与适用范围

3.1 典型场景

• MongoDB实例监控：实时追踪单节点或副本集MongoDB的运行状态。
• 性能问题排查：通过指标分析慢查询、连接瓶颈、存储增长趋势等。
• 告警规则配置：结合Prometheus Alertmanager，基于指标阈值触发告警（如连接数过高、副本集同步延迟）。
• 容器化环境集成：适配Kubernetes、Docker Swarm等容器编排平台，作为监控组件部署。

3.2 适用对象

• 运维工程师：用于MongoDB集群日常监控与问题排查。
• 开发团队：评估数据库性能对应用的影响。
• DevOps团队：构建完整的监控告警链路。

4. 使用方法与配置说明

4.1 基本部署（docker run）

通过docker run命令快速启动容器，需指定MongoDB连接信息及暴露指标端口：

bash
docker run -d \
  --name mongodb-exporter \
  -p 9216:9216 \  # 指标暴露端口（默认9216）
  -e MONGODB_URI="mongodb://<username>:<password>@<mongodb-host>:<mongodb-port>/admin?ssl=false" \  # MongoDB连接URI
  bitnami/mongodb-exporter:squashed

4.2 Docker Compose配置

在docker-compose.yml中集成MongoDB Exporter，示例如下（含MongoDB和Prometheus）：

yaml
version: '3'
services:
  mongodb:
    image: bitnami/mongodb:latest
    environment:
      - MONGODB_ROOT_USER=root
      - MONGODB_ROOT_PASSWORD=rootpassword
    ports:
      - "27017:27017"

  mongodb-exporter:
    image: bitnami/mongodb-exporter:squashed
    ports:
      - "9216:9216"
    environment:
      - MONGODB_URI="mongodb://root:rootpassword@mongodb:27017/admin?ssl=false"
    depends_on:
      - mongodb

  prometheus:
    image: prom/prometheus:latest
    volumes:
      - ./prometheus.yml:/etc/prometheus/prometheus.yml
    ports:
      - "9090:9090"

4.3 环境变量配置

通过环境变量自定义Exporter行为，常用配置如下：

4.4 指标访问与验证

容器启动后，可通过http://<容器IP>:9216/metrics访问导出的指标。示例Prometheus配置（prometheus.yml）：

yaml
scrape_configs:
  - job_name: 'mongodb'
    static_configs:
      - targets: ['mongodb-exporter:9216']  # 容器名或IP:端口

5. 注意事项

• 权限要求：MongoDB用户需具备read权限（至少对admin数据库），副本集监控需额外clusterMonitor角色。
• 网络连通性：确保Exporter容器与MongoDB实例、Prometheus之间网络互通。
• 版本兼容性：建议使用与MongoDB版本匹配的Exporter版本（参考***文档）。
• 镜像更新：通过指定标签（如latest、0.40.0）控制版本，避免自动升级导致兼容性问题。