fuchsia.power.observability

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

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

统一报告中使用的一些惯例：

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

常量

名称值类型说明
BOOT_MONO_DIFF boot_monotonic_difference_ns String

从挂起状态恢复后，启动时钟和单调时钟之间的差值（以纳秒为单位）。 公式：mono_time_ns = boot_time_ns - boot_monotonic_difference_ns
BOOT_TIME boot_time_ns String

从暂停状态恢复后捕获的启动时间（以纳秒为单位）。
BOOT_TO_MONO_NODE boot_to_monotonic_timeline 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_CUMULATIVE_DURATION total_time_in_suspend_ns String

自启动以来处于暂停状态的累计总时长。
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 - make this string also end with _ns to be consistent with the conventions above.
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_RESUME_REASON resume_reason String

成功暂停后的恢复原因。
SUSPEND_STATS_NODE suspend_stats String

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

成功暂停的次数。
WAKEUP_SOURCES_NAME wakeup_sources 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_ID wake_lease_id String

SAG 跟踪的唤醒租约的 ID。
WAKE_LEASE_ITEM_NAME wake_lease_name String

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

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

此唤醒租约所交换的前置唤醒租约的 ID（如果通过 AcquireWakeLease2 提供）。
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_SAMPLE_ACTIVE_FRACTION active_fraction String

唤醒租用处于活跃状态的时间占唤醒租用采样间隔时间的比例。
WAKE_LEASE_SAMPLE_DURATION sample_duration_ns String

唤醒租约采样间隔的时长（以纳秒为单位）。
WAKE_LEASE_SAMPLE_END sample_end_ns String

唤醒租约采样间隔结束时的时间戳（以纳秒为单位）。
WAKE_LEASE_SATISFACTION_FAILED_AT wake_lease_satisfaction_failed_at_ns String

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

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

报告唤醒原因时的时间戳的键。
WAKE_REASONS_WAKE_VECTOR_PREFIX wake_reason String

唤醒原因的键前缀。
WAKE_REASON_REPORT_TIME wake_reason_last_report_time_ns String

生成唤醒原因报告时的启动时间戳（以纳秒为单位）。
WAKE_REASON_WAKE_SOURCES_COUNT wake_reason_last_wake_sources_count String

上次成功唤醒时，最后一次报告的潜在唤醒源数量。
WAKE_REASON_WAKE_SOURCES_UNREPORTED_COUNT wake_reason_last_wake_sources_unreported_count String

上次成功唤醒时未报告的潜在唤醒源的最后数量。