홈 개요
대시보드에 로그인하고 프로젝트를 선택하면 가장 먼저 보이는 화면입니다. 핵심 지표를 한눈에 파악할 수 있습니다.
KPI 탭
홈 상단에는 6개의 KPI 탭이 있으며, 각 탭을 클릭하면 해당 메트릭의 스파크라인 차트가 아래에 표시됩니다.
| 탭 | 메트릭 | 설명 |
|---|---|---|
| 상호작용 | interactions | 슬래시 명령어, 버튼, 셀렉트 등 전체 상호작용 건수 |
| 작업 | actions | 메시지 전송, 역할 부여 등 봇의 REST API 작업 건수 |
| 이벤트 | discord_events | 멤버 입퇴장, 메시지 생성 등 게이트웨이 이벤트 건수 |
| 고유 사용자 | unique_users | 기간 내 상호작용한 고유 사용자 수 (HLL 근사치, +-2%) |
| 서버 | guild_count | 봇이 현재 참여 중인 서버 수 |
| 오류 | errors | command_error + error 이벤트 건수 |
각 탭에는 **이전 기간 대비 변화율(delta %)**이 함께 표시됩니다. 양수는 증가, 음수는 감소를 나타냅니다. 이전 기간은 선택한 기간과 동일한 길이입니다 (예: 최근 7일 선택 → 그 전 7일과 비교).
참고
고유 사용자 수 옆에는 "근사치" 뱃지가 표시됩니다. 이 수치는 HyperLogLog 알고리즘으로 추정된 값이므로 소규모 봇에서는 정확한 값과 차이가 있을 수 있습니다. 자세한 내용은 메트릭과 차원을 참고하세요.
실시간 스파크라인
선택한 KPI 탭에 따라 시계열 스파크라인 차트가 표시됩니다. 기간 선택기를 변경하면 차트의 시간 범위도 함께 갱신됩니다.
- 오늘/어제: 시간 단위 차트
- 7일/30일: 일 단위 차트
- 90일: 일 단위 차트 (넓은 범위)
봇 상태 카드
홈 화면에는 봇의 현재 상태를 요약하는 카드가 표시됩니다.
| 항목 | 설명 |
|---|---|
| 온라인/오프라인 | 마지막 하트비트 수신 시각 기준 |
| WebSocket 핑 | 게이트웨이 지연 (ms) |
| 메모리 사용량 | 프로세스 RSS 메모리 (MB) |
| 서버 수 | 캐시된 서버 수 |
| 음성 연결 | 활성 음성 연결 수 |
| 샤드 | 온라인 샤드 수 / 전체 샤드 수 |
참고
마지막 하트비트 이후 2분 이상 경과하면 "오프라인"으로 표시됩니다. 봇이 실행 중인데 오프라인으로 표시된다면, SDK가 올바르게 연결되었는지 시작하기를 확인하세요.
SDK 버전 경고
SDK 버전이 최신이 아닌 경우 홈 화면 상단에 업데이트 안내 배너가 표시됩니다. 배너에는 현재 버전과 최신 버전이 함께 표시되며, 업데이트 방법 링크가 포함됩니다.
버전 확인 방식
SDK는 매 하트비트에 sdk.version 필드를 포함합니다. 서버가 최신 버전과 비교하여 업데이트가 필요하면 대시보드에 경고를 표시합니다. SDK 동작에는 영향을 주지 않습니다.
기간 선택
상단의 기간 선택기로 분석 범위를 지정합니다.
| 프리셋 | 범위 |
|---|---|
| 오늘 | 오늘 00:00부터 현재까지 |
| 어제 | 어제 00:00 ~ 23:59 |
| 최근 7일 | 지금부터 7일 전까지 |
| 최근 30일 | 지금부터 30일 전까지 |
| 최근 90일 | 지금부터 90일 전까지 |
| 사용자 정의 | 달력에서 시작/종료 날짜 선택 |
기간을 변경하면 페이지의 모든 KPI 카드, 차트, 테이블이 갱신됩니다.
즐겨찾기
자주 확인하는 보고서를 즐겨찾기에 추가할 수 있습니다. 보고서 페이지 상단의 별 아이콘을 클릭하면 사이드바 상단의 즐겨찾기 섹션에 추가됩니다. 홈 화면에서도 즐겨찾기된 보고서에 빠르게 접근할 수 있습니다.
SDK 연결 전
아직 SDK에서 이벤트를 수신하지 못한 경우, 대시보드 대신 온보딩 화면이 표시됩니다.
- SDK 설치 안내
- API 키 복사 버튼
- 코드 예시
- "이벤트 수신 대기" 상태 (첫 하트비트 도착 시 자동 완료)
시작하기 가이드를 따라 SDK를 연결하세요.
관련 문서
- 보고서 -- 카테고리별 상세 보고서
- 탐색(Explore) -- 커스텀 쿼리 분석
- 상태 페이지 -- 샤드별 실시간 상태
- 메트릭과 차원 -- 각 메트릭의 의미와 계산 방식