> 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/raw-event.md).

# 원시 이벤트 필터

## 개요

원시 이벤트 필터를 사용하면 수집된 이벤트를 필터링하여 제외할 조건을 정의할 수 있습니다. 이는 원시 데이터에 적용됩니다 *전에* 로그 스키마에 의해 파싱되기 전이며, 정규식 표현식이나 부분 문자열 패턴을 사용해 정의할 수 있습니다.

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

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

{% hint style="warning" %}
여러 개의(포함 또는 제외) 원시 이벤트 필터를 만들 경우, 실행 순서는 보장되지 않습니다. 여러 포함 필터를 만들 때는 이 점에 특히 유의하세요. 필터가 임의의 순서로 실행되므로, 먼저 평가되는 다른 필터에 해당 이벤트가 포함되지 않으면 포함하려던 이벤트가 삭제될 수 있습니다.
{% endhint %}

### 원시 이벤트 필터의 유형

현재 필터에는 두 가지 유형이 있습니다:

* 정규식 필터**:** 정규식 표현식과 일치하는 이벤트는 삭제됩니다.
  * 정규식 필터는 다음을 사용합니다 [Google의 RE2 엔진](https://github.com/google/re2/wiki/Syntax).
* 부분 문자열 필터**:** 패턴을 한 번 이상 포함하는 이벤트는 삭제됩니다.

<figure><img src="/files/441ae57879aeb0080b223ff97b24ae1fc88792a1" alt="In a log event filter, an Exclusion Condition is shown. The filter reads, &#x22;Exclude if&#x22; and a select box is open, showing two options: &#x22;Matches Regex&#x22; and &#x22;Contains&#x22;"><figcaption></figcaption></figure>

## 원시 이벤트 필터를 만드는 방법

{% hint style="warning" %}
원시 이벤트 필터는 파싱되지 않은 이벤트에 적용됩니다—*아닌* 데이터 레이크에서 볼 수 있는 것과 같은 정규화된 이벤트가 아닙니다. 필터를 원시 데이터를 기반으로 구성하고 있는지 확인하세요. 원시 데이터 필터를 정규화된 데이터에 기반해 만들면 오탐이 발생하고 의도치 않게 데이터가 삭제될 수 있습니다.

대신 파싱된 이벤트용 필터를 만들려면 다음을 참조하세요 [정규화된 이벤트 필터](/ko/data-onboarding/ingestion-filters/normalized-event.md).
{% endhint %}

원시 이벤트 필터를 만들려면:

1. Panther Console의 왼쪽 탐색 모음에서 **로그 소스**.
2. 필터를 추가할 로그 소스 이름을 클릭합니다.
3. 다음 타일을 클릭하세요: **필터** 탭.
4. 다음의 오른쪽에서 **원시 이벤트 필터** 타일을 클릭하세요: **필터 추가**.\
   ![The "Filters" tab of an "AY Okta" Log source is shown. There is an arrow drawn to a blue "Add Filter" button.](/files/2b8f2008deaf281672e54fa8afd76289d5b0f9d3)
5. 확장된 새 필터 양식에서 필터를 구성합니다:
   1. (선택 사항) 연필 아이콘(<img src="/files/672d7bdb6cf3e44ad6fc824a81c42ccafc67148c" alt="pencil icon" data-size="line">)을 클릭하여 필터 이름을 편집합니다.
   2. 다음 **조건** 드롭다운에서 항목을 선택합니다:
      * **다음이면 제외**: 다음과 같은 필터를 만들려면 이 옵션을 선택하세요 [제외 필터](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).
        * 포함 필터의 경우, 모든 항목이 *일치하지 않는* 항목은 삭제되며 다시 수집할 방법이 없습니다.
   3. 클릭합니다 **+** 조건을 추가합니다.\
      ![An "Exclusion Condition" is shown. There is an "Exclude if" statement, with a plus sign to its right. The plus sign is circled.](/files/9933655f9c426f54a48f93e925336273007b0075)
   4. 클릭합니다 **조건**, 그런 다음 아래 옵션 중 하나를 선택합니다. 조건을 구성하는 다양한 방법에 대해 자세히 알아보려면 다음을 참조하세요 [원시 이벤트 필터의 유형](#types-of-raw-event-filters).
      * **정규식과 일치**
      * **포함**\
        ![In a log event filter, an Exclusion Condition is shown. The filter reads, "Exclude if" and a select box is open, showing two options: "Matches Regex" and "Contains"](/files/b2cdbeb2c86a16f2739600c0358bb19fcd185a5e)
   5. 다음을 선택했다면 **정규식과 일치** 조건에서는 정규식을 입력하세요. 다음을 선택했다면 **포함** 조건에서는 문자열 값을 입력하세요.
   6. 다음 **빠른 테스트** 섹션에서 방금 만든 필터로 테스트할 원시 이벤트를 입력하세요.
      * 다음을 클릭할 수 있습니다 **원시 데이터 보기** 를 클릭하면 소스가 수신한 원시 이벤트를 볼 수 있습니다. 이벤트 오른쪽에서 다음을 클릭하세요 **이벤트 테스트** 를 눌러 다음을 채웁니다 **원시 이벤트** 필드에 **빠른 테스트** 이벤트를 입력합니다.\
        ![A list of raw events is shown. Each row has a "Test event" button on the right-hand side. The "Test event" button in the first row is circled.](/files/8838beedf75b46ac31743a08f94c0cfd13802cb1)
   7. 클릭합니다 **테스트 실행**.
      * 테스트 이벤트가 패턴과 일치하는지 확인하세요.
   8. 필터는 기본적으로 활성화되어 있습니다. 비활성화하려면 다음을 클릭하세요 **활성화됨** 토글.
6. 오른쪽 상단에서 다음을 클릭하세요: **저장**.

## 원시 이벤트 필터 활성화 또는 비활성화

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

1. Panther Console의 왼쪽 탐색 모음에서 **로그 소스**.
2. 필터를 활성화하거나 비활성화할 로그 소스 이름을 클릭합니다.
3. 다음 타일을 클릭하세요: **필터** 탭.
4. 활성화하거나 비활성화할 필터를 찾아 토글을 다음으로 설정합니다 **활성화됨** 또는 **비활성화됨**.\
   ![Under a "Dev account" header, an arrow is pointing from a Filters tab to an "Enabled" toggle on a tile called "Event Based Filter cc4e0a."](/files/312d145c9063e954f986734a047919c62747bea3)\\

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

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


---

# 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/raw-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.