fedora-coreos-pinger

Fedora CoreOS中的遥测服务。

该项目的目标是通过对运行版本和所使用的平台等信息进行收集，为Fedora CoreOS开发者提供更好的洞察，了解该发行版的用法。拥有这些信息（以汇总形式）有助于更清晰地了解用户基础，并了解哪些平台、用例、架构等应优先考虑开发和支持。有关更多背景信息，请参阅上述链接的跟踪票据fedora-coreos-tracker票据。

目前，fedora-coreos-pinger的二进制文件是一个存根，它只解析配置片段以检查配置是否正确。首先提供存根的原因是允许用户在Fedora CoreOS预览期间提供具有所需设置的（包括禁用信息报告）有效配置。然后，一旦添加了收集数据的传输功能，用户指定的配置将保持不变。

默认情况下，报告已启用，并且以最小级别收集信息。由于该服务只是一个没有实现报告的存根，所以关于最小级别的详细内容仍在上述链接的跟踪票据中进行讨论。在实施之前可以完全禁用报告，请参阅禁用报告。

配置

ping器服务通过在以下目录中放置TOML格式的配置片段（文件）进行配置

/etc/fedora-coreos-pinger/config.d/
/run/fedora-coreos-pinger/config.d/
/usr/lib/fedora-coreos-pinger/config.d/

/etc/fedora-coreos-pinger/config.d/中的文件会覆盖同名的/run/fedora-coreos-pinger/config.d/中的文件，而后者会覆盖同名的/usr/lib/fedora-coreos-pinger/config.d/中的文件。配置文件按字母数字顺序读取；后序配置文件覆盖先序配置文件。

必须由配置文件显式设置报告的enabled标志。如果没有指定，则服务将以错误退出。如果启用报告，则默认收集信息级别设置为"minimal"。以下是一个配置示例

# /usr/lib/fedora-coreos-pinger/config.d/10-default-enable.toml
# fedora-coreos-pinger configuration

[collecting]
# Default collecting.level is `minimal`. May be set to `"minimal"` or `"full"`.
level = "minimal"

[reporting]
# Required. May be set to `true` or `false`.
enabled = true

禁用报告

要禁用信息报告，可以将以下配置片段添加到例如 /etc/fedora-coreos-pinger/config.d/99-disable-reporting.toml 中。

[reporting]
enabled = false

禁用报告后，ping器不会收集或传输任何信息。

安装后，通过启用 fedora-coreos-pinger.service 单元自动运行 fedora-coreos-pinger。

请注意，在Fedora CoreOS发布稳定版本之前，上述配置格式可能在开发过程中自由更改。如果格式更改，如果给出错误的配置格式，ping器服务将失败。

开发

有关构建和运行的信息，请参阅 Cargo命令参考。

在测试 fedora-coreos-pinger.service 单元时，应安装 dist 目录中的文件。