遥测（Telemetry）

在 Aptos 网络中运行节点时，节点会将遥测数据传输给 Aptos Labs。无论是验证节点、VFN（验证器全节点）或是 PFN（公共全节点），都会发送这类数据。即便是使用其他二进制程序，比如 Aptos CLI，也同样会发送遥测信息。如果您不想传输这些数据，可以按照以下步骤关闭遥测功能。

节点遥测

下面的列表显示了 Aptos 节点遥测收集的信息类别：

• 核心指标： 核心指标是由 aptos-node 二进制文件的核心组件发出的。这些包括状态同步、共识、内存池和存储。您可以查看完整的核心指标列表。

• 构建信息： 也会收集 Rust 构建信息，包括 Rust、cargo 的版本、目标架构和构建标签。您可以查看完整的构建信息列表。

• 系统信息： 节点遥测也会收集系统信息。这包括资源信息（例如，CPU、RAM、磁盘和网络规格）以及操作系统信息。您可以查看完整的系统信息列表。

• 网络指标： 节点遥测也会收集网络指标。这些包括网络信息，如连接的对等节点数量、进出消息的数量以及发送和接收的消息大小。您可以查看完整的网络指标列表。

• Prometheus 指标： 节点遥测也会收集 Prometheus 指标。这些包括 aptos-node 二进制文件所有组件的运行时指标。您可以通过使用节点检查服务访问节点上的指标端点来查看 Prometheus 指标的完整列表。

• 节点日志： 节点遥测也会收集警告级别及以上的日志。这些用于监控网络的健康状况。 您可以通过过滤aptos-node二进制文件的日志来识别这些日志。

CLI 遥测

Aptos CLI 工具也会收集遥测数据。下面的列表显示了 CLI 遥测收集的信息类别：

• 命令指标： 当执行命令时，CLI 会发出命令指标。这些包括命令本身、命令的延迟以及命令的成功或失败。 您可以查看完整的 CLI 指标列表。

• 构建信息： 对于 CLI，也会收集 Rust 构建信息，包括 Rust、cargo 的版本、目标架构和构建标签。 您可以查看完整的构建信息列表。

禁用遥测

在 macOS 和 Linux 上，您可以通过设置 APTOS_DISABLE_TELEMETRY 环境变量来禁用 Aptos 节点和 Aptos CLI 工具发送的指标。 要禁用所有遥测，请将 APTOS_DISABLE_TELEMETRY 环境变量设置为 true：

export APTOS_DISABLE_TELEMETRY=true

上述命令仅在当前终端的单个会话中禁用遥测。如果要永久禁用所有终端和 Aptos 二进制文件之间调用的遥测，请使用以下命令，以将禁用遥测功能包含在您的启动配置文件中。例如：

echo "export APTOS_DISABLE_TELEMETRY=true" >> ~/.profile
source ~/.profile

配置遥测

您还可以配置遥测以禁用特定的遥测指标和集合。下面的环境变量列表显示了您可以设置的变量，以配置 Aptos 节点和 CLI 的遥测：

• APTOS_DISABLE_TELEMETRY：这会禁用所有遥测发射，包括向 Google Analytics 服务（GA4）发送遥测。
• APTOS_FORCE_ENABLE_TELEMETRY：这会覆盖链 ID 检查，并强制 Aptos 节点发送遥测，无论远程服务是否接受。
• APTOS_DISABLE_TELEMETRY_PUSH_METRICS：这会禁用发送 Prometheus指标。
• APTOS_DISABLE_TELEMETRY_PUSH_LOGS：这会禁用发送日志。
• APTOS_DISABLE_TELEMETRY_PUSH_EVENTS：这会禁用发送自定义事件。
• APTOS_DISABLE_LOG_ENV_POLLING：这会禁用动态发送详细日志的能力。
• APTOS_DISABLE_PROMETHEUS_NODE_METRICS：这会禁用发送 Aptos 节点资源指标，如系统 CPU、内存等。