跳转到内容

遥测(Telemetry)

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

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

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

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

  • 系统信息: 节点遥测也会收集系统信息.这包括资源信息(例如,CPU,RAM,磁盘和网络规格)以及操作系统信息.您可以查看完整的系统信息列表.

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

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

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

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

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

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

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

Terminal window
export APTOS_DISABLE_TELEMETRY=true

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

Terminal window
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,内存等.