MongoDB 数据库监控接入

支持的中间件条件

接入前请确认目标实例满足以下条件，否则可能出现采集不到数据或指标缺失。

前提条件

• 已开通可观测监控Prometheus版。

• 接入 CS 环境：目标 ACK 集群已接入云监控 2.0，且集群状态为运行中；目标 MongoDB 服务可在该集群网络内连通。

• 接入 ECS(VPC) 环境：已选定目标 MongoDB 所在 ECS，并确保托管探针交换机网段可访问该 ECS。

费用说明

• 根据产生的指标数据量，在 Prometheus 产品中计费。无其他费用。

接入方法

步骤一：创建监控账号（如需）

若实例开启了访问认证（auth），请创建具备 clusterMonitor 角色的监控账号；未开启认证时可跳过本步骤。

use admin
db.createUser({
  user: "exporter",
  pwd: "<password>",
  roles: [ { role: "clusterMonitor", db: "admin" } ]
})

步骤二：选择接入环境

本插件支持 CS 与 ECS(VPC) 两种接入环境，工作原理不同，请按 MongoDB 实际部署位置选择：

CS（容器服务）

• 将 Exporter 安装到用户指定的目标 ACK 集群，并复用该集群已有的采集器进行指标采集。

• 观测对象为 ACK 集群。

• 网络要求：目标 MongoDB 服务可在该集群网络内连通即可（例如集群内 Service，或集群能访问到的 VPC 内网地址）。

ECS(VPC)

• 选择目标 MongoDB 服务部署的 ECS 机器，系统根据该 ECS 的 VPC 信息部署全托管采集器。

• 不会在 ECS 上安装任何进程。

• 观测对象为 ECS 实例。

• 网络要求：托管探针所在交换机网段需允许访问目标 ECS（安全组、ACL 等需放行）。

步骤三：接入配置

1. 登录云监控2.0控制台，选择目标工作空间后，在左侧导航栏单击 接入中心 ，单击 MongoDB 开始接入。

2. 选择接入环境（CS 或 ECS(VPC)），并在下拉列表中选择 观测对象 。

3. 接入配置，配置完成后单击 确定 ：

   配置项	是否必填	说明
   MongoDB 服务地址	是	主连接地址；副本集场景下作为第一个 seed
   MongoDB 服务端口	是	默认 27017；额外种子未写端口时复用此值
   额外种子节点（副本集）	否	其余成员，逗号分隔，host 或 host:port
   副本集名称	否	填写后 URI 带 replicaSet=，并强制关闭直连
   认证库	否	默认 admin
   直连模式	否	单节点建议开启；配置了副本集名或额外种子时被忽略并强制关闭
   云厂商 / 部署来源	否	写入 provider 标签，自建为 self-hosted/mongodb
   MongoDB 账号 / 密码	否	开启 auth 时填写；需 clusterMonitor
   Metric 采集间隔（秒）	是	默认 15
   自定义标签	否	注入到指标上的额外标签
   使用公网镜像地址	否	默认关闭；无法访问内网镜像仓库时开启

4. 接入成功后，可在 实体探索 查看接入的实体及相关可观测数据。

数据使用说明

实体说明

接入后，云监控定期从 mongodb_up 等指标的标签中发现 MongoDB 实例，并生成中间件实体：

实体字段来自采集标签，与安装次数无关：

可在 实体探索 或 中间件洞察 应用中按上述字段检索实例。

内置大盘

核心指标

以下为实体数据集 middleware.metric.mongodb 的完整指标清单（共 30 个），可在实体详情、大盘与告警中直接使用：

常用查询示例

# 存活
mongodb_up

# 当前连接数
mongodb_connections{state="current"}

# 操作速率（按类型）
rate(mongodb_op_counters_total[5m])

告警模板

本接入组件暂未内置告警规则。可在 告警中心 基于上述指标自行配置，例如对 mongodb_up 存活指标不等于 1、连接数 / 堆积量超阈值等场景设置告警。

存储策略说明

接入 MongoDB 后，云监控会创建对应的存储实例用于存储可观测数据。

卸载或修改接入策略

如果期望取消或修改 MongoDB 的接入，可以在 接入中心 的 接入管理 页，找到对应的接入策略，进行 编辑 或 删除 。删除接入策略后，Exporter 与采集配置一并移除，已写入的历史指标按存储的生命周期策略保留。