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

排查产品使用遥测故障

This page describes how to resolve issues with product usage telemetry in Ops Manager 9.0.2, 8.0.28, and later. To learn how product usage telemetry works, see Product Usage Telemetry.

If the Product Telemetry Collection toggle is locked on, the installed license key doesn't include an active telemetry exemption. Without an exemption, product usage telemetry is mandatory.

要关闭产品使用情况遥测功能,您需要在已安装的许可证密钥上启用遥测豁免。要了解豁免的工作原理,请参阅“遥测豁免” 。然后按照以下步骤操作。

1

单击 Admin,License Keys。

2

Check whether the active key lists the Telemetry Exemption entitlement.

3

如果密钥中未列出豁免信息,请联系您的 MongoDB 客户团队。如果您在生成密钥后获得了豁免批准,请生成包含该豁免信息的新密钥并安装。有关说明,请参阅Ops Manager 中的“管理许可证密钥”。

4

Reload the Telemetry tab and turn off the Product Telemetry Collection toggle.

您还可以使用管理 API 生成并安装许可证密钥。有关说明,请参阅“使用 API 管理许可证密钥”。

If a banner appears on the Deployment pages, Ops Manager hasn't sent product usage telemetry to MongoDB for 8 or more days. To resolve the banner, work through the following steps.

1

Click Admin, General, Ops Manager Config, Telemetry. Check Last Successful Upload and Next Scheduled Upload. If Ops Manager was installed or upgraded less than seven days ago, the first send may not be due yet.

2

From each Ops Manager host, check that the host can open an HTTPS connection to cloud.mongodb.com on port 443.

3

Check /opt/mongodb/mms/logs/mms0.log for these messages:

Log message
说明
解决方案

Unable to send the product-usage-metrics payload.

发送到 MongoDB 失败。该条目包含底层错误信息。Ops Manager 会保留未发送的快照并自动重试。

请继续执行下一步以修复连接问题。

Unable to collect the product-usage-metrics payload.

Ops Manager 无法构建快照。该条目包含根本错误信息。未创建快照;Ops Manager 将在下次计划运行时重试收集。

检查同一条日志条目,找出根本错误。

Unable to read the license exemptions; treating usage telemetry as mandatory.

Ops Manager 无法读取许可证密钥状态,因此将产品使用情况遥测视为强制性要求。

请确认许可证密钥已安装。如果问题仍然存在,请联系您的 MongoDB 客户团队。

Product-usage snapshot <id> delivered.

发送成功。

无需任何操作。发送成功后,横幅将自动消失。

The mms0.log file rolls over daily. The logs are compressed and kept for 30 days.

4

修复任何阻止连接的防火墙、TLS 检测或代理规则。

5

请等待下一次作业运行,大约六小时内。运维管理器会自动重试未发送的快照,发送成功后横幅将消失。

6

如果您的环境无法将数据发送到网络外部,请联系您的客户团队申请遥测豁免。