> For the complete documentation index, see [llms.txt](https://docs.panther.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.panther.com/ko/data-onboarding/ingestion-filters/normalized-event.md).

# 정규화된 이벤트 필터

## 개요

Panther에서 정규화된 이벤트 필터를 사용하여 데이터가 분류된 후, 즉 로그 스키마에 따라 파싱된 후 데이터를 걸러낼 수 있습니다.

정규화된 이벤트 필터는 포함 필터 또는 제외 필터로 만들 수 있습니다. 다음에 대해 알아보세요: [포함 필터와 제외 필터의 차이점은 여기에서 확인하세요](https://docs.panther.com/ko/data-onboarding/ingestion-filters/pages/0b59297eabc410c13c8ec828556216a8d2ba11b0#inclusion-vs.-exclusion-filters).

정규화된 이벤트 필터를 활성화한 후에는 다음을 통해 성능을 모니터링하세요: [필터링된 이벤트 메트릭 보기](#viewing-filtered-event-metrics).

{% hint style="info" %}
정규화된 이벤트 필터는 연결된 로그 유형의 스키마에 의존합니다. 스키마를 변경하면 필터가 더 이상 적용되지 않을 수 있으므로, 필요에 따라 관련 필터도 함께 업데이트하세요.
{% endhint %}

{% hint style="warning" %}
여러 개의(포함 또는 제외) 정규화된 이벤트 필터를 만들면 실행 순서가 보장되지 않습니다. 따라서 여러 개의 `OR` 포함용 OR 식은 같은 필터 안에 묶는 것이 좋습니다. 대신 여러 개의 별도 포함 필터를 만들면, 먼저 평가되는 다른 필터가 해당 이벤트를 포함하지 않을 경우 포함하려던 이벤트가 삭제될 수 있습니다.
{% endhint %}

## 정규화된 이벤트 필터를 만드는 방법

정규화된 이벤트 필터를 만들려면:

1. Panther Console의 왼쪽 탐색 모음에서 **로그 소스**.
2. 필터를 추가하려는 로그 소스의 이름을 클릭합니다.
3. 다음 타일을 클릭하세요: **필터** 탭.
4. 의 오른쪽에 있는 **정규화된 이벤트 필터** 타일을 클릭하세요: **필터 추가**.

   <figure><img src="/files/315548e9b1c9506aeaf048f31dcf36e9dd9dfb42" alt="Under a &#x22;TestSqs&#x22; header, an arrow is drawn from a Filters tab to an Add Filter button on a Normalized Events Filters tile." width="375"><figcaption></figcaption></figure>
5. 새 필터 양식이 펼쳐집니다. 필터를 구성하세요:
   1. (선택 사항) 연필 아이콘( <img src="/files/672d7bdb6cf3e44ad6fc824a81c42ccafc67148c" alt="pencil icon" data-size="line">) 필터 이름을 편집합니다.
   2. 다음 **로그 유형** 드롭다운에서 이 필터를 적용할 로그 유형을 선택합니다.
   3. 다음 **조건** 드롭다운에서 선택하세요:
      * **다음이면 제외**: 다음과 같은 경우 선택하세요 [제외 필터](https://docs.panther.com/ko/data-onboarding/ingestion-filters/pages/0b59297eabc410c13c8ec828556216a8d2ba11b0#inclusion-vs.-exclusion-filters).
      * **다음이면 포함**: 다음과 같은 경우 선택하세요 [포함 필터](https://docs.panther.com/ko/data-onboarding/ingestion-filters/pages/0b59297eabc410c13c8ec828556216a8d2ba11b0#inclusion-vs.-exclusion-filters).
        * 포함 필터의 경우 모든 것이 *일치하지 않는* 삭제되며 다시 수집할 방법이 없습니다.
   4. 클릭합니다 **필터 추가**, 그런 다음 필터를 구성하세요:
      1. 드롭다운에서 이벤트 필드를 선택합니다. 선택한 로그 유형의 필드만 표시됩니다.
      2. 드롭다운 메뉴에서 연산자를 선택합니다.
         * 드롭다운 옵션은 선택한 필드의 데이터 유형에 적용 가능한 항목으로 제한됩니다. 다음을 참조하세요: [지원되는 필드 유형 및 연산자](#supported-field-types-and-operators), 아래.
      3. 선택한 연산자에 값이 필요한 경우 값을 입력합니다.
      4. 다른 필터 식을 만들려면:

         * 다음을 만들려면 `AND` 필터를 만들려면, 방금 만든 식 바깥쪽(하지만 같은 가로 막대 안)을 클릭하거나 다음을 누르세요: `TAB`.
           * 다음을 만들려면 `OR` 필터를 만들려면, 클릭하세요 **+ OR 조건 추가**.

         <figure><img src="/files/4af78d928a1586886fbf433dcc685eacfe9133a5" alt="A &#x22;Normalized Event filters&#x22; expandable block is shown with fields including &#x22;Log Type,&#x22; &#x22;Exclusion Pattern,&#x22; and Quick Test." width="563"><figcaption></figcaption></figure>
   5. 오른쪽 상단에서 다음을 클릭하세요: **저장**.

## 정규화된 이벤트 필터 활성화 또는 비활성화

수집 필터를 만든 후에는 이를 활성화하거나 비활성화할 수 있습니다:

1. Panther Console의 왼쪽 탐색 모음에서 **로그 소스**.
2. 필터를 활성화하거나 비활성화하려는 로그 소스의 이름을 클릭합니다.
3. 다음 타일을 클릭하세요: **필터** 탭.
4. 활성화하거나 비활성화하려는 필터를 찾아 토글을 다음으로 설정합니다 **활성화됨** 또는 **비활성화됨**.\
   ![A log source titled "Dev account" is shown. An arrow is drawn from a tab called "Filters" to an "Enabled" toggle next to a filter in the "Normalized Events filters" section.](/files/312d145c9063e954f986734a047919c62747bea3)

## 필터링된 이벤트 메트릭 보기

* 참고 [필터링된 이벤트 볼륨 보기](/ko/data-onboarding/monitoring-log-sources.md#viewing-filtered-event-volume).

## 지원되는 필드 유형 및 연산자 의미

"Field data type" 열에 있는 데이터 유형의 이벤트 필드에 필터를 구성할 수 있습니다. "Supported operators" 열에 나열된 연산자는 다음의 하위 집합입니다: [검색 도구가 지원하는 연산자](/ko/search/search-tool/filter-operators.md#supported-operators).

<table><thead><tr><th width="205">필드 데이터 유형</th><th>지원되는 연산자</th><th width="263">참고</th></tr></thead><tbody><tr><td><code>문자열</code></td><td><ul><li>같음 / 같지 않음</li></ul></td><td><code>null</code> 값은 무시됩니다.<br><br>예: 필터가 <code>"animal" IS "bear"</code> 이면 페이로드 <code>{"animal": null}</code> 일치하지 않습니다.<br><br>하지만 필터 <code>"animal" IS NOT "bear"</code> 는 <strong>역시 일치하지 않습니다.</strong></td></tr><tr><td></td><td><ul><li>비어 있음 / 비어 있지 않음("is / is not null"과는 다름)</li></ul></td><td><code>null</code> 값은 무시됩니다.<br><br>예: 필터가 <code>"animal" IS EMPTY</code> 이면 페이로드 <code>{"animal": null}</code> 일치하지 않습니다.<br><br>하지만 필터 <code>"animal" IS NOT EMPTY</code> 는 <strong>역시 일치하지 않습니다.</strong></td></tr><tr><td></td><td><ul><li>목록에 있음 / 목록에 없음</li></ul></td><td><p>필터 토큰의 공백은 무시됩니다!<br></p><p>예: 필터가 <code>목록에 있음 ["text "]</code> 해당 <code>"text"</code> 페이로드(뒤에 공백 없음)도 일치합니다.<br><br>반대의 경우는 <strong>사실이 아닙니다!</strong> 공백은 <strong>페이로드 값에서 무시되지 않습니다</strong>.<br><br>예: 필터가 <code>목록에 있음 ["text"]</code> 해당 <code>"text "</code> 페이로드(뒤에 공백 있음)는 일치하지 않습니다.</p></td></tr><tr><td></td><td><ul><li>하위 문자열이 있음 / 하위 문자열이 없음</li></ul></td><td><code>null</code> 페이로드의 값은 <strong>일치하지 않습니다</strong> 두 경우 모두에서 <code>하위 문자열이 있음</code> <strong>및</strong> 에 <code>하위 문자열이 없음</code><br><br>예:. 두 필터 모두 <code>"animal" 하위 문자열 있음 "bear"</code> 및 <code>"animal" 하위 문자열이 없음 "bear"</code> 페이로드와 일치하지 않습니다 <code>{"animal": null}</code></td></tr><tr><td></td><td><ul><li>null임 / null 아님</li></ul></td><td>명시적인 <code>"null"</code> 문자열도 처리되며 일치하는 것으로 간주됩니다</td></tr><tr><td></td><td><ul><li>다음 범위 내에 있음 <a href="https://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing">CIDR</a></li></ul></td><td></td></tr><tr><td><code>boolean</code></td><td><ul><li>참임 / 거짓임</li></ul></td><td></td></tr><tr><td></td><td><ul><li>null임 / null 아님</li></ul></td><td>명시적인 <code>"null"</code> 문자열도 처리되며 일치하는 것으로 간주됩니다</td></tr><tr><td><code>숫자</code><br>(<code>정수</code>, <code>빅정수</code>, <code>smallint</code>, <code>float</code>)</td><td><ul><li>같음 / 같지 않음</li></ul></td><td></td></tr><tr><td></td><td><ul><li>크거나 같음</li></ul></td><td></td></tr><tr><td></td><td><ul><li>작거나 같음</li></ul></td><td></td></tr><tr><td></td><td><ul><li>null임 / null 아님</li></ul></td><td>명시적인 <code>"null"</code> 문자열도 처리되며 일치하는 것으로 간주됩니다</td></tr><tr><td><code>타임스탬프</code></td><td><ul><li>이전임 / 이후임</li></ul></td><td></td></tr><tr><td></td><td><ul><li>null임 / null 아님</li></ul></td><td>명시적인 <code>"null"</code> 문자열도 처리되며 일치하는 것으로 간주됩니다</td></tr><tr><td><code>array</code></td><td><ul><li>있음 / 없음</li></ul></td><td>중첩 필드에 대한 필터링이 지원됩니다 <strong>하위 문자열 기준으로!</strong><br><br>예: 필터가 <code>"animals"에 "wolf"가 포함됨</code> 이면 페이로드 <code>{"animals": ["dog", "wolf"]}</code> 는 일치합니다. 하지만 페이로드 <code>{"animals": ["dog", "werewolf"]}</code> 는 <strong>도 일치합니다</strong>.<br><br>또한 페이로드에서 누락된 필드는 다음과 일치하지 않습니다 <code>없음</code> 필터입니다.<br><br>예: 다음과 같은 필터는 <code>"animals"에 "bear" 없음</code>, 는 <strong>일치하지 않습니다</strong> 다음과 같은 페이로드와 <code>{"irrelevant": "something-else"}</code>.<br><br>또한 모든 중첩 필드는 문자열로 강제 변환됩니다.<br><br>예: 다음과 같은 필터는 <code>"animals"에 "1" 있음</code>, 는 <strong>두 경우 모두와 일치합니다</strong> 이러한 페이로드 <code>{"animals": ["1","2"]}</code>, <code>{"animals": [1,2]}</code>,</td></tr><tr><td></td><td><ul><li>null임 / null 아님</li></ul></td><td>명시적인 <code>"null"</code> 문자열도 처리되며 일치하는 것으로 간주됩니다</td></tr><tr><td><code>object</code></td><td><ul><li>포함함 / 포함하지 않음</li></ul></td><td>중첩 필드에 대한 필터링이 지원됩니다 <strong>하위 문자열 기준으로 처리되며, 키와 값 모두 고려됩니다!</strong><br><br>예: 필터가 <code>"animal"에 "werewolf" 포함</code> 이면 페이로드 <code>{"animal": {"type": "werewolf"}}</code> 는 일치합니다. 하지만 페이로드<code>{"animal": {"werewolf": {"age": 3}}}</code> 는 <strong>도 일치합니다.</strong></td></tr><tr><td></td><td><ul><li>null임 / null 아님</li></ul></td><td>명시적인 <code>"null"</code> 문자열도 처리되며 일치하는 것으로 간주됩니다</td></tr><tr><td><code>json</code></td><td><ul><li>포함함 / 포함하지 않음</li></ul></td><td>중첩 필드에 대한 필터링은 다음 조건에서 지원됩니다 <code>포함함</code> 조건. 이는 또한 작동합니다 <strong>하위 문자열 기준으로 처리되며, 키와 값 모두 고려됩니다!</strong><br><br>예: 필터가 <code>"animals"에 "wolf"가 포함됨</code> 이면 페이로드 <code>{"animals": ["dog", "wolf"]}</code> 는 일치합니다. 하지만 페이로드 <code>{"animals": ["dog", "werewolf"]}</code> 는 <strong>도 일치합니다</strong>.<br><br>JSON 유형 필드는 다음과 같이 표시됩니다 <code>object</code> 정규화된 필터 UI에서</td></tr><tr><td></td><td><ul><li>null임 / null 아님</li></ul></td><td>명시적인 <code>"null"</code> 문자열도 처리되며 일치하는 것으로 간주됩니다</td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.panther.com/ko/data-onboarding/ingestion-filters/normalized-event.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.