操作事件增加新欄位 - ActionTrail

Action Trail將於2020年12月16日00:00:00起，在操作事件中新增eventRW（事件的讀寫類型）、resourceName（事件的相關資源名稱）和resourceType（事件的相關資源類型）三個欄位。此次變更將協助您更好地分析後續的操作事件，而且不會影響您對已有操作事件的分析。

變更說明

Action Trail將在事件中增加以下三個欄位：

欄位名稱	欄位類型	描述	樣本
eventRW	String	事件的讀寫類型。取值： Write：寫類型。 Read：讀類型。	Read
resourceName	String	事件的相關資源名稱。相比已有的referenceResources欄位，resourceName欄位將表示事件相關的資源名稱（ID）欄位單獨拆分出來，是資源的唯一標識。 resourceName可以在Log Service中作為索引，提供按照資源名稱查詢的能力。	事件涉及單個資源類型的單個資源：`i-bp1example1`。事件涉及單個資源類型的多個資源：`i-bp1example1,i-bp1example2`。事件涉及多種資源類型的多個資源：`i-bp1example1,i-bp1example2;v-bp1example1`。說明同類型的資源名稱（ID）之間以英文逗號（,）間隔，不同類型的資源名稱（ID）之間以半形分號（;）間隔。
resourceType	List	事件的相關資源類型。相比已有的referenceResources欄位，resourceType欄位將表示事件相關的資源類型欄位單獨拆分出來。 resourceType可以在Log Service中作為索引，提供按照資源類型查詢的能力。	事件涉及單個資源類型的單個資源：`ACS::ECS::Instance`。事件涉及單個資源類型的多個資源：`ACS::ECS::Instance`。事件涉及多種資源類型的多個資源：`ACS::ECS::Instance;ACS::VPC::VPC`。說明多個資源類型之間以半形分號（;）間隔。

變更前後事件欄位程式碼範例如下：

變更前

{
  "referenceResources": {
    "ACS::ECS::Instance": [
      "i-bp1fadfuy****",
      "i-bp1fadfad****"
    ]
  }
}

變更後

{
  "eventRW": "Read",
  "referenceResources": {
    "ACS::ECS::Instance": [
      "i-bp1fadfuy****",
      "i-bp1fadfad****"
    ]
  },
    "resourceName": "i-bp1fadfuy****,i-bp1fadfad****",
    "resourceType": "ACS::ECS::Instance"
}

對您的影響

本次變更不會影響已有跟蹤投遞的操作事件的分析活動。

變更生效後：

對於已有跟蹤和建立跟蹤，投遞到SLS Logstore或OSS Bucket的操作事件都會包含新增欄位。
對於建立跟蹤，投遞到SLS Logstore的操作事件會包含新增欄位的索引。
對於已有跟蹤，投遞到SLS Logstore的操作事件不會包含新增欄位的索引。當您需要分析新增欄位時，建議您手動添加索引。
- 通過Log Service控制台補充新增欄位的索引
  1. 登入Log Service控制台。
  2. 在Project列表地區，單擊操作事件對應的Project名稱。
  3. 單擊日誌庫名稱，在頁面右上方選擇查詢分析屬性 > 屬性。
  4. 單擊欄位下方加號增加eventRW、resourceName和resourceType欄位。
  5. 單擊確定。
- 通過CloudShell補充新增欄位的索引
  在CloudShell中執行如下命令：
```
actiontrail-update-index [project] [logstore] [regionId]
```
  請將參數替換為跟蹤中設定的Log ServiceProject、Logstore和RegionId，例如：
```
actiontrail-update-index actiontrail-ev****  actiontrail-test**** cn-hangzhou
```