본문으로 건너뛰기

가이드

로그 설정하기

로그 채널은 SfwBot이 무엇을 왜 처리했는지 모더레이터에게 알려 주는 곳이에요. 로그는 기본으로 켜져 있지만 채널을 고르기 전에는 아무것도 올라오지 않아요. 각 항목에는 결정을 되돌리거나 멤버에게 조치할 수 있는 버튼이 있어요.

시작하기 전에

모더레이터만 볼 수 있는 채널을 고르거나 새로 만드세요. 로그 항목에는 멤버 이름이 표시되고 삭제된 미디어로 연결되는 링크가 포함될 수 있으므로 공개 채널이면 안 돼요.

SfwBot에는 해당 채널에서 채널 보기와 메시지 보내기 권한이 필요해요. 채널을 운영진 역할로 제한했다면 봇의 역할도 추가하세요.

기능 개요는 로깅에서 확인하세요.

대시보드에서 설정하기

로그 옵션과 기본값은 [설정 참고 문서](/docs/settings)에 정리돼 있어요.

  1. 로깅 열기

    대시보드에서 서버를 열고 로깅으로 이동하세요.

  2. 채널 선택하기

    로그 채널에서 로그 메시지 게시를 켜 두고 채널을 고르세요. 봇에게 필요한 권한이 없으면 페이지에 안내가 표시돼요.

  3. 미디어 포함 여부 정하기

    로그 메시지에 미디어 포함을 켜면 삭제된 이미지나 동영상이 항목에 함께 올라와서 모더레이터가 직접 판단할 수 있어요. 모더레이터가 해당 콘텐츠를 다시 보지 않아야 한다면 꺼 두세요.

  4. 저장하고 테스트 메시지 보내기

    변경 사항 저장을 누른 뒤 테스트 메시지를 사용하세요. 실제 항목과 같은 방식으로 보낸 짧은 메시지가 로그 채널에 나타나요.

  5. 언어 설정하기

    로그 항목은 서버 언어로 표시돼요. 서버의 Discord 언어와 다르게 하려면 일반에서 바꾸세요.

`/settings` 명령어

/settings에는 로깅 페이지가 있어요. 여기서 로그 채널을 고르고, 미디어 미리보기를 켜거나 끄고, 로깅을 끌 수 있어요. 채널을 고르면 봇이 그 채널의 권한을 확인하고 부족한 것을 알려 줘요. 이 명령어에는 서버 관리 권한이 필요해요.

/setup 마법사는 첫 단계에서 로그 채널을 물어봐요. 시작하기와 명령어 참고 문서를 참고하세요.

기록되는 내용

  • 삭제된 미디어

    노출 감지나 블랙리스트에 걸려 차단된 모든 이미지, GIF, 동영상이 감지된 등급과 함께 기록돼요.

  • 초대

    초대 필터가 삭제한 메시지예요.

  • 스팸

    스팸 필터가 삭제한 메시지이며, 작동한 검사도 함께 표시돼요.

  • 차단된 링크

    링크 보호가 찾아낸 링크예요. 메시지가 삭제되었는지와 관계없이 기록돼요.

  • AutoMod

    SfwBot이 관리하는 AutoMod 규칙에 걸려 차단된 메시지예요.

  • 신뢰 점수와 스트라이크

    멤버의 신뢰 점수 변동과 모든 스트라이크가 기록돼요. 신뢰 점수와 스트라이크를 참고하세요.

  • 권한 문제

    권한이 없어서 봇이 메시지를 삭제하지 못했을 때 올라오는 알림이에요.

  • 크레딧 알림

    크레딧이 부족해질 때의 경고와 모두 소진되었을 때의 알림이에요.

로그 항목에서 조치하기

로그 항목에는 버튼이 있어서 모더레이터가 채널을 벗어나지 않고 바로 조치할 수 있어요.

버튼기능
오탐 신고모델이 잘못 삭제한 건을 SfwBot 팀에 보내 검토를 요청해요
이 서버에서 허용이미지를 허용 목록에 추가해요
블랙리스트에서 제거잘못 일치한 이미지를 블랙리스트에서 빼요
메시지 삭제자동 삭제가 꺼져 있을 때 메시지를 삭제해요
타임아웃, 추방, 차단확인을 거친 뒤 멤버에게 조치해요
되돌리기신뢰 점수 위반과 그로 인한 스트라이크를 취소해요

모든 버튼에는 서버 관리 권한이 필요해요. 타임아웃, 추방, 차단은 모더레이터에게 해당 Discord 권한(멤버 타임아웃, 멤버 추방, 멤버 차단)이 있어야 하고 멤버의 가장 높은 역할보다 높은 역할이 있어야 해요. 봇도 같은 권한과 멤버보다 높은 역할이 필요해요. 서버 소유자에게는 이 방법으로 타임아웃, 추방, 차단을 할 수 없어요.

삭제 전에 먼저 검토하고 싶다면 노출 감지에서 자동 삭제를 끄세요. 그러면 항목이 결과를 알리는 대신 결정을 요청해요.

대시보드의 활동 로그

대시보드의 활동 로그 페이지에서는 서버에서 일어난 일을 목록으로 볼 수 있고, 이벤트 종류, 기간, 채널로 필터링할 수 있어요. 설정 변경도 기록되므로 누가 무엇을 바꿨는지 확인할 수 있어요.

활동 로그는 로그 채널 없이도 사용할 수 있어요. 하지만 로그 채널을 대신하지는 않아요. 일이 일어나는 즉시 모더레이터에게 전달되는 것은 로그 채널뿐이에요.

로그 데이터 보관 기간

로그 채널의 메시지는 직접 삭제하기 전까지 그대로 남아요. 일반 Discord 메시지이기 때문이에요.

SfwBot이 멤버의 메시지에서 직접 저장하는 정보, 즉 미디어 링크, 지문, 삭제 사유는 30일 후에 삭제돼요. 보안 및 개인정보를 참고하세요.

문제 해결

  • 아무것도 올라오지 않아요. 로그 채널이 설정되지 않았어요. 이 경우 대시보드 개요와 각 모듈 페이지에 경고가 표시돼요.
  • 봇이 채널에 글을 올릴 수 없어요. 해당 채널에서 채널 보기와 메시지 보내기 권한을 주세요. 로깅 페이지와 /status에서 부족한 권한을 확인할 수 있어요.
  • 로그 채널이 삭제되었어요. 로깅 페이지에 안내가 표시돼요. 새 채널을 고르세요.
  • 항목에 미디어가 없어요. 로그 메시지에 미디어 포함이 꺼져 있거나, 텍스트 필터에 관한 항목이에요.
  • 버튼이 작동하지 않거나 오류가 표시돼요. 서버 관리 권한이 필요해요. 타임아웃, 추방, 차단에는 해당 Discord 권한과 멤버보다 높은 역할도 필요하고, 봇에게도 마찬가지로 필요해요.
  • 항목이 다른 언어로 표시돼요. 일반에서 서버 언어를 설정하세요.

자주 묻는 질문

로그 채널을 둘 이상 쓸 수 있나요?

아니요. 서버에는 모든 모듈이 함께 쓰는 로그 채널이 하나 있어요. AutoMod는 Discord가 자체 알림을 올리는 별도의 알림 채널을 써요.

멤버도 로그를 볼 수 있나요?

채널을 볼 수 있는 멤버만 볼 수 있어요. 모더레이터만 접근하도록 제한하세요.

로그 채널이 없어도 봇이 조치하나요?

네. 메시지는 그대로 삭제돼요. 다만 모더레이터에게 알림이 가지 않을 뿐이에요.