# @christiangalsterer/mongodb-driver-prometheus-exporter 中文文档 规范地址：https://npmcn.com/package/%40christiangalsterer/mongodb-driver-prometheus-exporter/ 版本：3\.0\.0 npm 元数据更新时间：2025-12-13T15:20:02.943Z 中文译文更新时间：2026-11-09T15:02:04.904Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40christiangalsterer/mongodb-driver-prometheus-exporter 原文对照：https://npmcn.com/package/%40christiangalsterer/mongodb-driver-prometheus-exporter/?lang=original 项目主页：https://github.com/christiangalsterer/mongodb-driver-prometheus-exporter#readme 源码仓库：https://github.com/christiangalsterer/mongodb-driver-prometheus-exporter ## 关键信息（来自 npm 元数据） - 包体积（解压后）：48.2 kB，15 个文件 - 模块格式：CommonJS - TypeScript 类型：包内自带 - Node.js 要求：\>=18 - 运行依赖：2 个 - 首次发布：2023-07-20T16:34:57.128Z - 最新版本发布：2025-12-13T15:20:02.517Z - 近 30 天下载量：9949（2026-10-10 至 2026-11-08，npm 官方下载统计） - 已发布版本数：18（近 12 个月 1 个） ## 中文简介 Prometheus 出口国监测 MongoDB 节点驱动程序 ## 安装 ```sh npm install @christiangalsterer/mongodb-driver-prometheus-exporter ``` 也可以使用：`pnpm add @christiangalsterer/mongodb-driver-prometheus-exporter`、`yarn add @christiangalsterer/mongodb-driver-prometheus-exporter`、`bun add @christiangalsterer/mongodb-driver-prometheus-exporter` ## README [![GitHub Actions CI Status](https://github.com/christiangalsterer/mongodb-driver-prometheus-exporter/actions/workflows/build.yaml/badge.svg)](https://github.com/christiangalsterer/mongodb-driver-prometheus-exporter/actions/workflows/build.yaml) [![codecov](https://codecov.io/gh/christiangalsterer/mongodb-driver-prometheus-exporter/graph/badge.svg?token=Q4POJZ46LC)](https://codecov.io/gh/christiangalsterer/mongodb-driver-prometheus-exporter) [![Coveralls](https://coveralls.io/repos/github/christiangalsterer/mongodb-driver-prometheus-exporter/badge.svg?branch=main)](https://coveralls.io/github/christiangalsterer/mongodb-driver-prometheus-exporter?branch=main) [![Known Vulnerabilities](https://snyk.io/test/github/christiangalsterer/mongodb-driver-prometheus-exporter/badge.svg)](https://github.com/christiangalsterer/mongodb-driver-prometheus-exporter/security/advisories) [![npm downloads](https://img.shields.io/npm/dt/@christiangalsterer/mongodb-driver-prometheus-exporter.svg)](https://www.npmjs.com/package/@christiangalsterer/mongodb-driver-prometheus-exporter) [![npm version](https://img.shields.io/npm/v/@christiangalsterer/mongodb-driver-prometheus-exporter.svg)](https://www.npmjs.com/package/@christiangalsterer/mongodb-driver-prometheus-exporter?activeTab=versions) [![npm license](https://img.shields.io/npm/l/@christiangalsterer/mongodb-driver-prometheus-exporter.svg)](https://www.npmjs.com/package/@christiangalsterer/mongodb-driver-prometheus-exporter) [![semver](https://img.shields.io/badge/semver-2.0.0-green)](https://semver.org/) [![Conventional Commits](https://img.shields.io/badge/Conventional%20Commits-1.0.0-yellow.svg)](https://conventionalcommits.org/) [![renovate](https://img.shields.io/badge/renovate-enabled-brightgreen.svg)](https://developer.mend.io/github/christiangalsterer/mongodb-driver-prometheus-exporter) [![code style: prettier](https://img.shields.io/badge/code_style-prettier-ff69b4.svg?style=flat-square)](https://github.com/prettier/prettier) ![github stars](https://img.shields.io/github/stars/christiangalsterer/mongodb-driver-prometheus-exporter.svg) # 为 MongoDB 官方节点驱动程序提供的Prometheus Exporter 向官员披露衡量标准 [MongoDB 节点Js 驱动程序](https://www.mongodb.com/docs/drivers/node/current/)。 。 。 . 计量单位名称沿用了下列方法使用的相同命名惯例: [微米](https://github.com/micrometer-metrics/micrometer)。这允许在仪表板上使用相同的度量衡,并跨不同技术堆栈发出警报,例如,在不同的应用中使用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 (单位:千美元) | ## 示例输出 这里举出一个实例,以提供的度量符的正方形格式输出. ```sh # 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 ``` # 使用量 ## 依赖性 在您的工程中添加以下依赖性以下载软件包 [无](https://www.npmjs.com/package/@christiangalsterer/mongodb-driver-prometheus-exporter)。 。 。 . ```sh npm i @christiangalsterer/mongodb-driver-prometheus-exporter ``` ## 类型脚本 以下例子说明如何利用出口商监测MongoDB节点.js驱动程序. ```ts 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驱动程序. ```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 的示例 [这里](https://npmcn.com/docs/grafana/dashboard.json) 显示出口商提供的衡量标准. 这里有一个收集指标的例子: ![Grafana:Collection Metrics](https://npmcn.com/docs/images/grafana_mongodb_driver_collections_1.png "Grafana: Collection Metrics") 这里有一个命令度量标准的例子: ![Grafana:Commands Metrics](https://npmcn.com/docs/images/grafana_mongodb_driver_commands_1.png "Grafana: Command Metrics") # 更改日志 项目的更改可见于 [更改日志](https://npmcn.com/CHANGELOG.md)。 。 。 . # 兼容性 下表列出出口商版本与 MongoDB Driver 和 prom客户端版本的相容性. | 导出版本 | MongoDB 驱动程序版本 | 舞会客户端版本 | | --- | --- | --- | | ^ 1. 0 | ^ 5.8.0 (中文(简体) ) | ^14.2.0 (中文(简体) ) | | ^ 2. 0 | ^ 6. 0 | ^15.0 | # 捐款 发言是十分受欢迎的。 如欲为该项目捐款,请遵循本报告所述步骤 [捐款准则](https://npmcn.com/CONTRIBUTING.md)。 。 。 . # 使用导出者的项目 如果您想要支持此项目, 请在您使用此导出时在您的项目和/ 或公司中添加链接 . # 相关项目 如果你正在寻找一种方法 监视KafkaJS的节点 [https://github.com/christiangalster/kafkajs-prometheus-exporter (中文(简体) )](https://github.com/christiangalsterer/kafkajs-prometheus-exporter)。 。 。 . 如果你正在寻找一种方法 监视节点 -派克,你可能会看到 [https://github.com/christiangalster/node-postgres-prometheus-exporter 互联网档案馆的存檔,存档日期2013-12-21](https://github.com/christiangalsterer/node-postgres-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 和提交记录判断。