fuchsia.power.observability

用於追蹤檢查功能可觀測性的跨語言共用常數。

下列常數是檢查鍵。我們為這些名稱命名，以便在檢查輸出中顯示的名稱與其意義建立良好關聯。

以下是統一報表所用的部分慣例：

  • 所有時間戳記都以奈秒為單位，並加上「_ns」後置字元。
  • 所有時間長度都以奈秒表示，並加上「_ns」後置字元。
  • 所有純計數器都會加上 _count 後置字元。
  • 所有節點常數名稱都會加上 _NODE 後置字元。
新增：HEAD

常數

名稱值類型說明
ACTIVE_EPOLLS active_epolls String

目前有效 epoll 的名稱，會在 epoll 啟用時記錄，以及我們嘗試暫停但失敗時記錄 (因為有有效 epoll)。
ACTIVE_WAKE_LOCK_NAMES active_wake_lock_names String

目前有效喚醒鎖定的名稱，會在喚醒鎖定啟用時記錄，以及我們嘗試暫停但因有有效喚醒鎖定而失敗時記錄。
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

檢查節點的標籤，追蹤啟動時間戳記與單調時間戳記。
INACTIVE_EPOLLS inactive_epolls String

目前處於非使用中狀態的 epoll 名稱，記錄於 epoll 進入非使用中狀態時，以及我們嘗試暫停但因有使用中 epoll 而失敗時。
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_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

捨棄暫停鎖定時的時間戳記 (以奈秒為單位)。收到暫停 HAL 的回應並由 SAG 處理後，就會發生這個事件。
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

成功暫停的次數。
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

租用項目，可防止系統降至「Active」狀態以下的應用程式活動。
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

時間戳記 (奈秒)，表示喚醒租約已滿足電源中介服務。
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

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