스튜디오 연홍 문서

테마

/정보 — 봇 상태 확인하기 ​

/정보 는 봇이 지금 정상적으로 돌고 있는지, 얼마나 오래 켜져 있었는지, 응답이 얼마나 빠른지를 한 장의 카드로 보여줘요. "봇이 이상한데 나만 그런가?" 를 확인할 때 가장 먼저 쓰는 명령어입니다.

이 페이지에서는 카드의 각 줄이 무슨 뜻인지, 어떤 값을 보고 문제를 판단하면 되는지, 그리고 문의할 때 무엇을 함께 보내면 좋은지 알려드려요.

먼저 알아둘 것 — 이 카드는 공개로 나갑니다 ​

WARNING

설정이나 멤버십 명령은 실행한 본인에게만 보이지만, /정보 는 명령을 실행한 채널에 모두가 보는 메시지로 남아요. 맨 아래에 요청자 <내 이름> 이 붙어서 누가 실행했는지도 함께 보입니다. 조용한 채널에서는 방해가 될 수 있으니, 봇 전용 채널처럼 편한 곳에서 실행해 주세요. 이미 올렸다면 메시지를 지울 수 있는 사람이 지워야 합니다. /들어와 · /나가 · /스킵 의 성공 안내도 같은 방식으로 채널에 남아요.

카드 전체 모습 ​

text
## 연홍봇 정보
연홍 TTS 시스템이 **정상 작동** 중이에요  ·  업타임: `3 days, 4:21:07`

**서비스 현황**
> 길드: `1,234`  ·  보이스: `87`  ·  레이턴시: `42ms`

**봇 서버 상태**
> CPU: `18%` ▰▱▱▱▱▱▱▱▱▱
> MEM: `43%` (6.9G / 16.0G)

**음성 노드**
> Nodes: `4/4`

요청자 사용자이름#0000

카드 아래에는 링크 버튼 세 개가 붙습니다.

한 줄씩 읽기 ​

줄무슨 값인가
업타임봇이 마지막으로 켜진 뒤 지난 시간
길드연홍이 들어가 있는 서버 수
보이스지금 음성 채널에 연결되어 있는 수
레이턴시봇과 Discord 사이의 응답 속도
CPU · MEM봇이 돌아가는 서버의 사용률
Nodes음성 재생에 쓸 수 있는 수 / 전체 수

맨 윗줄 — 봇 이름과 업타임 ​

연홍 TTS 시스템이 정상 작동 중이에요 의 앞부분은 이 서버에서 봇에게 붙은 별명이에요. 서버 언어에 맞춰 봇이 스스로 별명을 바꾸기 때문에, 서버마다 연홍 / Yeonhong / ヨンホン 으로 다르게 보일 수 있습니다.

NOTE

이 문장은 "봇이 명령을 받아 답할 수는 있다" 는 뜻이에요. 세부 상태는 아래 레이턴시 와 Nodes 줄로 판단해 주세요.

업타임은 3 days, 4:21:07 처럼 표시됩니다. 같은 시각에 다른 사람이 /정보 를 실행하면 다른 값이 나올 수 있어요. 업타임이 짧다고 곧바로 장애는 아니고, 봇이 방금 다시 켜진 직후라면 자연스럽게 짧게 나옵니다.

서비스 현황 — 길드 · 보이스 · 레이턴시 ​

  • 길드 — 연홍이 들어가 있는 서버 수입니다.
  • 보이스 — 지금 음성 채널에 연결되어 있는 수입니다.
  • 레이턴시 — 봇과 Discord 사이의 응답 지연이고, 밀리초(ms) 단위입니다.

레이턴시가 수백 ms 를 넘어가면 명령 반응이나 TTS 시작이 눈에 띄게 느려져요. 100ms 안팎이면 평범한 값입니다.

NOTE

길드와 보이스 숫자는 1분 정도 늦게 반영돼요. 방금 봇을 초대했거나 방금 음성 채널에서 나갔다면 아직 이전 숫자가 보일 수 있습니다. 가끔 평소보다 훨씬 작은 숫자가 나올 때도 있는데, 잠시 뒤 다시 실행하면 원래 값으로 돌아옵니다.

봇 서버 상태 — CPU · MEM ​

봇이 돌아가는 서버의 사용률이에요.

  • CPU: 18% ▰▱▱▱▱▱▱▱▱▱ — 막대는 10칸이고 10% 마다 한 칸이 찹니다.
  • MEM: 43% (6.9G / 16.0G) — 괄호 안은 사용 중 / 전체 메모리입니다.

참고용 값이라서, 이 숫자가 높다고 해서 내가 겪는 문제의 원인이라고 볼 수는 없어요. 한 번 더 실행하면 다른 숫자가 나오기도 합니다.

음성 노드 — Nodes: 4/4 ​

음성 재생에 쓰이는 설비 중 지금 쓸 수 있는 수(왼쪽)와 전체 수(오른쪽)예요.

표시뜻
4/4모두 정상입니다
3/4하나가 빠져 있습니다. 소리가 잠깐 끊길 수 있습니다
0/4음성 재생이 전부 불가능한 상태입니다

WARNING

왼쪽 숫자가 오른쪽보다 작으면 음성이 끊기거나 /들어와 가 실패할 수 있어요. 봇이 남은 곳으로 자동으로 옮겨 붙는 동안 소리가 잠시 멈추고, 봇이 들어와 있던 채널에 ⚠️ 음성 노드 자동 이전 안내가 올라옵니다. 이럴 때는 잠시 기다린 뒤 /들어와 로 다시 불러 주세요. 계속 같은 증상이면 Nodes 값과 함께 공식 서버에 알려 주시면 됩니다.

맨 아랫줄 — 요청자 ​

명령을 실행한 사람의 이름이 작게 붙어요. 카드가 공개 메시지라서 누가 실행했는지 채널의 모두가 보게 됩니다.

아래 버튼 세 개 ​

버튼하는 일
서버 상태연홍 공식 상태 페이지를 새 창으로 엽니다
공식 서버연홍 공식 Discord 서버 초대 링크를 엽니다
공식 문서공식 안내 문서를 엽니다

세 버튼 모두 단순한 링크예요. 눌러도 봇에 아무 요청이 가지 않으니 몇 번 눌러도 괜찮습니다.

카드에 적힌 숫자는 실행한 그 순간의 값이라 시간이 지나도 저절로 갱신되지 않아요. 최신 값을 보려면 /정보 를 다시 실행해 주세요. 링크 버튼은 오래된 카드에서도 계속 동작합니다.

이 카드로 알 수 없는 것 ​

/정보 는 봇 전체의 상태를 보여 주는 카드이지, 내 계정이나 이 서버의 설정을 보여 주지는 않아요.

알고 싶은 것보는 곳
내 멤버십·잔액/멤버십 확인
내 목소리·피치·속도/유저 설정
봇이 이 채널의 글을 읽는지서버 관리자에게 채널 설정 확인 요청
봇이 지금 이 서버의 음성 채널에 있는지음성 채널 참가자 목록에서 직접 확인

문제를 알릴 때 함께 보내면 좋은 값 ​

공식 서버에 문의할 때 /정보 카드를 캡처해서 보내 주시면 확인이 빨라져요. 특히 아래 세 가지가 중요합니다.

  1. Nodes 값 — 음성이 안 나올 때 가장 먼저 봅니다.
  2. 레이턴시 — 반응이 느릴 때의 근거가 됩니다.
  3. 업타임 — 봇이 방금 다시 켜진 직후인지 알 수 있습니다.

관련 문서 ​