> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vetox.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 로깅

> 148개의 서로 다른 서버 이벤트를 Discord 채널이나 웹훅에 기록하며, 각각 채널과 색상을 설정할 수 있습니다.

로깅은 사후에 "실제로 무슨 일이 있었는지"에 답합니다. Vetox는 **148개의 서로 다른 이벤트**를 각각 독립적으로 설정하여 기록할 수 있습니다.

<Info>
  로깅은 무료입니다. 그 안의 세 가지 옵션 — 조치 수행자 표시, 웹훅 게시, 일괄 설정 도구 — 은 **Basic**이 필요합니다.
</Info>

## 화면

**All**과 14개 카테고리를 포함하는 탭 스트립이 있으며, 각 탭에는 활성화된 이벤트 수가 표시됩니다. 모든 탭에는 검색창과 활성 이벤트 실시간 카운트가 있습니다.

<CardGroup cols={3}>
  <Card title="Server" icon="server" />

  <Card title="Moderation" icon="gavel" />

  <Card title="Messages" icon="message" />

  <Card title="Channels" icon="hashtag" />

  <Card title="Roles" icon="user-tag" />

  <Card title="Emote Zone" icon="face-smile" />

  <Card title="Voice" icon="microphone" />

  <Card title="Threads" icon="comments" />

  <Card title="Events" icon="calendar" />

  <Card title="AutoMod" icon="filter" />

  <Card title="Stage" icon="podium" />

  <Card title="Webhooks" icon="link" />

  <Card title="Integrations" icon="plug" />

  <Card title="Giveaways" icon="gift" />
</CardGroup>

<Warning>
  **네 개의 배틀 패스 로그 이벤트는 카테고리가 없습니다.** 티어 해제, 시즌 시작, 시즌 종료, 퀘스트 완료는 존재하고 작동하지만 **All** 탭을 통해서만 접근 가능합니다 — 어떤 카테고리 탭에도 포함되지 않습니다.

  다른 몇 개 이벤트도 번역된 이름 없이 표시됩니다.
</Warning>

## 이벤트 구성

모든 이벤트는 **기본 꺼짐**이며 자체 설정을 가집니다.

| 설정                    | 기본값     | 참고                                 |
| --------------------- | ------- | ---------------------------------- |
| **Enabled**           | 꺼짐      |                                    |
| **Destination**       | Channel | 채널과 웹훅 사이 전환                       |
| **Log Channel**       | 없음      | 항목이 게시되는 곳                         |
| **Webhook URL**       | 없음      | Discord 웹훅 URL이어야 함. **Basic 등급**  |
| **Log Color**         | 기본 파란색  | 임의 16진수 색                          |
| **Disabled Channels** | 없음      | 특정 채널 제외. **9개 Messages 이벤트에만 존재** |
| **Show Executor**     | 꺼짐      | 조치 수행자 포함. **Basic 등급**            |

<Warning>
  **채널과 웹훅은 상호 배타적입니다.** 하나를 설정하면 다른 하나가 지워집니다. 같은 이벤트를 둘 다로 보낼 수 없습니다.
</Warning>

<Warning>
  Starter에서는 **Show Executor**와 **Webhook URL**이 **저장 시 조용히 초기화됩니다** — 오류도, 경고도 없고 값이 그냥 되돌아갑니다.

  이 두 설정이 유지되지 않는다면 이 때문입니다. 이벤트의 다른 모든 설정은 정상적으로 저장됩니다.
</Warning>

<Note>
  **Disabled Channels** 제외는 메시지 이벤트에만 존재합니다. 음성, 역할, 조정 이벤트에는 채널별 제외가 없습니다.
</Note>

## 많은 이벤트를 한번에 설정하기

148개 이벤트를 개별 설정하는 것은 비현실적이므로 **Manage Logs**가 채널을 생성하고 이벤트를 대량으로 연결합니다. **Basic**이 필요합니다.

| 모드                      | 결과                       |
| ----------------------- | ------------------------ |
| **Individual Channels** | 이벤트당 별도 채널               |
| **Category**            | Logs 카테고리 아래 카테고리당 채널 하나 |

생성 채널을 볼 수 있는 역할과 제외할 채널도 선택합니다. 생성 채널은 `@everyone`을 거부하고 지정한 역할만 허용합니다.

대화 상자는 채널 생성, 로그 할당, 권한 설정, 예외 적용의 진행 상황을 보고합니다.

<Tip>
  **Category 모드가 거의 항상 올바른 선택입니다.** 광범위한 선택에서 Individual 모드는 매우 많은 채널을 생성합니다 — 최대 148개.
</Tip>

## 저장

실제로 변경한 이벤트만 전송되므로 단일 토글 저장이 전체 구성을 다시 쓰지 않습니다.

<Note>
  [대시보드 워처](/ko/server-management/dashboard-watcher)는 로깅에 대해 **활성화 및 비활성화 조치만** 기록합니다. 채널, 웹훅, 색상 변경은 올바르게 저장되지만 감사 기록이 남지 않습니다.
</Note>

## 무엇을 로깅할지 선택

<AccordionGroup>
  <Accordion title="조정과 서버 이벤트로 시작" icon="star">
    실제로 돌아와 읽게 되는 것들입니다.
  </Accordion>

  <Accordion title="메시지 이벤트는 양이 많습니다" icon="triangle-exclamation">
    활발한 대형 서버에서 편집/삭제 로깅은 엄청난 양을 생성합니다. 비활성 채널 옵션으로 가장 바쁜 채널을 제외하세요 — 그것이 가능한 유일한 카테고리입니다.
  </Accordion>

  <Accordion title="음성 이벤트는 보기보다 시끄럽습니다" icon="volume-high">
    멤버의 음성 입퇴장은 지속적인 항목을 생성합니다. 특별히 필요할 때만 로깅하세요.
  </Accordion>

  <Accordion title="웹훅은 채널 변경에도 살아남습니다" icon="link">
    웹훅 대상은 채널 이름 변경이나 이동에도 계속 작동하며, 봇이 그곳에서 전송 권한이 없어도 게시됩니다. Basic이 필요합니다.
  </Accordion>
</AccordionGroup>

## 문제 해결

<AccordionGroup>
  <Accordion title="아무것도 로깅되지 않아요">
    [서버 설정](/ko/server-management/setup)에서 로깅이 켜져 있는지, 그런 다음 특정 이벤트가 활성화되어 대상이 있는지 확인하세요.
  </Accordion>

  <Accordion title="Show Executor가 계속 스스로 꺼져요">
    Basic이 필요하며 하위 등급에서는 조용히 초기화됩니다.
  </Accordion>

  <Accordion title="웹훅을 설정했는데 채널로 돌아갔어요">
    같은 원인 — 웹훅 대상은 Basic이 필요합니다.
  </Accordion>

  <Accordion title="배틀 패스 로그 이벤트를 찾을 수 없어요">
    카테고리 탭이 없습니다. All 탭에서 검색하세요.
  </Accordion>

  <Accordion title="이벤트에 이름이 없거나 이상해요">
    소수의 이벤트가 표시 이름 없이 배포됩니다. 이벤트 자체는 정상 작동합니다.
  </Accordion>
</AccordionGroup>

## 관련

<CardGroup cols={2}>
  <Card title="대시보드 워처" icon="desktop" href="/ko/server-management/dashboard-watcher">
    Discord가 아닌 대시보드에서 변경 사항을 추적합니다.
  </Card>

  <Card title="조정 도구" icon="gavel" href="/ko/moderation/moderation-tools">
    현재 적용 중인 처벌을 검토하고 해제합니다.
  </Card>
</CardGroup>