fuchsia.power.observability

跨語言共用常數，用於追蹤檢查中的觀測能力。

下列常數是檢查鍵。我們為這些變數命名，以便在檢查輸出內容時，能清楚瞭解其意義。

統一報表格式的慣例：

  • 所有時間戳記都以奈秒表示，並加上「_ns」後置字串。
  • 所有時間長度都以奈秒表示，並加上「_ns」後置字串。
  • 所有一般計數器都會加上 _count 後置字串。
  • 所有節點常數名稱都加上 _NODE 後置字串。
新增：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

錯誤訊息。例如，如果基礎 Power Broker 租約無法滿足。
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

如果透過 AcquireWakeLease2 提供，則為此喚醒租約交換的前置喚醒租約 ID。
WAKE_LEASE_ITEM_STATUS wake_lease_status String

喚醒租約的狀態。
WAKE_LEASE_ITEM_STATUS_AWAITING_SATISFACTION pending String

在電源拓撲中，電源代理程式要求的租約尚待滿足。
WAKE_LEASE_ITEM_STATUS_FAILED_SATISFACTION failed String

無法滿足 Power Broker 中要求的租約。
WAKE_LEASE_ITEM_STATUS_SATISFIED satisfied String

電源拓撲的目前狀態滿足了電源代理程式要求的租約。
WAKE_LEASE_ITEM_TYPE wake_lease_type String

喚醒租約類型。
WAKE_LEASE_ITEM_TYPE_APPLICATION_ACTIVITY application_activity String

防止系統低於應用程式活動「Active」狀態的租約。
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

Power Broker 無法滿足喚醒租約的時間戳記 (以奈秒為單位)。
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

上次成功喚醒時，未回報的潛在喚醒來源數量。