변환 프로세서
변환 프로세서는 필드를 추가, 복사, 이동 또는 제거하여 로그 이벤트의 구조를 수정합니다.
add_entries 프로세서
로그 이벤트에 정적 키-값 페어를 추가합니다. 최대 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자입니다. 조건부 처리를 위한 표현식 구문을(를) 참조하세요.
entries[].when(선택 사항)-
항목 수준 조건부 표현식. 지정된 경우 표현식이 false로 평가되면 이 항목만 건너뜁니다. 최대 길이는 256자입니다. 조건부 처리를 위한 표현식 구문을(를) 참조하세요.
entries[].when_else(선택 사항)-
동일한 프로세서의 다른
when조건이 일치하지 않는 경우에만 실행되는 폴백 항목. 표현식 값은 고려할when조건을 식별합니다. 최대 길이는 256자입니다. 조건부 처리를 위한 표현식 구문을(를) 참조하세요.
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
파라미터
entries(필수)-
각 로그 이벤트에 대해 수행할 복사 작업의 배열입니다.
entries[].from_key(필수)-
값을 복사해 올 필드 이름입니다. 중첩 필드에 점 표기법을 사용합니다.
entries[].to_key(필수)-
값을 복사할 필드 이름입니다. 점 표기법을 사용할 경우 중첩 구조가 생성됩니다.
entries[].overwrite_if_to_key_exists(선택 사항)-
대상 필드가 이미 있는 경우의 동작을 제어하는 부울 플래그입니다. 기본값은 false입니다.
when(선택 사항)-
프로세서 수준 조건부 표현식. 지정된 경우 표현식이 false로 평가되면 전체 프로세서를 건너뜁니다. 최대 길이는 256자입니다. 조건부 처리를 위한 표현식 구문을(를) 참조하세요.
entries[].when(선택 사항)-
항목 수준 조건부 표현식. 지정된 경우 표현식이 false로 평가되면 이 항목만 건너뜁니다. 최대 길이는 256자입니다. 조건부 처리를 위한 표현식 구문을(를) 참조하세요.
entries[].when_else(선택 사항)-
동일한 프로세서의 다른
when조건이 일치하지 않는 경우에만 실행되는 폴백 항목. 표현식 값은 고려할when조건을 식별합니다. 최대 길이는 256자입니다. 조건부 처리를 위한 표현식 구문을(를) 참조하세요.
delete_entries 프로세서
로그 이벤트에서 지정된 필드를 제거합니다.
구성
다음과 같은 파라미터를 사용하여 delete_entries 프로세서를 구성합니다.
processor: - delete_entries: with_keys: ["temp_field", "debug_info"]
파라미터
with_keys(필수)-
각 로그 이벤트에서 제거할 필드 이름의 배열입니다. 점 표기법을 사용하여 중첩 필드 삭제를 지원합니다.
when(선택 사항)-
이 프로세서의 실행 여부를 결정하는 조건식. 최대 길이는 256자입니다. 조건부 처리를 위한 표현식 구문을(를) 참조하세요.
move_keys 프로세서
필드를 한 위치에서 다른 위치로 이동합니다.
구성
다음과 같은 파라미터를 사용하여 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자입니다. 조건부 처리를 위한 표현식 구문을(를) 참조하세요.
entries[].when(선택 사항)-
항목 수준 조건부 표현식. 지정된 경우 표현식이 false로 평가되면 이 항목만 건너뜁니다. 최대 길이는 256자입니다. 조건부 처리를 위한 표현식 구문을(를) 참조하세요.
entries[].when_else(선택 사항)-
동일한 프로세서의 다른
when조건이 일치하지 않는 경우에만 실행되는 폴백 항목. 표현식 값은 고려할when조건을 식별합니다. 최대 길이는 256자입니다. 조건부 처리를 위한 표현식 구문을(를) 참조하세요.
flatten 프로세서
중첩된 객체 구조를 평면화합니다.
구성
다음과 같은 파라미터를 사용하여 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자입니다. 조건부 처리를 위한 표현식 구문을(를) 참조하세요.
