mongodb-profiler-exporter Docker 镜像下载 - 轩辕镜像

MongoDB Profiler Exporter Docker镜像文档

镜像概述和主要用途

本镜像为mongodb-profiler-exporter的Docker化版本，用于从MongoDB数据库收集性能数据（如慢查询、操作耗时等），并将其导出为Prometheus可抓取的指标格式，方便集成到Prometheus监控体系中进行可视化和告警。

核心功能

• 支持通过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支持通过命令行参数或环境变量进行配置，以下为主要参数说明：

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