andriik/mongodb-profiler-exporter

MongoDB Profiler Exporter Docker镜像文档

镜像概述和主要用途

本镜像为https://github.com/andrii29/mongodb-profiler-exporter%E7%9A%84Docker%E5%8C%96%E7%89%88%E6%9C%AC%EF%BC%8C%E7%94%A8%E4%BA%8E%E4%BB%8EMongoDB%E6%95%B0%E6%8D%AE%E5%BA%93%E6%94%B6%E9%9B%86%E6%80%A7%E8%83%BD%E6%95%B0%E6%8D%AE%EF%BC%88%E5%A6%82%E6%85%A2%E6%9F%A5%E8%AF%A2%E3%80%81%E6%93%8D%E4%BD%9C%E8%80%97%E6%97%B6%E7%AD%89%EF%BC%89%EF%BC%8C%E5%B9%B6%E5%B0%86%E5%85%B6%E5%AF%BC%E5%87%BA%E4%B8%BAPrometheus%E5%8F%AF%E6%8A%93%E5%8F%96%E7%9A%84%E6%8C%87%E6%A0%87%E6%A0%BC%E5%BC%8F%EF%BC%8C%E6%96%B9%E4%BE%BF%E9%9B%86%E6%88%90%E5%88%B0Prometheus%E7%9B%91%E6%8E%A7%E4%BD%93%E7%B3%BB%E4%B8%AD%E8%BF%9B%E8%A1%8C%E5%8F%AF%E8%A7%86%E5%8C%96%E5%92%8C%E5%91%8A%E8%AD%A6%E3%80%82

核心功能

• 支持通过MongoDB URI连接到MongoDB实例（单机或集群）
• 定期解析MongoDB性能数据（可配置解析间隔）
• 暴露HTTP端点提供Prometheus格式的监控指标
• 支持自定义指标端点路径、监听IP和端口
• 可配置标签字符串最大长度，避免指标标签过长

使用场景

• MongoDB数据库性能实时监控
• 慢查询分析与优化
• 集成Prometheus+Grafana构建MongoDB监控面板
• 数据库操作耗时趋势分析
• 多MongoDB实例统一监控

使用方法

基本使用

使用默认配置运行 exporter（连接本地MongoDB mongodb://127.0.0.1:27017/，监听端口9179，指标端点/metrics）：

bash
docker run --rm -it andriik/mongodb-profiler-exporter

连接本地MongoDB

当MongoDB与容器运行在同一主机且未暴露到外部网络时，可使用--net host让容器共享主机网络命名空间：

bash
docker run --rm -it --net host andriik/mongodb-profiler-exporter

自定义MongoDB连接和参数

指定自定义MongoDB URI、数据解析间隔（秒）等参数：

bash
docker run --rm -it -p 9179:9179 \
  -e MONGODB_URI="mongodb://your-mongo-host:27017/" \
  -e WAIT_INTERVAL=5 \
  andriik/mongodb-profiler-exporter

自定义监听IP和端口

修改exporter监听的IP地址和端口：

bash
docker run --rm -it -p 9179:9179 \
  -e LISTEN_IP="127.0.0.1" \
  -e LISTEN_PORT=9179 \
  andriik/mongodb-profiler-exporter

自定义指标端点路径

修改Prometheus指标的暴露路径：

bash
docker run --rm -it -p 9179:9179 \
  -e METRICS_ENDPOINT="/metrics" \
  andriik/mongodb-profiler-exporter

认证设置

若MongoDB启用了认证，需先创建具有监控权限的用户，再配置连接URI：

1. 登录MongoDB并创建用户：

bash
mongosh
use admin
db.createUser({
  user: "mongodb-profiler-exporter",
  pwd: passwordPrompt(),  # 输入密码
  roles: [ { role: "clusterMonitor", db: "admin" } ]
})

2. 使用认证URI运行exporter：

bash
docker run --rm -it -p 9179:9179 \
  -e MONGODB_URI="mongodb://mongodb-profiler-exporter:<password>@127.0.0.1:27017/admin?authSource=admin&readPreference=primaryPreferred/" \
  andriik/mongodb-profiler-exporter

注意：将<password>替换为实际创建用户时设置的密码。

启用MongoDB Profiler

exporter依赖MongoDB Profiler收集性能数据，需先在目标数据库中启用Profiler：

1. 查看当前Profiler状态：

bash
use db_name  # 切换到目标数据库
db.getProfilingStatus()

2. 启用Profiler（示例：记录执行时间超过10ms的操作）：

bash
db.setProfilingLevel(1, { slowms: 10 })

说明：setProfilingLevel第一个参数为级别（0=禁用，1=仅记录慢查询，2=记录所有操作），slowms指定慢查询阈值（毫秒）。

配置参数说明

exporter支持通过命令行参数或环境变量进行配置，以下为主要参数说明：

注：命令行参数优先级高于环境变量，若同时指定，以命令行参数为准。