콘텐츠로 이동

통합 기능

← 이전 문서로

각 서버는 설정 그룹 아래에 통합 기능을 관리합니다: Discord, 공개 상태 페이지, 원클릭 초대, 그리고 선택 사항인 챗봇 탭(관리자 전용). 이 페이지는 Discord를 다룹니다. 초대 및 상태 페이지는 해당 두 가지를 다루고, 챗봇은 자체 페이지가 있습니다.

패널은 웹훅을 통해 서버 이벤트를 Discord 채널로 전달합니다. 봇이나 OAuth는 필요하지 않습니다.

  1. Discord에서: 서버 설정 → 통합 → 웹훅 → 새 웹훅. 채널을 선택하고 웹훅 URL을 복사합니다.
  2. 패널에서 서버의 설정 → Discord 탭을 열고, 웹훅 URL에 URL을 붙여넣은 다음, 카드를 켜기로 설정하고 저장합니다. URL은 암호화되어 저장됩니다(API 키와 동일한 저장소에).
  3. 테스트 보내기를 사용하여 작동하는지 확인합니다.

Discord 통합

저장된 URL을 교체하려면 새 URL을 붙여넣고 저장하십시오. 현재 URL을 유지하려면 필드를 비워 두십시오. 저장된 URL은 마스크 처리되어 표시됩니다(토큰은 숨겨짐).

알림은 전환 가능한 카테고리로 그룹화됩니다. 기본적으로 모두 켜져 있습니다.

카테고리 이벤트
시작 / 중지 서버 시작됨, 서버 중지됨
충돌 충돌, 충돌 루프 감지됨, 새 충돌 보고서
백업 백업 생성됨, 백업 복원됨
업데이트 업데이트 적용됨, 업데이트 롤백됨, 업데이트 실패됨
추방 / 차단 플레이어 추방됨, 플레이어 차단됨
경고 서버를 조용히 손상시키는 것들(아래 참조)

경고는 “사람의 손길이 필요한” 채널로, 이전에는 패널에서만 볼 수 있었던 조건에 대한 알림입니다:

이벤트 의미
oom 메모리 부족으로 컨테이너가 중지되었습니다.
unhealthy 프로세스는 실행 중이지만 mc-health 프로브가 실패하고 있습니다: 살아 있지만 죽은 서버입니다.
startup-stalled 로그에 “완료” 메시지가 없이 약 10분 동안 시작 중입니다(수정해야 할 사항에 대한 진단 포함, 알려진 경우).
stop-failed 정상적인 중지가 적용되지 않았고 컨테이너가 여전히 실행 중입니다.
schedule-failed 예약된 재시작 / 백업 / 명령이 실패했습니다.
quota-exceeded 엄격 모드 디스크 할당량이 초과되어 서버가 중지되었습니다.
offline-after-restart 패널 재시작 전에는 서버가 실행 중이었지만, 현재는 그렇지 않으며 자동 시작되지 않습니다.
port-change-failed 포트 변경이 실패하여 서버를 이전 포트로 되돌릴 수 없었으므로 다운되었습니다.
auto-restart-gave-up 충돌한 서버가 너무 오랫동안 다른 작업으로 인해 바빴기 때문에 재시작되지 않았습니다.

백그라운드 브리지가 15초마다 이벤트 로그를 폴링하고 매핑된 행을 전달합니다. 웹훅 POST가 일시적으로 실패하면 해당 행은 나중에 다시 시도되며 삭제되지 않습니다. 몇 번의 시도 후에도 실패하면 해당 행은 건너뛰고, 서버당 시간당 최대 한 번만 전달 실패가 기록됩니다. 패널 재시작 후 브리지는 아직 전달되지 않은 이벤트를 보내지만, 2시간 이상 이전의 이벤트는 보내지 않습니다. 첫 실행 시에는 가장 최신 이벤트부터 시작합니다.