对于 AI 代理:可在 https://www.mongodb.com/zh-cn/docs/llms.txt 获取文档索引—通过在任何 URL 路径后添加 .md 可获取所有页面的 Markdown 版本。

将指标发送至 OpenTelemetry (OTel)

MongoDB Ops Manager 可以将 MongoDB Agent 收集的部署指标以 OpenTelemetry (OTel) 格式发送到第三方可观测性后端,同时 MongoDB Ops Manager 继续接收这些指标。此功能使您能够将 MongoDB 部署集成到现有的可观测性堆栈或任何其他接受 OpenTelemetry 协议 (OTLP) 的平台中。您不需要自定义管道、Sidecar 进程或额外的集合代理。

OTel 导出是可添加的,并且默认为禁用状态。指标交付到 Ops Manager 不会以任何方式更改:每个信号将继续通过现有的 Ops Manager 路径传输,保持不变。OTel 导出路径上的任何故障,例如无法访问的终结点等,都会被隔离,以便从不中断向 MongoDB Ops Manager 报告。

启用此功能后,MongoDB Agent 会以可配置的频率(默认为 30 秒)通过 OTLP/HTTP 将指标推送到您配置的终结点。每个周期会为每个监控的进程发送一个 OTLP 请求,外加一个用于代理自身健康状况的请求,因此您的后端在每个间隔内会收到多个小请求,而不是一个大批处理。您的终结点可以是以下之一:

  • 一个 OpenTelemetry Collector,它可以处理指标并将其路由到多个目的地。

  • 一个原生支持 OTLP 的可观测性平台(示例 DataDog、Grafana、Dynatrace)。

您可以通过 自动化配置 配置此功能。MongoDB Agent 在其现有的集合周期中收集导出的指标。因此,此功能不会对您监控的 MongoDB 进程产生额外的负载。

OTel 导出路径并非现有 Prometheus 集成的直接替代方案。Prometheus 集成是基于拉取的,MongoDB Agent 会公开一个 /metrics 终结点,供您的 Prometheus 服务器抓取。OTel 路径是基于推送的,MongoDB Agent 会定时将指标发送到您配置的 OTLP 终结点。

OTel 指标还使用遵循 MongoDB OpenTelemetry 语义约定的不同名称、类型和单位,因此您无法重复使用现有的 Prometheus 仪表盘。您必须在目标可观测性平台中针对导出的指标创建新的仪表盘、警报和查询。

在配置 OTel 导出之前,请确保满足以下要求:

  • 您必须为您的部署启用监控,然后才能配置 OTel 导出。OTel 导出重用 MongoDB Agent 已经收集用于监控的示例。要了解如何安装 MongoDB Agent 并启用监控,请参阅 安装 MongoDB Agent 以监控或备份部署。

  • 确保从运行 MongoDB Agent 的每台托管都可以访问您的 OTLP 终结点。MongoDB Agent 将指标直接推送到终结点。在启用此功能之前,请验证您的防火墙规则和出口策略。

  • 确认您具有 Project Automation Admin 访问权限,以通过 Ops Manager API 更新自动化配置。要进一步了解项目角色,请参阅 MongoDB Ops Manager 角色。要学习有关自动化配置 API 的知识,请参阅 自动化配置资源。

  • 确保您的 OTLP 终结点支持 OTLP/HTTP 作为接收器协议。要学习如何配置 OTLP/HTTP 接收器,请参阅 OpenTelemetry 协议规范。

您可以通过 自动化配置 来配置 OTel 导出。所有设置都存储在监控模块的 additionalParams 下的单个 otelConfig 密钥中。您可以通过 Ops Manager 界面中现有的自定义配置流程应用此配置,如 自定义设置 所述。您还可以通过公共自动化配置 API 应用此配置。

以下示例显示了启用 OTel 导出的 additionalParams 条目:

"additionalParams": { "otelConfig": "{\"enabled\":true,\"metricsExportIntervalSec\":30,\"backends\":[{\"endpoint\":\"https://collector.example.com:4318\",\"headers\":\"Authorization=Bearer <token>\",\"caCertPath\":\"/etc/ssl/ca.pem\"}]}"}

有关 otelConfig 字段的完整列表,请参阅 OpenTelemetry (OTel) 导出设置。

重要

配置错误的 otelConfig 会发出明显的失败信号,而不是被静默忽略。如果配置无效,MongoDB Agent 将阻止监控模块启动。MongoDB Agent 会每隔 30 秒重试一次配置,直到收到有效配置。因此,无效的 otelConfig 会影响整个监控,而不仅仅是 OTel 路径。代理会记录此故障,并带有 Otel: 前缀,并在代理向 MongoDB Ops Manager 的状态报告中显示该故障。

配置更改将在监控模块下次重启时生效。当您更改相关的自动化配置属性时,MongoDB Ops Manager 会自动触发此重启。

警告

如果您配置了 http:// 终结点,MongoDB Agent 将通过未加密的连接发送指标。MongoDB Ops Manager 无法检测终结点是否为生产目标,因此没有防护措施来防止生产环境中的不安全导出。对生产部署使用 https:// 终结点。

对于由 MongoDB Controllers for Kubernetes (MCK) 托管的部署,OTel 导出使用相同的自动化配置机制。操作符维护自动化配置。操作符通过自定义资源更新将您的 OTel 设置写入代理托管。您不需要任何单独的 Kubernetes 特定配置。

此功能通过 OTLP 导出下表中的指标组。指标名称、类型和单位遵循 MongoDB 的 OpenTelemetry 语义约定,使用一致的 mongodb.* 命名模式。

指标组
源
覆盖

Server status

serverStatus

操作计数器(包括复制)、操作延迟、连接、内存、网络、游标、插入、更新、删除和返回的文档、WiredTiger 缓存统计信息、工单和队列深度、锁获取、等待和死锁计数、活动读取和写入、断言、流控制、查询定位、生存时间 (TTL) 删除、页面错误、正常运行时间和运行状况。

数据库统计信息

dbStats

每个数据库的存储、数据大小、对象、索引和视图统计信息。

集合活动

top

按操作聚合的时间。

复制

replSetGetStatus 以及 oplog

oplog 大小和窗口、复制延迟以及节点健康状况。

分片

Config metadata

分片中的数据块计数和数据分布。

代理自我健康状况

代理运行时

MongoDB Agent 的正常运行时间、内存和 goroutine,发布在专用的 mongodb.mms.* 命名空间下。

此功能将计数器指标导出为累积值,其起始时间戳源自 mongod 的运行时间。mongod 重启将显示为标准计数器重置,因此速率计算在重启后仍然准确。

  • 当进程暂时无法访问时,MongoDB Agent 会原样重新导出计数器序列,因此集合间隙不会被误读为计数器重置。

  • MongoDB Agent 仅在时间序列(例如 mongodb.health)处于最新状态时才导出它们,因此无法访问的进程会保持静默,而不是保留陈旧的值。

  • 如果 20 分钟内没有新示例,MongoDB Agent 会删除一个序列,该序列将从您的后端消失。在基于缺失数据构建警报时,请考虑此行为。

您必须在目标可观测性平台中针对导出的指标创建新的仪表盘。MongoDB Ops Manager 不提供预构建的仪表盘,您也无法重复使用为 Prometheus 集成、MongoDB Ops Manager 界面或其他第三方 MongoDB 集成创建的现有仪表盘。

在设置仪表盘时,请考虑以下指导:

  • 创建新的仪表盘,而不是移植现有的仪表盘。通过 OTLP 发出的指标名称遵循 mongodb.* 命名约定,该约定与 Prometheus 导出器的名称以及 MongoDB Ops Manager 内部指标标识符不同。

  • 使用资源属性进行过滤器和分组。每个指标都带有标识监控进程和项目的资源属性。将这些属性用作仪表盘面板、警报和分组的主要维度。

  • 将速率函数应用于计数器指标。计数器是累积的。将 rate() 或 increase() 等函数或您平台中的等效函数应用于计数器类型指标。

  • 重新创建您的警报。OTel 导出不会迁移 Prometheus、MongoDB Ops Manager 或其他第三方集成中定义的现有警报规则。在目标平台中针对 OTel 指标名称和资源属性定义新的警报规则。

  • 每个部署一个后端。此功能仅支持一个 OTLP 后端。配置多个后端会导致硬错误。要将指标分发到多个目的地,请配置一个 OpenTelemetry Collector 作为导出目标,并通过其管道配置路由到更多后端。

  • 仅限指标。此功能仅通过 OTLP 导出指标。OTel 导出路径不包含以下信号,这些信号将继续保持不变地流向 MongoDB Ops Manager:

    • 日志(分析器条目、托管日志和代理日志)和跟踪

    • MongoDB Search 进程指标

    • 托管级系统指标(CPU、内存、磁盘和网络)

    • 每个集合的延迟直方图

  • 对于无法访问的目标,不进行缓冲。MongoDB Agent 会根据导出程序的策略重试或删除失败的导出。此功能不提供存储转发队列。在所有情况下,发送到 MongoDB Ops Manager 的操作均不受影响。