轉換處理器 - Amazon CloudWatch
add_entries 處理器copy_values 處理器delete_entries 處理器move_keys 處理器平面處理器

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

轉換處理器

轉換處理器透過新增、複製、移動或移除欄位來修改日誌事件的結構。

add_entries 處理器

將靜態金鑰/值對新增至日誌事件。最多可將 1 個add_entries處理器新增至管道。

Configuration

使用下列參數設定 add_entries 處理器：

processor:
  - add_entries:
      entries:
        - key: "environment"
          value: "production"
          overwrite_if_key_exists: false
Parameters
entries (必要)

要新增至每個日誌事件的鍵/值對陣列。

entries[].key (必要)

要新增至日誌事件的欄位名稱。支援使用點表示法的巢狀欄位。

entries[].value (必要)

要指派給金鑰的靜態值。

entries[].overwrite_if_key_exists (選用)

布林值旗標，決定金鑰已存在時的行為。預設為 false。

copy_values 處理器

將值從一個欄位複製到另一個欄位。最多可將 1 個copy_values處理器新增至管道。

Configuration

使用下列參數設定 copy_values 處理器：

processor:
  - copy_values:
      entries:
        - from_key: "user_id"
          to_key: "backup_user"
          overwrite_if_to_key_exists: false
Parameters
entries (必要)

在每個日誌事件上執行的複製操作陣列。

entries[].from_key (必要)

要從中複製值的欄位名稱。將點表示法用於巢狀欄位。

entries[].to_key (必要)

要複製值的欄位名稱。如果使用點表示法，則會建立巢狀結構。

entries[].overwrite_if_to_key_exists (選用)

當目標欄位已存在時，控制行為的布林值旗標。預設為 false。

delete_entries 處理器

從日誌事件中移除指定的欄位。

Configuration

使用下列參數設定 delete_entries 處理器：

processor:
  - delete_entries:
      with_keys: ["temp_field", "debug_info"]
Parameters
with_keys (必要)

要從每個日誌事件中移除的欄位名稱陣列。支援使用點符號刪除巢狀欄位。

move_keys 處理器

將欄位從一個位置移至另一個位置。

Configuration

使用下列參數設定 move_keys 處理器：

processor:
  - move_keys:
      entries:
        - from_key: "old_field"
          to_key: "new_field"
          overwrite_if_to_key_exists: true
Parameters
entries (必要)

移動操作陣列。最多 5 個項目。

entries[].from_key (必要)

來源欄位名稱。最多 128 個字元。

entries[].to_key (必要)

目標欄位名稱。最多 128 個字元。

entries[].overwrite_if_to_key_exists (選用)

是否覆寫現有的目標欄位。

平面處理器

扁平化巢狀物件結構。

Configuration

使用下列參數設定平面處理器：

processor:
  - flatten:
      source: "metadata"
      target: "flattened"
      remove_processed_fields: true
      exclude_keys: ["sensitive_data"]
Parameters
source (必要)

包含要扁平化之巢狀物件的欄位。

target (必要)

扁平化金鑰的目標欄位字首。

remove_processed_fields (選用)

是否在平面化後移除原始巢狀欄位。

exclude_keys (選用)

要從平面化中排除的索引鍵陣列。最多 20 個金鑰，每個最多 128 個字元。