서버 관리
서버 로그
개요
서버 구석구석에 CCTV를 달아두는 기능입니다. 멤버 입장·퇴장·닉네임 변경부터 채널·메시지 활동까지, 서버에서 일어나는 거의 모든 일을 지정 채널에 CV2로 자동 기록합니다.
입장 로그는 대시보드에서만 설정합니다 — 로그 탭 맨 위의 입장 카드에서 보낼 채널 · 멘트와 카드 모양(색 · 제목 · 그림 · 바닥글 · 링크 버튼)을 고치고, 미리보기와 시험 보내기로 확인합니다.
/로그 설정을 실행하면 현재 설정 현황이 담긴 패널이 채널에 공개로 전송되며, 누구나 모니터 화면(현황판)은 볼 수 있지만 버튼 조작(채널 설정·멘트 편집, 즉 카메라 방향 조정)은 관리자만 가능합니다. 웹 대시보드의 로그 탭에서도 동일한 항목을 관리할 수 있으며, 봇 쪽(디스코드)에서 값이 바뀌어도 대시보드 화면이 15초 내로 자동 반영됩니다.입장 로그는 대시보드에서만 설정합니다 — 로그 탭 맨 위의 입장 카드에서 보낼 채널 · 멘트와 카드 모양(색 · 제목 · 그림 · 바닥글 · 링크 버튼)을 고치고, 미리보기와 시험 보내기로 확인합니다.
/로그 설정 패널의 입장 줄에는 지금 상태와 대시보드 바로가기만 나옵니다. 이미 켜 둔 입장 로그는 그대로 같은 모양으로 계속 올라갑니다.명령어
/로그 설정로그 설정 패널 열기 (채널·유형별 버튼으로 조작)
기록 이벤트
| 이벤트 | 기록 내용 |
|---|---|
| 입장 | 입장한 유저 · 관리자가 설정한 멘트 — 카드 모양 · 그림은 대시보드 「입장 카드」에서 꾸밈 |
| 🚪 퇴장 | 퇴장한 유저 · 멘트 템플릿 |
| ✏️ 닉네임 변경 | 대상 유저 · 이전 닉네임 → 이후 닉네임 |
| 📺 채널로그 | 음성입퇴장/이동을 포함해, 모든 채널 유형의 생성·이름변경·권한변경 |
| 💬 메시지로그 | 메시지 삭제 및 수정 |
항목별 끄기
퇴장·닉네임 변경·채널로그·메시지로그는 채널이 설정되어 있을 때만 설정 패널에 끄기 버튼이 나타나며, 눌러서 개별적으로 언제든 비활성화할 수 있습니다 — 복도별 카메라를 하나씩 끄는 셈입니다. 웹 대시보드의 로그 탭에서 채널을 비워 저장해도 동일하게 해제됩니다. 입장 로그는 대시보드 「입장 카드」에서 보낼 채널을 보내지 않음으로 바꿔 끕니다.
입장 카드 꾸미기 (대시보드)
로그 탭 맨 위 입장 카드에서 누가 들어올 때 올라가는 카드를 꾸밉니다. 아무것도 바꾸지 않으면 예전 입장 로그와 똑같이 보이고, 「기본 모양으로」를 누르면 언제든 그 모양으로 돌아갑니다.
| 항목 | 설명 |
|---|---|
| 보낼 채널 | 카드가 올라갈 채널 — 「보내지 않음」이면 입장 로그가 꺼집니다 |
| 카드 색 · 제목 | 카드 왼쪽 선 색과 맨 위 제목(비우면 제목 없이) |
| 멘트 | 카드 본문 — {user} {mention} {id} {server} {memberCount} 함수와 디스코드 문법을 그대로 씁니다. {mention}을 넣으면 들어온 사람에게 알림이 갑니다 |
| 모양 | 「👤 대상 사용자」 줄(닉네임 · 아이디 · ID — 멘션 아님)과 「📝 알림 메시지」 머리를 켜고 끕니다 |
| 그림 | 오른쪽 작은 그림(없음 · 유저 프로필 · 서버 아이콘 · 내 이미지)과 멘트 아래 큰 그림(내 이미지) — PNG · JPG · GIF · WebP · BMP, 5MB까지(권장: 작은 그림 256 × 256 이상 정사각형 · 큰 그림 1200 × 400) |
| 바닥글 · 링크 버튼 | 카드 맨 아래 작은 글씨와 링크 버튼 최대 3개 |
입장 카드 그림
- 입장이 몰려도 무겁지 않게, 올린 그림은 작은 그림 320 · 큰 그림 1200 안으로 줄여 둡니다. 움직이는 GIF는 움직임을 지키고, 너무 크면 첫 장면만 남깁니다.
- 올린 그림은 해나봇 서버에 암호화(AES-256-GCM)해 보관하고, 카드에 쓰지 않는 그림은 올린 지 12시간이 지나면 지웁니다.
- 해나봇에게 그 채널의 파일 첨부 권한이 없으면 올린 그림은 빼고 보냅니다(유저 프로필 · 서버 아이콘은 그대로).
- 시험 보내기는 저장하지 않은 지금 모양을 대시보드를 쓰는 본인을 대상으로 고른 채널에 한 번 보냅니다(5초에 한 번).
채널로그 상세
텍스트·음성·카테고리·공지·스레드(공개/비공개/공지)·포럼·스테이지 등 모든 채널 유형의 활동을 디스코드 감사 로그 기반으로 감지합니다 — 건물 복도 전체에 카메라가 달린 셈이라 사각지대가 거의 없습니다. 과거의 "음성채널 로그"(음성채널 자동 생성 문서 참고)를 완전히 대체·확장한 항목입니다.
- 채널 생성 — 생성자(닉네임+ID)와 채널 유형·생성 시각을 함께 표시.
/음성채널생성트리거로 자동 생성된 개인 채널도 감사 로그상 봇이 아닌 실제 이용자가 생성자로 정확히 표시됩니다 — CCTV가 "방 키를 발급한 건 호텔 직원이 아니라 투숙객 본인"이라고 정확히 찍어주는 셈입니다. - 이름 변경 — 감사 로그 기반 수정자 + "이전 이름 → 새 이름"
- 권한 변경 — 채널 권한(permission overwrite) 추가·수정·삭제 시 수정자
- 음성채널 입장·퇴장·이동은 기존과 동일하게 실시간으로 함께 기록됩니다.
메시지로그 상세
메시지 삭제와 수정을 함께 다룹니다(과거 "메시지 삭제 로그"에서 명칭·범위가 통합·확장됨) — 누가 무슨 말을 썼다 지웠는지, 뭘 고쳤는지까지 전부 되감아볼 수 있는 녹화 영상입니다.
- 삭제 — 작성자 · 삭제 전 원본 내용 · 삭제를 실행한 사람(관리자 삭제 시 감사 로그로 추적, 작성자 본인 삭제는 Discord 사양상 "본인 삭제로 추정" 표시)
- 수정 — 수정자 · 이전 내용 → 변경된 내용 · 수정 시각
- 봇이 보낸 메시지의 편집(설정 패널 갱신 등)이나, 링크 미리보기만 갱신되는 경우(임베드 언퍼닝)는 기록하지 않습니다 — 카메라가 조명 깜빡임까지 전부 녹화하진 않는 것과 같습니다.
메시지 대량 삭제
한 번에 여러 메시지가 삭제되면(예: 관리자의 메시지 일괄 삭제) 개별 전송 대신 요약 1건만 채널에 전송합니다 — CCTV도 똑같은 장면이 수백 번 찍히면 요약 리포트 한 장으로 정리해주는 셈입니다. 삭제 실행자와 삭제된 메시지 개수가 표시되며, 개별 메시지 내용은 로컬 백업 로그 파일(녹화 원본 테이프)에서 확인할 수 있습니다.
로컬 백업 로그
모든 이벤트는 Discord 채널 설정 여부와 무관하게 서버(길드)별로 독립된 백업 파일(별도 보관함)에도 항상 기록됩니다 — Discord 로그 채널을 설정하지 않았거나 메시지 전송이 실패해도, CCTV 원본 테이프는 어딘가에 계속 쌓이고 있는 셈이라 데이터가 유실되지 않습니다.
- 하루 단위 파일로 분리 저장, 자정이 지난 파일은 자동으로 압축됩니다 — 어제자 테이프는 창고로 넘기는 셈입니다.
- 생성일 기준 1년이 지난 백업 파일은 자동으로 삭제됩니다 — 창고도 무한정은 아니니까요.
파트너 서버