변환 프로세서 - Amazon CloudWatch
add_entries 프로세서copy_values 프로세서delete_entries 프로세서move_keys 프로세서flatten 프로세서

변환 프로세서

변환 프로세서는 필드를 추가, 복사, 이동 또는 제거하여 로그 이벤트의 구조를 수정합니다.

add_entries 프로세서

로그 이벤트에 정적 키-값 페어를 추가합니다. 최대 1개의 add_entries 프로세서를 파이프라인에 추가할 수 있습니다.

구성

다음과 같은 파라미터를 사용하여 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 프로세서를 파이프라인에 추가할 수 있습니다.

구성

다음과 같은 파라미터를 사용하여 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 프로세서

로그 이벤트에서 지정된 필드를 제거합니다.

구성

다음과 같은 파라미터를 사용하여 delete_entries 프로세서를 구성합니다.

processor:
  - delete_entries:
      with_keys: ["temp_field", "debug_info"]
Parameters
with_keys(필수)

각 로그 이벤트에서 제거할 필드 이름의 배열입니다. 점 표기법을 사용하여 중첩 필드 삭제를 지원합니다.

move_keys 프로세서

필드를 한 위치에서 다른 위치로 이동합니다.

구성

다음과 같은 파라미터를 사용하여 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 (선택 사항)

기존 대상 필드를 덮어쓸지 설정합니다.

flatten 프로세서

중첩된 객체 구조를 평면화합니다.

구성

다음과 같은 파라미터를 사용하여 flatten 프로세서를 구성합니다.

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

평면화할 중첩된 객체가 포함된 필드입니다.

target(필수)

평면화된 키의 대상 필드 접두사입니다.

remove_processed_fields (선택 사항)

평면화 후 원본 중첩 필드를 제거할지 설정합니다.

exclude_keys (선택 사항)

평면화에서 제외할 키 배열입니다. 최대 키 수는 20개이며, 각각 최대 128자입니다.