fuchsia.power.observability

用于在检查中跟踪可观测性的跨语言共享常量。

以下常量是检查键。我们为它们命名，以便在检查输出中显示的名称能很好地与其含义相关联。

用于统一报告的一些惯例：

  • 所有时间戳均以纳秒表示，并以“_ns”为后缀。
  • 所有时长均以纳秒表示，并以“_ns”为后缀。
  • 所有普通计数器都以 _count 为后缀。
  • 所有节点常量名称都以 _NODE 为后缀。
添加了：HEAD

常量

名称值类型说明
ACTIVE_EPOLLS_COUNT active_epolls_count String

当前活跃 epoll 的数量，在 epoll 变为活跃 / 非活跃时记录，以及在我们尝试暂停但因存在活跃 epoll 而失败时记录。
ACTIVE_WAKE_LOCK_NAMES active_wake_lock_names String

当前活跃唤醒锁的名称，在唤醒锁变为活跃时记录，以及在我们尝试挂起但因存在活跃唤醒锁而失败时记录。
INACTIVE_WAKE_LOCK_NAMES inactive_wake_lock_names String

当前非有效唤醒锁定的名称，在唤醒锁定变为非有效时记录，以及在我们尝试挂起但因存在有效唤醒锁定而失败时记录。
RESUME_CALLBACK_PHASE_END_AT resume_callbacks_ended_at_ns String

以纳秒为单位的时间戳，用于表示恢复回调处理的结束时间。 恢复操作不受阶段完成情况的限制。 事件记录在 SUSPEND_EVENTS_NODE 中。
RESUME_CALLBACK_PHASE_START_AT resume_callbacks_started_at_ns String

以纳秒为单位的时间戳，表示恢复回调处理的开始时间。 恢复操作不受阶段完成情况的限制。 事件记录在 SUSPEND_EVENTS_NODE 中。
SUSPEND_ATTEMPTED_AT attempted_at_ns String

尝试暂停时的时间戳（以纳秒为单位）。
SUSPEND_ATTEMPT_BLOCKED_AT attempt_blocked_at_ns String

内部阻止挂起尝试时的时间戳（以纳秒为单位）。 在所有挂起锁定和挂起阻止程序都被舍弃之前，挂起可能会被反复阻止。
SUSPEND_BLOCKER_ACQUIRED_AT suspend_blocker_acquired_at_ns String

获取至少一个挂起阻止程序的时间戳（以纳秒为单位）。 当内部程序需要防止暂停时，会发生这种情况。 例如，在处理唤醒租约请求时，system-activity-governor 会在唤醒租约令牌的整个生命周期内获取挂起阻止器。这样可以防止即使在底层电源代理租约处于待处理状态时也发生暂停。
SUSPEND_BLOCKER_DROPPED_AT suspend_blocker_dropped_at_ns String

上次丢弃挂起阻塞器时的时间戳（以纳秒为单位）。
SUSPEND_CALLBACK_PHASE_END_AT suspend_callbacks_ended_at_ns String

以纳秒为单位的时间戳，表示暂停回调处理的结束时间。 暂停操作受阶段完成情况限制。 事件记录在 SUSPEND_EVENTS_NODE 中。
SUSPEND_CALLBACK_PHASE_START_AT suspend_callbacks_started_at_ns String

以纳秒为单位的时间戳，表示暂停回调处理的开始时间。 暂停操作受阶段完成情况限制。 事件记录在 SUSPEND_EVENTS_NODE 中。
SUSPEND_EVENTS_NODE suspend_events String

用于统计暂停事件的检查节点标签。
SUSPEND_FAILED_AT failed_at_ns String

在暂停失败后恢复的纳秒级时间戳。
SUSPEND_FAIL_COUNT fail_count String

暂停失败的次数。
SUSPEND_LAST_DURATION last_time_in_suspend_operations String

导致暂停的操作上次所用的时间，不包括实际暂停的时间。

TODO：b/354239403 - 使此字符串也以 _ns 结尾，以便与上述惯例保持一致。
SUSPEND_LAST_FAILED_ERROR last_failed_error String

与上次暂停操作相关的错误代码。
SUSPEND_LAST_TIMESTAMP last_time_in_suspend_ns String

上次进入挂起状态的时长。
SUSPEND_LOCK_ACQUIRED_AT suspend_lock_acquired_at_ns String

由于获取了挂起锁，挂起请求将被阻塞的时间戳（以纳秒为单位）。此事件发生在即将向挂起 HAL 发出请求之前。
SUSPEND_LOCK_DROPPED_AT suspend_lock_dropped_at_ns String

挂起锁被舍弃时的时间戳（以纳秒为单位）。当 SAG 收到并处理来自挂起 HAL 的响应后，会发生此事件。
SUSPEND_REQUESTED_STATE requested_power_state String

请求的未来系统状态。
SUSPEND_RESUMED_AT resumed_at_ns String

成功挂起后恢复时的纳秒级时间戳。
SUSPEND_STATS_NODE suspend_stats String

用于保留挂起统计信息的检查节点的标签。
SUSPEND_SUCCESS_COUNT success_count String

成功暂停的次数。
WAKE_LEASES_NODE wake_leases String

由 SAG 跟踪的唤醒租约的当前状态。 唤醒租约事件历史记录在 SUSPEND_EVENTS_NODE 中单独跟踪。
WAKE_LEASE_CREATED_AT wake_lease_created_at_ns String

唤醒租约的创建时间（以纳秒为单位）。
WAKE_LEASE_DROPPED_AT wake_lease_dropped_at_ns String

放弃了唤醒租约的时间戳（以纳秒为单位）。
WAKE_LEASE_ITEM_CLIENT_TOKEN_KOID wake_lease_client_token_koid String

向客户端出售的令牌的内核对象 ID。
WAKE_LEASE_ITEM_ERROR error String

错误消息。例如，如果未能满足底层电源代理租约。
WAKE_LEASE_ITEM_NAME wake_lease_name String

客户端请求的唤醒租约的名称。
WAKE_LEASE_ITEM_NODE_CREATED_AT wake_lease_created_at String

自启动以来唤醒租约创建的时间（以纳秒为单位）。
WAKE_LEASE_ITEM_STATUS wake_lease_status String

唤醒租约的状态。
WAKE_LEASE_ITEM_STATUS_AWAITING_SATISFACTION pending String

电源代理中请求的租约正在等待电源拓扑中的满足。
WAKE_LEASE_ITEM_STATUS_FAILED_SATISFACTION failed String

在电源代理中请求的租约未能得到满足。
WAKE_LEASE_ITEM_STATUS_SATISFIED satisfied String

电源代理中请求的租借已通过电源拓扑的当前状态得到满足。
WAKE_LEASE_ITEM_TYPE wake_lease_type String

唤醒租约的类型。
WAKE_LEASE_ITEM_TYPE_APPLICATION_ACTIVITY application_activity String

阻止系统降至应用 activity“活跃”状态以下的租约。
WAKE_LEASE_ITEM_TYPE_WAKE wake String

阻止硬件平台暂停的租约。
WAKE_LEASE_SATISFACTION_FAILED_AT wake_lease_satisfaction_failed_at_ns String

电源代理未能满足唤醒租约的时间戳（以纳秒为单位）。
WAKE_LEASE_SATISFIED_AT wake_lease_satisfied_at_ns String

电源代理满足唤醒租约的时间（以纳秒为单位）。