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 - 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_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

時間戳記 (以奈秒為單位)，表示喚醒租約何時滿足電源中介服務。