# 필터 프로세서
<a name="filter-processors"></a>

필터 프로세서를 사용하면 정의한 조건에 따라 파이프라인에서 로그 항목을 선택적으로 제거할 수 있습니다.

## drop\$1events 프로세서
<a name="drop-events-processor"></a>

조건식에 따라 원치 않는 로그 항목을 필터링합니다. 이 프로세서를 사용하면 지정된 조건과 일치하는 로그 이벤트를 제거하여 타사 파이프라인 커넥터의 노이즈를 줄이고 스토리지 비용을 절감할 수 있습니다.

**구성**  
다음 파라미터를 사용하여 drop\$1events 프로세서를 구성합니다.

```
processor:
  - drop_events:
      when: "log.level == 'DEBUG' or log.level == 'TRACE'"
```파라미터

`when`(필수)  
삭제할 로그 항목을 결정하는 조건식. 이 표현식과 일치하는 로그 항목은 파이프라인에서 제거됩니다. 최대 길이는 256자입니다. 표현식 구문은 [조건부 처리를 위한 표현식 구문](conditional-processing.md) 섹션을 참조하세요.

`handle_expression_failure` (선택 사항)  
`when` 표현식 평가가 실패할 때의 동작. 허용된 값: `"skip"`(기본값)은 이벤트를 유지하고, `"apply"`는 실패와 무관하게 이벤트를 삭제합니다.

**Example 심각도가 낮은 로그 항목 삭제**  
다음 구성은 심각도가 높은 이벤트만 유지하면서 모든 DEBUG 및 TRACE 로그 항목을 삭제합니다.  

```
processor:
  - drop_events:
      when: "log.level in {'DEBUG', 'TRACE'}"
      handle_expression_failure: "skip"
```