Cloud Monitor：實體產生與寫入

系統欄位

欄位說明

自訂欄位

除系統欄位外，可以添加 EntitySet 中定義的各類 Field 欄位：

{
  "__domain__": "apm",
  "__entity_type__": "apm.service",
  "__entity_id__": "391274C9A1D369FB5222E273D02B81B8",
  "__method__": "Update",
  "__last_observed_time__": 1700000001,
  "__keep_alive_seconds__": 3600,
  "service_name": "user-service",
  "version": "v1.2.3",
  "cluster": "production",
  "labels": {
    "env": "prod",
    "team": "backend"
  }
}

時間區間基礎概念

實體在 EntityStore 中具有明確的時間可見範圍，查詢引擎只有在查詢時間視窗與實體可見時間產生交集時，才會返回該實體。

時間交集判斷規則

查詢引擎使用以下規則判斷實體是否應該被返回：

查詢返回實體 = 查詢時間視窗 ∩ 實體可見時間

具體判斷邏輯：

if (QueryEndTime >= EntityFirstObservedTime && 
    QueryStartTime <= EntityVisibleEndTime) {
    返回實體
} else {
    不返回實體
}

Create - 建立實體

使用情境：明確建立新實體時使用，如監聽到Pod建立事件。

行為邏輯：

• 若實體已存在：不做任何操作。

• 若實體不存在：建立新實體，覆蓋所有欄位。

樣本：

{
  "__domain__": "k8s",
  "__entity_type__": "k8s.pod",
  "__entity_id__": "abc123...",
  "__method__": "Create",
  "__first_observed_time__": 1700000000,
  "__last_observed_time__": 1700000000,
  "pod_name": "web-app-123",
  "namespace": "default"
}

Update - 更新實體

使用情境：大部分情境使用，包括定期全量更新、累加式更新等。

行為邏輯：

• 覆蓋除__first_observed_time__外的所有欄位。

• 對於__first_observed_time__：

  • 若實體已存在：不修改原值。

  • 若實體不存在且事件包含該欄位：使用事件中的值。

  • 若實體不存在且事件不包含該欄位：使用__last_observed_time__的值。

樣本：

{
  "__domain__": "apm",
  "__entity_type__": "apm.service",
  "__entity_id__": "def456...",
  "__method__": "Update",
  "__last_observed_time__": 1700000100,
  "service_name": "payment-service",
  "status": "running",
  "instance_count": 3
}

Expire - 實體到期

使用情境：實體明確被刪除時使用，如監聽到Pod刪除事件。

行為邏輯：

• 標記實體的__deleted__為true。

• 更新__last_observed_time__。

• 查詢時不再附加計算KeepAlive時間。

時間範圍變化：

• 到期前：[FirstObservedTime, LastObservedTime + KeepAliveSeconds]。

• 到期後：[FirstObservedTime, LastObservedTime]。

樣本：

{
  "__domain__": "k8s",
  "__entity_type__": "k8s.pod",
  "__entity_id__": "abc123...",
  "__method__": "Expire",
  "__last_observed_time__": 1700000200
}

Delete - 刪除實體（謹慎使用）

使用情境：功能被禁用或需要實體在全周期都不可見的情境。

行為邏輯：

• 直接從底層資料庫刪除實體記錄。

• 任何時間段的查詢都無法找到該實體。

⚠️ 注意：這是無法復原操作，請謹慎使用。

Revise - 訂正實體（謹慎使用）

使用情境：資料寫錯需要強制訂正時使用，通常與Delete組合使用。

行為邏輯：

• 直接覆蓋所有欄位，包括__first_observed_time__。

• 不考慮原有資料狀。

推薦方式：增量事件 + 定期全量

核心思路是以增量事件為主，定期全量寫入作為資料校對和容錯機制。

配置建議：

• 增量事件：即時或近即時寫入。

• 定期全量：頻率建議1小時及以上。

• KeepAlive時間：根據業務需求設定，通常10分鐘到1小時。

• 說明：KeepAlive時間根據上報周期進行調整，建議不低於1個上報周期。此外定期上報周期建議不低於5分鐘，避免頻繁更新影響查詢效能。

實際情境應用

// 雲資源建立事件
{
  "__domain__": "acs",
  "__entity_type__": "acs.ecs.instance",
  "__entity_id__": "i-bp1234567890",
  "__method__": "Create",
  "__first_observed_time__": 1700000000,
  "__last_observed_time__": 1700000000,
  "__keep_alive_seconds__": 86400,
  "instance_id": "i-bp1234567890",
  "instance_name": "web-server-01",
  "instance_type": "ecs.c6.large",
  "status": "Running"
}

// K8s Pod全量採集
{
  "__domain__": "k8s",
  "__entity_type__": "k8s.pod",
  "__entity_id__": "pod-web-app-123",
  "__method__": "Update",
  "__last_observed_time__": 1700000400,
  "__keep_alive_seconds__": 3600,
  "pod_name": "web-app-123",
  "namespace": "production",
  "node_name": "worker-01",
  "pod_ip": "10.0.1.100",
  "labels": {
    "app": "web-app",
    "version": "v1.0"
  }
}

不推薦的寫入方式