탐색 (Explore)
정해진 보고서 대신, 메트릭과 차원을 자유롭게 조합하여 커스텀 쿼리를 실행하는 분석 도구입니다.
기본 사용법
탐색 화면은 4단계로 구성됩니다.
1단계: 메트릭 선택
분석할 수치를 선택합니다. 메트릭 셀렉터에서 검색하여 빠르게 찾을 수 있습니다.
| 메트릭 | 설명 |
|---|---|
interactions | 상호작용 건수 |
actions | 작업 건수 |
discord_events | 게이트웨이 이벤트 건수 (sum of count) |
events | 전체 이벤트 레코드 수 |
unique_users | 고유 사용자 수 (HLL 근사치) |
unique_guilds | 고유 서버 수 (HLL 근사치) |
errors | 오류 건수 |
avg_latency | 평균 응답 지연 (ms) |
p95_latency | P95 응답 지연 (ms) |
voice_sessions | 음성 세션 수 |
voice_minutes | 음성 총 시간 (분) |
messages_sent | 봇 발신 메시지 수 |
custom_events | 커스텀 이벤트 건수 |
전체 메트릭 목록과 계산 방식은 메트릭과 차원을 참고하세요.
2단계: 차원 선택
데이터를 나눌 기준을 선택합니다.
- 시간 차원 (
date,hour) 선택 시 → 라인 차트 (시계열) - 비시간 차원 (
command,guild_id등) 선택 시 → 가로 막대 차트 (랭킹)
3단계: 필터 추가
특정 조건으로 데이터를 제한합니다. 여러 필터를 AND로 조합할 수 있습니다.
4단계: 실행
실행 버튼을 클릭하면 결과가 차트와 테이블로 표시됩니다.
필터 빌더
다양한 연산자로 데이터를 정밀하게 필터링할 수 있습니다.
| 연산자 | 설명 | 예시 |
|---|---|---|
= | 같음 | event_type = interaction_slash |
!= | 같지 않음 | event_type != heartbeat |
contains | 포함 | command contains help |
gt | 초과 | latencyMs gt 1000 |
lt | 미만 | latencyMs lt 100 |
gte | 이상 | memberCount gte 1000 |
lte | 이하 | memberCount lte 100 |
between | 범위 | memberCount between 100,1000 |
props 필터링
커스텀 이벤트의 속성(props)도 props.* 필드로 필터링할 수 있습니다.
event_type = custom AND props.category = billing
→ billing 카테고리 커스텀 이벤트만 조회event_type = custom AND props.amount gt 1000
→ amount가 1000 초과인 커스텀 이벤트만 조회참고
props.* 필터는 문자열, 숫자, 불리언 값에 가장 잘 동작합니다. 중첩 객체나 배열은 필터링이 어려울 수 있으므로, track() 호출 시 평탄한(flat) 구조를 사용하세요.
쿼리 예시
명령어별 사용량 Top 10
| 설정 | 값 |
|---|---|
| 메트릭 | interactions |
| 차원 | command |
| 필터 | interaction_kind = slash |
참고
명령어 랭킹을 볼 때는 반드시 interaction_kind = slash 필터를 추가하세요. 필터 없이 조회하면 버튼의 정규화된 customId가 명령어와 섞입니다.
서버별 상호작용 수
| 설정 | 값 |
|---|---|
| 메트릭 | interactions |
| 차원 | guild_id |
| 필터 | (없음) |
일별 오류 추이
| 설정 | 값 |
|---|---|
| 메트릭 | errors |
| 차원 | date |
| 필터 | (없음) |
특정 커스텀 이벤트의 일별 추이
| 설정 | 값 |
|---|---|
| 메트릭 | custom_events |
| 차원 | date |
| 필터 | custom_event_name = purchase |
저장된 보고서
자주 사용하는 쿼리 조합을 저장된 보고서로 관리할 수 있습니다.
- 원하는 메트릭, 차원, 필터를 설정하고 실행합니다.
- 결과 화면에서 저장 버튼을 클릭합니다.
- 보고서 이름을 입력하고 저장합니다.
저장된 보고서는 탐색 화면의 사이드 패널에 목록으로 표시됩니다. 클릭하면 저장된 조건으로 바로 조회됩니다.
참고
저장된 보고서의 이름을 클릭하면 URL이 변경됩니다. 이 URL을 복사하여 팀원에게 공유할 수 있습니다.
URL 공유
탐색의 모든 조건(메트릭, 차원, 필터, 기간)은 URL 쿼리 파라미터에 직렬화됩니다. 현재 URL을 복사하여 공유하면 동일한 조건으로 바로 조회할 수 있습니다.
결과 해석
차트
- 시간 차원: 라인 차트로 추이를 확인합니다.
- 비시간 차원: 가로 막대 차트로 랭킹을 확인합니다.
테이블
차트 아래에 상세 데이터 테이블이 표시됩니다.
- 열 헤더를 클릭하면 정렬할 수 있습니다.
- 차원 값은 사람이 읽기 쉬운 라벨로 표시됩니다 (예:
interaction_kind = slash→ "슬래시 명령어"). - HLL 근사치 메트릭 옆에는 "근사치" 뱃지가 표시됩니다.