让开源，少一点语言距离。
npm包中文文档

@christiangalsterer/mongodb-driver-prometheus-exporter

中文文档
3.0.0发布于 2025/12/13MITTypeScriptCommonJS构建来源已验证近 30 天下载 9949

Prometheus 出口国监测 MongoDB 节点驱动程序

中文使用文档
中文原文
文档目录5 节
  1. 可用计量
  2. 示例输出
  3. 依赖性
  4. 类型脚本
  5. Java 脚本

GitHub Actions CI Status codecov Coveralls Known Vulnerabilities npm downloads npm version npm license semver Conventional Commits renovate code style: prettier github stars

为 MongoDB 官方节点驱动程序提供的Prometheus Exporter

向官员披露衡量标准 MongoDB 节点Js 驱动程序。 。 。 .

计量单位名称沿用了下列方法使用的相同命名惯例: 微米。这允许在仪表板上使用相同的度量衡,并跨不同技术堆栈发出警报,例如,在不同的应用中使用Spring Boot和Node.js时.

可用计量

出口商提供以下衡量标准.

计量名称说明标签自兹
mongodb driver pool 大小连接池的当前大小,包括闲置成员和使用中的成员
  • 服务器地址( s): 驱动程序连接的 MongoDB 服务实例的 URL
    		1.0.0 (单位:千美元)
    蒙戈德布 司机 pool min连接池最小大小
    • 服务器地址( s): 驱动程序连接的 MongoDB 服务实例的 URL
      		1.0.0 (单位:千美元)
      mongodb driver pool max (英语)连接池的最大大小
      • 服务器地址( s): 驱动程序连接的 MongoDB 服务实例的 URL
        		1.0.0 (单位:千美元)
        mongodb driver pool 已检查正在使用的连接数
        • 服务器地址( s): 驱动程序连接的 MongoDB 服务实例的 URL
          		1.0.0 (单位:千美元)
          mongodb driver pool waitqueuesize 鼠标从池中连接的当前等待队列大小
          • 服务器地址( s): 驱动程序连接的 MongoDB 服务实例的 URL
            		1.0.0 (单位:千美元)
            mongodb driver pool waitqueue seconds sum (韩语)等待时间( 秒)
            * 要求 mongodb >= 6.9.0
            • 服务器地址( s): 驱动程序连接的 MongoDB 服务实例的 URL
            • 状态: 失败或失败
              		2.3.0 (单位:千美元)
              mongodb driver pool waitqueue 秒数从 waitquue 检查的连接总数
              * 要求 mongodb >= 6.9.0
              • 服务器地址( s): 驱动程序连接的 MongoDB 服务实例的 URL
              • 状态: 失败或失败
                		2.3.0 (单位:千美元)
                mongodb 驱动程序 命令 秒 和执行命令的持续时间( 以秒计)
                • 服务器地址( s): 驱动程序连接的 MongoDB 服务实例的 URL
                • 命令: 如果命令的名称
                • 状态: 失败或失败
                  		1.0.0 (单位:千美元)
                  mongodb 驱动程序 命令 秒 计数已执行命令的数目
                  • 服务器地址( s): 驱动程序连接的 MongoDB 服务实例的 URL
                  • 命令: 如果命令的名称
                  • 状态: 失败或失败
                    		1.0.0 (单位:千美元)

                    示例输出

                    这里举出一个实例,以提供的度量符的正方形格式输出.

                    # HELP mongodb_driver_pool_size the current size of the connection pool, including idle and and in-use members
# TYPE mongodb_driver_pool_size gauge
mongodb_driver_pool_size{server_address="127.0.0.1:27017"} 0
mongodb_driver_pool_size{server_address="127.0.0.2:27017"} 0
mongodb_driver_pool_size{server_address="127.0.0.3:27017"} 1

# HELP mongodb_driver_pool_min the minimum size of the connection pool
# TYPE mongodb_driver_pool_min gauge
mongodb_driver_pool_min{server_address="127.0.0.1:27017"} 0
mongodb_driver_pool_min{server_address="127.0.0.2:27017"} 0
mongodb_driver_pool_min{server_address="127.0.0.3:27017"} 0

# HELP mongodb_driver_pool_max the maximum size of the connection pool
# TYPE mongodb_driver_pool_max gauge
mongodb_driver_pool_max{server_address="127.0.0.1:27017"} 100
mongodb_driver_pool_max{server_address="127.0.0.2:27017"} 100
mongodb_driver_pool_max{server_address="127.0.0.3:27017"} 100

# HELP mongodb_driver_pool_checkedout the count of connections that are currently in use
# TYPE mongodb_driver_pool_checkedout gauge
mongodb_driver_pool_checkedout{server_address="127.0.0.1:27017"} 0
mongodb_driver_pool_checkedout{server_address="127.0.0.2:27017"} 0
mongodb_driver_pool_checkedout{server_address="127.0.0.3:27017"} 1

# HELP mongodb_driver_pool_waitqueuesize the current size of the wait queue for a connection from the pool
# TYPE mongodb_driver_pool_waitqueuesize gauge
mongodb_driver_pool_waitqueuesize{server_address="127.0.0.1:27017"} 0
mongodb_driver_pool_waitqueuesize{server_address="127.0.0.2:27017"} 0
mongodb_driver_pool_waitqueuesize{server_address="127.0.0.3:27017"} 0

# HELP mongodb_driver_pool_waitqueue_seconds Duratrion of mongodb connection wait queue
# TYPE mongodb_driver_pool_waitqueue_seconds histogram
mongodb_driver_pool_waitqueue_seconds_bucket{le="0.001",server_address="127.0.0.3:27017",status="SUCCESS"} 141
mongodb_driver_pool_waitqueue_seconds_bucket{le="0.005",server_address="127.0.0.3:27017",status="SUCCESS"} 141
mongodb_driver_pool_waitqueue_seconds_bucket{le="0.01",server_address="127.0.0.3:27017",status="SUCCESS"} 145
mongodb_driver_pool_waitqueue_seconds_bucket{le="0.02",server_address="127.0.0.3:27017",status="SUCCESS"} 148
mongodb_driver_pool_waitqueue_seconds_bucket{le="0.03",server_address="127.0.0.3:27017",status="SUCCESS"} 151
mongodb_driver_pool_waitqueue_seconds_bucket{le="0.04",server_address="127.0.0.3:27017",status="SUCCESS"} 152
mongodb_driver_pool_waitqueue_seconds_bucket{le="0.05",server_address="127.0.0.3:27017",status="SUCCESS"} 155
mongodb_driver_pool_waitqueue_seconds_bucket{le="0.1",server_address="127.0.0.3:27017",status="SUCCESS"} 214
mongodb_driver_pool_waitqueue_seconds_bucket{le="0.2",server_address="127.0.0.3:27017",status="SUCCESS"} 223
mongodb_driver_pool_waitqueue_seconds_bucket{le="0.5",server_address="127.0.0.3:27017",status="SUCCESS"} 223
mongodb_driver_pool_waitqueue_seconds_bucket{le="1",server_address="127.0.0.3:27017",status="SUCCESS"} 223
mongodb_driver_pool_waitqueue_seconds_bucket{le="2",server_address="127.0.0.3:27017",status="SUCCESS"} 223
mongodb_driver_pool_waitqueue_seconds_bucket{le="5",server_address="127.0.0.3:27017",status="SUCCESS"} 223
mongodb_driver_pool_waitqueue_seconds_bucket{le="10",server_address="127.0.0.3:27017",status="SUCCESS"} 223
mongodb_driver_pool_waitqueue_seconds_bucket{le="+Inf",server_address="127.0.0.3:27017",status="SUCCESS"} 223
mongodb_driver_pool_waitqueue_seconds_sum{server_address="127.0.0.3:27017",status="SUCCESS"} 6.4500000000000055
mongodb_driver_pool_waitqueue_seconds_count{server_address="127.0.0.3:27017",status="SUCCESS"} 223

# HELP mongodb_driver_commands_seconds Timer of mongodb commands
# TYPE mongodb_driver_commands_seconds histogram
mongodb_driver_commands_seconds_bucket{le="0.005",command="ping",server_address="127.0.0.3:27017",status="SUCCESS"} 0
mongodb_driver_commands_seconds_bucket{le="0.01",command="ping",server_address="127.0.0.3:27017",status="SUCCESS"} 0
mongodb_driver_commands_seconds_bucket{le="0.025",command="ping",server_address="127.0.0.3:27017",status="SUCCESS"} 0
mongodb_driver_commands_seconds_bucket{le="0.05",command="ping",server_address="127.0.0.3:27017",status="SUCCESS"} 0
mongodb_driver_commands_seconds_bucket{le="0.1",command="ping",server_address="127.0.0.3:27017",status="SUCCESS"} 0
mongodb_driver_commands_seconds_bucket{le="0.25",command="ping",server_address="127.0.0.3:27017",status="SUCCESS"} 0
mongodb_driver_commands_seconds_bucket{le="0.5",command="ping",server_address="127.0.0.3:27017",status="SUCCESS"} 0
mongodb_driver_commands_seconds_bucket{le="1",command="ping",server_address="127.0.0.3:27017",status="SUCCESS"} 0
mongodb_driver_commands_seconds_bucket{le="2.5",command="ping",server_address="127.0.0.3:27017",status="SUCCESS"} 0
mongodb_driver_commands_seconds_bucket{le="5",command="ping",server_address="127.0.0.3:27017",status="SUCCESS"} 0
mongodb_driver_commands_seconds_bucket{le="10",command="ping",server_address="127.0.0.3:27017",status="SUCCESS"} 0
mongodb_driver_commands_seconds_bucket{le="+Inf",command="ping",server_address="127.0.0.3:27017",status="SUCCESS"} 21
mongodb_driver_commands_seconds_sum{command="ping",server_address="127.0.0.3:27017",status="SUCCESS"} 971000
mongodb_driver_commands_seconds_count{command="ping",server_address="127.0.0.3:27017",status="SUCCESS"} 21

                    使用量

                    依赖性

                    在您的工程中添加以下依赖性以下载软件包 无。 。 。 .

                    npm i @christiangalsterer/mongodb-driver-prometheus-exporter

                    类型脚本

                    以下例子说明如何利用出口商监测MongoDB节点.js驱动程序.

                    import { MongoClient } from "mongodb";
import { Registry, collectDefaultMetrics } from "prom-client";
import { monitorMongoDBDriver } from "@christiangalsterer/mongodb-driver-prometheus-exporter";

...

// set up the MongoDB client, monitorCommands needs to be set to true to enable command monitoring.
const mongoClient = new MongoClient("mongodb", { monitorCommands: true })

// set up the prometheus client
const register = new Registry();
collectDefaultMetrics({ register });

// monitor MongoDB driver
monitorMongoDBDriver(mongoClient, register);

...

// connect to MongoDB after calling monitorMongoDBDriver()
mongoClient.connect();

                    Java 脚本

                    以下例子说明如何利用出口商监测MongoDB节点.js驱动程序.

                    const MongoClient = require('mongodb');
const promClient = require( 'prom-client');
const exporter = require('@christiangalsterer/mongodb-driver-prometheus-exporter')

...

// set up the MongoDB client, monitorCommands needs to be set to true to enable command monitoring.
const mongoClient = new MongoClient("mongodb", { monitorCommands: true })

// set up the prometheus client
const collectDefaultMetrics = promClient.collectDefaultMetrics;
const Registry = promClient.Registry;
const register = new Registry();
collectDefaultMetrics({ register });

// monitor MongoDB driver
exporter.monitorMongoDBDriver(client, register);

...

// connect to MongoDB after calling monitorMongoDBDriver()
mongoClient.connect();

                    配置

                    出口商可以通过类型可选参数指定的属性配置 MongoDB 驱动程序输出选项。 。 。 .

                    属性说明示例自兹
                    司机二等相图以秒计的buckets for the mongodb driver commands seconds bucket 度量衡 。 默认桶为[0.001,0.005,0.01,0.02,0.03,0.04,0.05,0.1,0.2,0.5,1,2,5,10][0.001、0.005、0.01、0.02、0.03、0.04、0.05、0.1、0.2、0.5、1、2、5、10]1.0.0 (单位:千美元)
                    等待 QueetsecondsHistogramBuckets 数据Buckets for the mongodb driver pool waitqueue seconds bucket 度量衡以秒计. 默认桶为[0.001,0.005,0.01,0.02,0.03,0.04,0.05,0.1,0.2,0.5,1,2,5,10][0.001、0.005、0.01、0.02、0.03、0.04、0.05、0.1、0.2、0.5、1、2、5、10]2.3.0 (单位:千美元)
                    默认标签默认标签添加到每个参数中 .{'foo':'bar','alice': 3} (中文(简体) )1.1.0 国家
                    前缀所有度量衡的计量名前缀.'服务 1 '2.1.0 国家

                    格拉法纳板

                    Grafana 的示例 这里 显示出口商提供的衡量标准.

                    这里有一个收集指标的例子: Grafana:Collection Metrics

                    这里有一个命令度量标准的例子: Grafana:Commands Metrics

                    更改日志

                    项目的更改可见于 更改日志。 。 。 .

                    兼容性

                    下表列出出口商版本与 MongoDB Driver 和 prom客户端版本的相容性.

                    导出版本MongoDB 驱动程序版本舞会客户端版本
                    ^ 1. 0^ 5.8.0 (中文(简体) )^14.2.0 (中文(简体) )
                    ^ 2. 0^ 6. 0^15.0

                    捐款

                    发言是十分受欢迎的。 如欲为该项目捐款,请遵循本报告所述步骤 捐款准则。 。 。 .

                    使用导出者的项目

                    如果您想要支持此项目, 请在您使用此导出时在您的项目和/ 或公司中添加链接 .

                    相关项目

                    如果你正在寻找一种方法 监视KafkaJS的节点 https://github.com/christiangalster/kafkajs-prometheus-exporter (中文(简体) )。 。 。 .

                    如果你正在寻找一种方法 监视节点 -派克,你可能会看到 https://github.com/christiangalster/node-postgres-prometheus-exporter 互联网档案馆的存檔,存档日期2013-12-21。 。 。 .

                    版本与发布记录

                    @christiangalsterer/mongodb-driver-prometheus-exporter 共发布 18 个版本，首次发布于 2023/07/21；过去 12 个月发布了 1 个版本。最新版本附带 npm provenance 构建来源证明，可追溯到公开的 CI 构建记录。

                    版本发布日期距今
                    3.0.0latest2025/12/1310 个月前
                    2.3.02024/12/141.9 年前
                    2.2.22024/10/052 年前
                    2.2.12024/10/032 年前
                    2.2.02024/05/082 年前
                    2.1.02023/11/192 年前

                    关于 @christiangalsterer/mongodb-driver-prometheus-exporter 的常见问题

                    @christiangalsterer/mongodb-driver-prometheus-exporter 是什么？

                    Prometheus 出口国监测 MongoDB 节点驱动程序

                    如何安装 @christiangalsterer/mongodb-driver-prometheus-exporter？

                    在项目目录运行 npm install @christiangalsterer/mongodb-driver-prometheus-exporter，或使用 pnpm add / yarn add / bun add。

                    @christiangalsterer/mongodb-driver-prometheus-exporter 支持 TypeScript 吗？

                    支持。包内自带 TypeScript 类型声明（package.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

                    @christiangalsterer/mongodb-driver-prometheus-exporter 支持 ESM 还是 CommonJS？

                    以 CommonJS 形式发布，可以直接 require()；在 ES Module 项目中也可以用 import 引入（Node.js 会把 module.exports 作为默认导出）。

                    @christiangalsterer/mongodb-driver-prometheus-exporter 需要什么版本的 Node.js？

                    package.json 的 engines 字段要求 Node.js >=18。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

                    @christiangalsterer/mongodb-driver-prometheus-exporter 可以商用吗？

                    @christiangalsterer/mongodb-driver-prometheus-exporter 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

                    @christiangalsterer/mongodb-driver-prometheus-exporter 的下载量有多少？

                    根据 npm 官方下载统计，@christiangalsterer/mongodb-driver-prometheus-exporter 在 2026/10/10 – 2026/11/08 这 30 天内被下载 9,949 次，日均约 332 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

                    @christiangalsterer/mongodb-driver-prometheus-exporter 还在维护吗？

                    最新版本 3.0.0 发布于 2025/12/13（10 个月前）；至今共发布 18 个版本，其中过去 12 个月发布了 1 个；首次发布于 2023/07/21。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。