kubernetes_workload_observed事件模式

合約證據路徑

kubernetes_workload_observed：從擁有邊界到可信查詢

將 kubernetes_workload_observed 視為持久的分析合約：所有者發出一個記錄的穀物，一個固定裝置證明欄位，並且經過審查的查詢回答所述問題。

1
結果成為最終結果
Cluster collector or deployment health controller emits only on a documented interval and immediately after a reviewed workload-state transition.
2
選擇欄位
8 required fields preserve the declared grain: One workload snapshot per cluster, namespace, and interval.
3
夾具已驗證
檢查型別、UTC 時間、替代結果、冪等性以及每個假名或評論分類欄位。
4
問題得到解答
哪些工作負載、叢集和版本正在重新啟動、不可用或資源受限？

穀物

每個叢集、名稱空間和時間間隔一個工作負載快照。

業主

叢集收集器或部署健康控制器

何時發出

在記錄的時間間隔內以及在審查的工作負載狀態轉換之後立即進行。

現場合約

欄位型別與應排除的資料

在生產查詢依賴現有欄位名稱和型別後，保持現有欄位名稱和型別穩定。可選上下文應受到特定決策的限制、記錄和證明。

欄位	型別	必填	隱私	含義
timestamp_utc	timestamp	yes	non-sensitive	結果邊界處的 UTC 時間。
event_id	string	yes	non-sensitive	用於重複資料刪除的穩定唯一識別符號。
release	string	yes	non-sensitive	發出事件的應用程式或服務版本。
cluster	string	yes	review	批准的穩定叢集識別符號。
namespace	string	yes	review	已批准的名稱空間標籤，不含租戶派生值。
workload	string	yes	non-sensitive	Stable Deployment、StatefulSet 或 DaemonSet 名稱。
ready_replicas	number	yes	non-sensitive	觀察時的就緒副本計數。
restart_count	number	yes	non-sensitive	測量的工作負載範圍內的累積重新啟動次數。

合成 JSON 事件

{
  "timestamp_utc": "2026-07-29T09:25:00Z",
  "event_id": "evt_k8s_01",
  "release": "collector-2026.07.3",
  "cluster": "production-us-west",
  "namespace": "telemetry",
  "workload": "query-api",
  "ready_replicas": 4,
  "restart_count": 1
}

隱私審查

攝取前檢查識別符號

此範例使用合成識別符號。假名值仍然可以是個人資料，並且審查欄位可以公開業務或提供商上下文。應用您自己的同意、保留、存取、居住和刪除要求。

cluster: review
namespace: review

驗證清單

在建置儀表板之前證明合約

Send one known kubernetes_workload_observed fixture after the documented outcome boundary.
Verify all 8 required fields arrive with the documented types.
重試相同的事件識別符號並確認所選的重複資料刪除行為。
當工作流程支援時，傳送受控失敗或替代結果。
在固定視窗上執行相關 SQL 並將結果與固定裝置進行協調。

常見錯誤

保持一行等於一個持久結果

Emitting kubernetes_workload_observed before cluster collector or deployment health controller knows the final outcome.
在一張資料表中混合多種穀物，這使得計數和比率不明確。
用原始 URL、有效負載、提示或錯誤文字替換受控類別。
儲存查詢和儀表板依賴於它後就地更改欄位型別。
新增識別符號，無需記錄調查、存取和保留需求。

使用合約