# 변환 프로세서
<a name="transformation-processors"></a>

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

## add\_entries 프로세서
<a name="add-entries-processor"></a>

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

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

```
processor:
  - add_entries:
      entries:
        - key: "environment"
          value: "production"
          overwrite_if_key_exists: false
```파라미터

`entries`(필수)  
각 로그 이벤트에 추가할 키-값 페어 배열입니다.

`entries[].key`(필수)  
로그 이벤트에 추가할 필드 이름입니다. 점 표기법을 사용하여 중첩 필드를 지원합니다.

`entries[].value`(필수)  
키에 할당할 정적 값입니다.

`entries[].overwrite_if_key_exists` (선택 사항)  
키가 이미 있는 경우의 동작을 결정하는 부울 플래그입니다. 기본값은 false입니다.

`when` (선택 사항)  
프로세서 수준 조건부 표현식. 지정된 경우 표현식이 false로 평가되면 전체 프로세서를 건너뜁니다. 최대 길이는 256자입니다. [조건부 처리를 위한 표현식 구문](conditional-processing.md)을(를) 참조하세요.

`entries[].when` (선택 사항)  
항목 수준 조건부 표현식. 지정된 경우 표현식이 false로 평가되면 이 항목만 건너뜁니다. 최대 길이는 256자입니다. [조건부 처리를 위한 표현식 구문](conditional-processing.md)을(를) 참조하세요.

`entries[].when_else` (선택 사항)  
동일한 프로세서의 다른 `when` 조건이 일치하지 않는 경우에만 실행되는 폴백 항목. 표현식 값은 고려할 `when` 조건을 식별합니다. 최대 길이는 256자입니다. [조건부 처리를 위한 표현식 구문](conditional-processing.md)을(를) 참조하세요.

## copy\_values 프로세서
<a name="copy-values-processor"></a>

한 필드에서 다른 필드로 값을 복사합니다. 최대 1개의 `copy_values` 프로세서를 파이프라인에 추가할 수 있습니다.

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

```
processor:
  - copy_values:
      entries:
        - from_key: "user_id"
          to_key: "backup_user"
          overwrite_if_to_key_exists: false
```파라미터

`entries`(필수)  
각 로그 이벤트에 대해 수행할 복사 작업의 배열입니다.

`entries[].from_key`(필수)  
값을 복사해 올 필드 이름입니다. 중첩 필드에 점 표기법을 사용합니다.

`entries[].to_key`(필수)  
값을 복사할 필드 이름입니다. 점 표기법을 사용할 경우 중첩 구조가 생성됩니다.

`entries[].overwrite_if_to_key_exists` (선택 사항)  
대상 필드가 이미 있는 경우의 동작을 제어하는 부울 플래그입니다. 기본값은 false입니다.

`when` (선택 사항)  
프로세서 수준 조건부 표현식. 지정된 경우 표현식이 false로 평가되면 전체 프로세서를 건너뜁니다. 최대 길이는 256자입니다. [조건부 처리를 위한 표현식 구문](conditional-processing.md)을(를) 참조하세요.

`entries[].when` (선택 사항)  
항목 수준 조건부 표현식. 지정된 경우 표현식이 false로 평가되면 이 항목만 건너뜁니다. 최대 길이는 256자입니다. [조건부 처리를 위한 표현식 구문](conditional-processing.md)을(를) 참조하세요.

`entries[].when_else` (선택 사항)  
동일한 프로세서의 다른 `when` 조건이 일치하지 않는 경우에만 실행되는 폴백 항목. 표현식 값은 고려할 `when` 조건을 식별합니다. 최대 길이는 256자입니다. [조건부 처리를 위한 표현식 구문](conditional-processing.md)을(를) 참조하세요.

## delete\_entries 프로세서
<a name="delete-entries-processor"></a>

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

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

```
processor:
  - delete_entries:
      with_keys: ["temp_field", "debug_info"]
```파라미터

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

`when` (선택 사항)  
이 프로세서의 실행 여부를 결정하는 조건식. 최대 길이는 256자입니다. [조건부 처리를 위한 표현식 구문](conditional-processing.md)을(를) 참조하세요.

## move\_keys 프로세서
<a name="move-keys-processor"></a>

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

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

```
processor:
  - move_keys:
      entries:
        - from_key: "old_field"
          to_key: "new_field"
          overwrite_if_to_key_exists: true
```파라미터

`entries`(필수)  
이동 작업의 배열입니다. 최대 항목 수는 5개입니다.

`entries[].from_key`(필수)  
소스 필드 이름입니다. 최대 128자입니다.

`entries[].to_key`(필수)  
대상 필드 이름입니다. 최대 128자입니다.

`entries[].overwrite_if_to_key_exists` (선택 사항)  
기존 대상 필드를 덮어쓸지 설정합니다.

`when` (선택 사항)  
프로세서 수준 조건부 표현식. 지정된 경우 표현식이 false로 평가되면 전체 프로세서를 건너뜁니다. 최대 길이는 256자입니다. [조건부 처리를 위한 표현식 구문](conditional-processing.md)을(를) 참조하세요.

`entries[].when` (선택 사항)  
항목 수준 조건부 표현식. 지정된 경우 표현식이 false로 평가되면 이 항목만 건너뜁니다. 최대 길이는 256자입니다. [조건부 처리를 위한 표현식 구문](conditional-processing.md)을(를) 참조하세요.

`entries[].when_else` (선택 사항)  
동일한 프로세서의 다른 `when` 조건이 일치하지 않는 경우에만 실행되는 폴백 항목. 표현식 값은 고려할 `when` 조건을 식별합니다. 최대 길이는 256자입니다. [조건부 처리를 위한 표현식 구문](conditional-processing.md)을(를) 참조하세요.

## flatten 프로세서
<a name="flatten-processor"></a>

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

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

```
processor:
  - flatten:
      source: "metadata"
      target: "flattened"
      remove_processed_fields: true
      exclude_keys: ["sensitive_data"]
```파라미터

`source`(필수)  
평면화할 중첩된 객체가 포함된 필드입니다.

`target`(필수)  
평면화된 키의 대상 필드 접두사입니다.

`remove_processed_fields` (선택 사항)  
평면화 후 원본 중첩 필드를 제거할지 설정합니다.

`exclude_keys` (선택 사항)  
평면화에서 제외할 키 배열입니다. 최대 키 수는 20개이며, 각각 최대 128자입니다.

`when` (선택 사항)  
이 프로세서의 실행 여부를 결정하는 조건식. 최대 길이는 256자입니다. [조건부 처리를 위한 표현식 구문](conditional-processing.md)을(를) 참조하세요.