5.7. Telemetry 模块
遥测模块发送有关存储集群的数据，以帮助了解 Ceph 的使用方式以及操作过程中遇到的问题。在公共仪表板上视觉化数据，以查看报告集群数量、其总容量和 OSD 数量以及版本分布趋势的摘要统计。
Channels
遥测报告分为不同的频道，每种频道都有不同类型的信息。启用遥测后，您可以打开或关闭单个频道。
以下是四个不同的频道：
Basic- 默认为on。此频道提供有关集群的基本信息，其中包括以下信息：- 集群的容量。
- 监视器、管理器、OSD、MDS、对象网关或其他守护进程的数量。
- 当前正在使用的软件版本。
- RADOS 池和 Ceph 文件系统的数量和类型。
- 从默认值（而不是其值）更改的配置选项的名称。
crash- 默认为on。这个频道提供有关守护进程崩溃的信息，其中包括以下信息：- 守护进程的类型。
- 守护进程的版本。
- 操作系统、操作系统分发和内核版本。
- 标识崩溃的 Ceph 代码中的位置的堆栈追踪。
-
设备- 默认位于。此频道提供有关设备指标的信息，其中包括匿名 SMART 指标。 -
Ident- 默认为off。此频道为用户提供了集群相关的标识信息，如集群描述和联系电子邮件地址。 perf- 默认为off。此频道提供集群的各种性能指标，可用于以下内容：- 显示集群整体健康状况。
- 识别工作负载模式。
- 对延迟、节流、内存管理和其他类似问题进行故障排除。
- 通过守护进程监控集群性能。
报告的数据不包含任何敏感数据，如池名称、对象名称、对象内容、主机名或设备序列号。
它包含集群如何部署、Ceph 版本、主机分发和其他参数的计数器和统计信息，可帮助项目更好地了解 Ceph 的使用方式。
数据安全，并发送到 https://telemetry.ceph.com。
启用遥测
在启用频道前，请确保遥测在 上。
启用遥测：
ceph telemetry on
启用和禁用频道
启用或禁用单个频道：
ceph telemetry enable channel basic ceph telemetry enable channel crash ceph telemetry enable channel device ceph telemetry enable channel ident ceph telemetry enable channel perf ceph telemetry disable channel basic ceph telemetry disable channel crash ceph telemetry disable channel device ceph telemetry disable channel ident ceph telemetry disable channel perf
启用或禁用多个频道：
ceph telemetry enable channel basic crash device ident perf ceph telemetry disable channel basic crash device ident perf
启用或禁用所有频道：
ceph telemetry enable channel all ceph telemetry disable channel all
报告示例
要随时查看报告的数据，请生成示例报告：
ceph telemetry show
如果 Telemetry
已关闭，请预览示例报告：ceph telemetry preview
为具有数百个 OSD 或更多 OSD 的存储集群生成示例报告需要更长的时间。
为了保护您的隐私，设备报告是单独生成的，主机名和设备序列号等数据被匿名化。设备遥测发送到不同的端点，且不会将设备数据与特定集群相关联。要查看设备报告，请运行以下命令：
ceph telemetry show-device
如果 Telemetry
已关闭，请预览示例设备报告：ceph telemetry preview-device
获取
上带有telemetry 的两个报告的单一输出：ceph telemetry show-all
通过遥测(
off)获取两个报告的一个输出：ceph telemetry preview-all
根据频道生成示例报告：
语法
ceph telemetry show CHANNEL_NAME根据频道生成示例报告的预览：
语法
ceph telemetry preview CHANNEL_NAME
集合
集合是频道中收集的数据的不同方面。
列出集合：
ceph telemetry collection ls
查看您注册的集合与新的可用集合之间的区别：
ceph telemetry diff
注册最新的集合：
语法
ceph telemetry on ceph telemetry enable channel CHANNEL_NAME
Interval（间隔）
默认情况下，模块编译并每 24 小时发送一次新的报告。
调整间隔：
语法
ceph config set mgr mgr/telemetry/interval INTERVAL示例
[ceph: root@host01 /]# ceph config set mgr mgr/telemetry/interval 72
在示例中，报告每三天生成一次(72 小时)。
Status
查看当前配置：
ceph telemetry status
手动发送遥测
根据临时发送遥测数据：
ceph telemetry send
如果遥测被禁用，请将
--license shared-1-0添加到ceph telemetry send命令。
通过代理发送遥测
如果集群无法直接连接到配置的遥测端点，您可以配置 HTTP/HTTPs 代理服务器：
语法
ceph config set mgr mgr/telemetry/proxy PROXY_URL示例
[ceph: root@host01 /]# ceph config set mgr mgr/telemetry/proxy https://10.0.0.1:8080
您可以在命令中包含用户传递：
示例
[ceph: root@host01 /]# ceph config set mgr mgr/telemetry/proxy https://10.0.0.1:8080
联系和描述
可选：在报告中添加联系人和描述：
语法
ceph config set mgr mgr/telemetry/contact '_CONTACT_NAME_' ceph config set mgr mgr/telemetry/description '_DESCRIPTION_' ceph config set mgr mgr/telemetry/channel_ident true
示例
[ceph: root@host01 /]# ceph config set mgr mgr/telemetry/contact 'John Doe <john.doe@example.com>' [ceph: root@host01 /]# ceph config set mgr mgr/telemetry/description 'My first Ceph cluster' [ceph: root@host01 /]# ceph config set mgr mgr/telemetry/channel_ident true
如果启用了
ident标志，其详情不会在领导板中显示。
Leaderboard
在公共仪表板上参与领导板：
示例
[ceph: root@host01 /]# ceph config set mgr mgr/telemetry/leaderboard true
领导板显示有关存储集群的基本信息。此板包括存储容量和 OSD 数量。
禁用遥测
随时禁用遥测：
示例
ceph telemetry off
