Dicolytics Docs

한국어

English

한국어

English

Appearance

시작하기 ​

Dicolytics를 봇에 연결하는 과정을 안내합니다. 5분이면 충분합니다.

1. 계정 만들기 ​

dicolytics.com에서 Discord 계정으로 로그인합니다.

처음 로그인하면 자동으로 개인 조직이 생성됩니다. 조직은 프로젝트와 팀원을 관리하는 단위입니다. 나중에 팀원을 초대해서 대시보드를 함께 볼 수 있습니다.

2. 프로젝트 만들기 ​

로그인 후 프로젝트 만들기 화면이 나타납니다. 프로젝트 하나가 Discord 봇 하나에 대응합니다.

  1. Discord 애플리케이션 ID를 입력합니다 — Discord Developer Portal에서 확인할 수 있습니다
  2. ID를 입력하면 봇 이름과 아바타를 자동으로 불러옵니다
  3. 프로젝트 이름, 봇 카테고리, 타임존을 설정합니다
  4. 만들기를 클릭합니다

3. API 키 발급 ​

프로젝트가 생성되면 API 키가 표시됩니다.

이 키는 한 번만 표시되므로 반드시 안전한 곳에 복사해두세요. 키를 분실하면 기존 키를 폐기하고 설정 → API 키에서 새 키를 발급할 수 있습니다.

API 키는 dk_live_ 로 시작하는 문자열입니다.

4. SDK 설치 ​

봇의 라이브러리에 맞는 SDK를 설치합니다.

bash
npm install @dicolytics/discord.js
bash
pnpm add @dicolytics/discord.js
bash
yarn add @dicolytics/discord.js
bash
pip install dicolytics

지원 환경

  • discord.js: v14.9 이상, Node.js 20 이상
  • discord.py: v2.0 이상, Python 3.10 이상

5. 봇에 연결 ​

SDK를 봇 코드에 추가합니다. 라이브러리에 따라 연결 방법이 다릅니다.

ts
import { Client, GatewayIntentBits } from 'discord.js';
import { createDicolytics } from '@dicolytics/discord.js'; 

const client = new Client({
  intents: [GatewayIntentBits.Guilds],
});

const analytics = createDicolytics(client, { 
  apiKey: 'dk_live_여기에_API_키를_입력하세요', 
}); 

client.login('BOT_TOKEN');
js
const { Client, GatewayIntentBits } = require('discord.js');
const { createDicolytics } = require('@dicolytics/discord.js'); 

const client = new Client({
  intents: [GatewayIntentBits.Guilds],
});

const analytics = createDicolytics(client, { 
  apiKey: 'dk_live_여기에_API_키를_입력하세요', 
}); 

client.login('BOT_TOKEN');
python
import discord
from dicolytics import create_dicolytics

bot = discord.Bot()
analytics = create_dicolytics(bot, api_key="dk_live_여기에_API_키를_입력하세요")

bot.run("BOT_TOKEN")

createDicolytics는 반드시 client.login() 전에 호출해야 합니다. 이 순서가 바뀌면 일부 이벤트가 수집되지 않을 수 있습니다.

SDK가 하는 일:

  • 슬래시 명령어, 버튼, 셀렉트 메뉴 등 상호작용을 자동 수집합니다
  • 메시지 전송, 역할 부여 등 봇의 작업을 자동 감지합니다
  • 멤버 입퇴장, 메시지 생성 등 이벤트를 집계합니다
  • 봇 상태(핑, 메모리, 샤드 정보)를 주기적으로 보고합니다

메시지 내용은 절대 수집하지 않습니다.

6. 연결 확인 ​

봇을 실행하면 Dicolytics 대시보드 홈에서 데이터가 들어오는 것을 확인할 수 있습니다. 보통 1분 이내에 첫 데이터가 표시됩니다.

데이터가 보이지 않는다면:

  1. API 키 확인 — 키가 정확하게 입력되었는지, dk_live_로 시작하는지 확인하세요
  2. 디버그 모드 — SDK 옵션에 debug: true를 추가하면 콘솔에 진단 로그가 출력됩니다
  3. 봇 재시작 — SDK를 설치한 후 봇을 재시작했는지 확인하세요
  4. 네트워크 — 봇 서버에서 api.dicolytics.com으로의 HTTPS 연결이 차단되지 않았는지 확인하세요
ts
const analytics = createDicolytics(client, {
  apiKey: 'dk_live_...',
  debug: true, // 콘솔에 SDK 진단 로그 출력
});

7. 다음 단계 ​

연결이 확인되었으면, 다음 문서를 참고하세요.

  • 설정 옵션 — 수집 비활성화, flush 주기, 멀티클러스터 등 SDK 동작을 세부 조정합니다
  • 커스텀 이벤트 — track()과 captureError()로 자체 이벤트를 수집합니다
  • 대시보드 개요 — 홈 KPI, 보고서, 실시간 페이지 사용법을 알아봅니다
  • 멀티클러스터 — 여러 프로세스에서 봇을 운영하는 경우 clusterId 설정 방법을 안내합니다

Dicolytics — Discord bot analytics