> 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/field-discovery.md).

# 필드 탐색

## 개요

필드 검색은 Panther에서 연결한 로그 소스가 상위 단계에서 생성하는 이벤트의 구조를 변경하더라도, 변경된 필드의 데이터를 잃지 않도록 보장하는 데 도움이 됩니다.

로그 소스 스키마는 특정 로그 유형에 대해 Panther가 어떤 필드를 찾아야 하는지 개략적으로 설명하여, 들어오는 원시 이벤트가 Panther에서 어떻게 파싱되고 저장되는지 정의합니다. 들어오는 이벤트에 해당 스키마에 정의되지 않은 필드가 포함되어 있으면:

* **필드 검색이 활성화되지 않은 경우**, 해당 인식되지 않은 필드의 데이터는 삭제됩니다.
* **필드 검색이 활성화된 경우**, 해당 필드가 식별되고 그 데이터가 저장됩니다. 즉, 이후 이 필드의 데이터를 쿼리하고 이를 참조하는 탐지를 작성할 수 있습니다.

필드 검색은 다음에 사용할 수 있습니다 [사용자 지정 로그 스키마](/ko/data-onboarding/custom-log-types.md) 및 많은 [Panther 관리 스키마](/ko/data-onboarding/supported-logs.md).

## 필드 검색 활성화 <a href="#enabling-field-discovery" id="enabling-field-discovery"></a>

### 사용자 지정 스키마에 대해 필드 검색 활성화 <a href="#enabling-field-discovery" id="enabling-field-discovery"></a>

사용자 지정 스키마에서 필드 검색을 활성화하려면:

* 다음을 [사용자 지정 스키마 편집](/ko/data-onboarding/custom-log-types.md#editing-a-custom-schema) 안내에 따라, 반드시 **필드 검색** `켜기` 에서 **기본 정보** 섹션.

<figure><img src="/files/fc36d8d9661b83db2ffc13fefde749327c15fa07" alt="In a Basic Info section, a Field Discovery toggle is set to ON."><figcaption></figcaption></figure>

### Panther 관리 스키마에서 필드 검색 활성화

Panther 관리 스키마에서 필드 검색을 활성화하기 위해 별도의 조치는 필요하지 않습니다. 지원되는 모든 스키마에서는 기본적으로 활성화되어 있습니다. 특정 Panther 관리 스키마에서 필드 검색이 활성화되어 있는지 확인하려면 [아래의 지침](#verifying-field-discovery-is-enabled).

### 필드 검색이 활성화되어 있는지 확인

스키마(Panther 관리 또는 사용자 지정)에서 필드 검색이 활성화되어 있는지 확인하려면:

1. Panther Console의 왼쪽 탐색 모음에서 **스키마**.
2. 목록에서 필드 검색 활성화 여부를 확인하려는 스키마를 찾은 다음, 해당 항목의 값에 주목하세요 **필드 검색** 열.

<figure><img src="/files/73f6b21b0c1f072404b89599a7f3eba85bf95058" alt="In a table with four columns and two rows (excluding the header row), a column labeled &#x22;Field Discovery&#x22; is circled."><figcaption></figcaption></figure>

## 필드가 발견될 때 스키마가 어떻게 변경되는가

필드가 발견되면:

* 사용자 지정 스키마의 경우: 스키마가 업데이트되어 발견된 필드가 포함됩니다.
* Panther 관리 스키마의 경우: Panther 인스턴스의 스키마가 업데이트되어 발견된 필드가 포함됩니다. 이 필드가 여러 Panther 인스턴스에서 일관되고 안정적으로 발견되면, Panther 관리 스키마에 영구적으로 승격될 수 있습니다.

## 발견된 필드 초기화

토글하여 스키마에 대해 이전에 발견된 모든 필드를 지울 수 있습니다 **필드 검색** `끔` 그런 다음 `켜기` 다시. 발견된 필드는 즉시 삭제되며, Panther는 앞으로 들어오는 이벤트에서 필드를 다시 탐지하기 시작합니다.

{% hint style="warning" %}
발견된 필드를 초기화하면 스키마에서 제거됩니다. 해당 필드를 참조하는 탐지나 쿼리는 다시 발견될 때까지 더 이상 해당 필드를 찾지 못합니다.
{% endhint %}

## 필드 이름의 특수 문자 처리

발견된 필드 이름에 특수 문자—즉, 영숫자, 밑줄(`_`) 또는 대시(`-`)—가 포함되어 있으면 아래 알고리즘에 따라 음역됩니다:

* `@` 에서 `at 기호`
* `,` 에서 `쉼표`
* `` ` `` 에서 `백틱`
* `'` 에서 `아포스트로피`
* `$` 에서 `달러 기호`
* `*` 에서 `별표`
* `&` 에서 `앰퍼샌드`
* `!` 에서 `느낌표`
* `%` 에서 `퍼센트`
* `+` 에서 `플러스`
* `/` 에서 `슬래시`
* `\` 에서 `백슬래시`
* `#` 에서 `샵`
* `~` 에서 `틸드`
* `=` 에서 `eq`

또한, 대시(`-`) 또는 숫자가 필드 이름의 첫 번째 문자이면 음역됩니다. 대시는 `대시`가 되고, 숫자는 글자로 표기됩니다(예: `7` 가 되면 `일곱`).

그 외의 모든 ASCII 문자(예: `공백`)는 밑줄(`_`)로 대체됩니다. ASCII가 아닌 문자는 가장 가까운 ASCII 대응 문자로 음역됩니다.

이 음역은 필드 이름에만 적용되며, 값은 수정되지 않습니다.

## 필드 검색의 제한 사항

현재 필드 검색에는 다음과 같은 제한이 있습니다:

* 탐지할 수 있는 최상위 필드의 최대 수는 2,000개입니다. 각 `객체` 필드 내에서는 최대 1,000개의 필드를 탐지할 수 있습니다.
  * 전체적으로 탐지되는 필드 수에는 제한이 없습니다.
* 스키마가 [`csv` 파서](/ko/data-onboarding/custom-log-types/csv-parser.md) 를 사용하고 헤더 없이 CSV 로그를 파싱하는 경우, 스키마의 `열` 섹션에 포함된 필드만 탐지됩니다.
  * 이 제한은 스키마가 [`csv` 파서](/ko/data-onboarding/custom-log-types/csv-parser.md) 를 사용하고 CSV 로그를 파싱하는 경우에는 적용되지 않습니다 *헤더가* 있는 경우.
* 스키마가 [`fastmatch` 파서](/ko/data-onboarding/custom-log-types/fastmatch-parser.md), 오직 `match` 패턴에 정의된 필드만 탐지됩니다.
* 스키마가 [`정규식` 파서](/ko/data-onboarding/custom-log-types/regex-parser.md), 오직 `match` 패턴에 정의된 필드만 탐지됩니다.


---

# 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/field-discovery.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.