서버 로그는 서버에서 일어나는 모든 일을 추적하고 기록해요. Discord에서는 서식이 적용된 임베드로, 패널에서는 검색할 수 있는 항목으로 남습니다.
모든 설정은 패널에서 해요. 슬래시 명령어로 설정할 것은 없어요.
📋 기록되는 내용
서버 로그는 독립적인 10개 카테고리로 나뉘어 있어요. 원하는 것만 활성화하세요.
| 카테고리 | 추적하는 내용 |
|---|---|
| 👥 멤버 | 참가, 탈퇴, 밴, 밴 해제, 킥, 닉네임 변경, 역할 변경 |
| 💬 메시지 | 수정, 삭제, 일괄 삭제, 고정 |
| 📁 채널 | 생성, 삭제, 이름 변경, 주제, 슬로우 모드, NSFW, 카테고리, 그리고 권한 덮어쓰기(허용됨, 거부됨, 더 이상 허용되지 않음, 더 이상 거부되지 않음처럼 변화 하나하나를 구분해서 이름을 붙여요) |
| 🎭 역할 | 생성, 삭제, 이름 변경, 권한과 색상 변경 |
| 🎙️ 음성 | 참가, 퇴장, 채널 간 이동, 헤드셋 끄기, 뮤트, 스트림 시작/종료 |
| 🏠 서버 | 이름, 아이콘, 설명, 인증 수준, 배너, AFK / 시스템 / 규칙 / 모더레이터 채널, 그리고 소유자 변경, 콘텐츠 필터, 모더레이션에 필요한 2단계 인증 수준 |
| 🔗 초대 | 생성과 삭제, 초대의 전체 메타데이터 포함 |
| 😀 이모지 & 스티커 | 생성, 삭제, 이름 변경(이모지), 추가, 제거, 이름 또는 설명 변경(스티커) |
| 🤖 봇 | 서버에 봇이 추가됨 |
| 🔨 모더레이션 | 밴, 킥, 경고, 뮤트, 소프트밴, 밴 해제, 뮤트 해제 |
권한 변화 네 가지를 따로 이름 붙인 이유. 더 이상 허용되지 않음은 결정을 멤버의 역할에 돌려주는 것이고, 거부됨은 멤버에게서 결정권을 빼앗는 것이에요. 이 둘은 같은 이벤트가 아니고, 둘을 합쳐 버린 로그로는 어느 쪽이 일어났는지 알 수 없어요.
누군가 가장 먼저 약하게 만드는 두 가지 설정은 콘텐츠 필터와 모더레이션에 필요한 2단계 인증 수준이에요. 이제 두 가지 모두 전체 이름으로 표시돼요. 한 줄이 *"1 → 0"*이 아니라 *"Elevated → None"*으로 읽히고, 채널 설정에는 ID 대신 채널 이름이 표시돼요.
📡 로그 채널
각 카테고리는 독립적으로 활성화할 수 있고, 각자 전용 로그 채널을 지정할 수 있어요.
모든 것을 받아 주는 대체 채널로 단일 글로벌 로그 채널을 설정할 수도 있어요. 카테고리에 자체 채널이 없으면 그 이벤트는 글로벌 채널로 갑니다.
예시: 모더레이션 이벤트는 비공개
#mod-log로, 나머지는 모두 일반#server-log로 보내세요.
🙈 제외 규칙
노이즈를 줄이려면 이벤트를 로그에서 제외할 수 있어요.
- 채널 - 무시한 채널에서 일어난 이벤트는 절대 기록되지 않아요(봇 도배 채널이나 비공개 스태프 채널에 유용해요).
- 역할 - 무시한 역할을 하나라도 가진 멤버는 로그에서 제외돼요.
- 사용자 - 특정 Discord 사용자 ID를 제외해요.
🔎 로그 뷰어
저장된 이벤트는 로그 뷰어 탭에서 패널에서 바로 살펴볼 수 있어요.
다음 기준으로 필터링할 수 있어요.
- 카테고리(멤버, 메시지, 역할 등)
- 키워드(이벤트 유형, 행위자, 대상 전체에서)
- 행위자 ID / 대상 ID
- 날짜 범위(시작 / 종료)
결과는 페이지로 나뉘고, 현재 필터링된 보기를 JSON 파일로 내보낼 수 있어요.
저장은 기본적으로 활성화되어 있어요. 보존 기간은 기본 30일이며 최대 365일까지 설정할 수 있어요.
🔗 서버 로그와 모더레이션
모더레이션 기능이 활성화되어 있으면, 모더레이션 조치(밴, 킥, 경고, 뮤트, 그리고 그 해제)가 모더레이션 로그 카테고리로 자동으로 흘러가요. 추가 설정은 필요 없어요.
모더레이션 카테고리 카드에는 상태 배지가 표시돼요.
- 모더레이션 모듈에 연결됨 - 모더레이션 기능이 활성화되어 있고 조치가 자동으로 동기화돼요.
- 모더레이션 모듈이 활성화되지 않음 - 모더레이션 카테고리는 Discord 감사 로그가 알려 주는 것만 기록해요.
🔗 서버 로그와 다른 기능
모더레이션 조치를 취하는 다른 기능도 모더레이션 카테고리로 기록을 보내므로, 모든 것이 한곳에 모여요.
- Automod와 Anti-Raid 조치
- 허니팟 작동. 서버 로그에 모더레이션 채널이 설정되어 있으면 중복 항목을 피하기 위해 허니팟 자체의 로그 채널은 건너뛰어요.
👍 권장 설정
- 대체 채널로 글로벌 로그 채널을 설정하세요.
- 관심 있는 카테고리를 활성화하고, 민감한 카테고리(모더레이션, 멤버)는 각자의 비공개 채널을 주세요.
- 봇 도배나 시끄러운 연동에는 무시할 채널을 추가하세요.
- 나중에 기록을 검색할 수 있도록 저장을 켜 두세요.
💡 모범 사례
- 모더레이션 로그는 스태프 전용 채널로 보내세요.
- 아주 큰 서버에서는 모든 카테고리를 한꺼번에 기록하지 마세요. 실제로 검토하는 것만 고르세요.
- 보존 기간이 지난 뒤에도 기록을 보관하려면 뷰어의 내보내기를 사용하세요.
- 모더레이션 기능과 함께 사용해서 수동 조치와 자동 조치를 모두 기록하세요.