MagicTradeBot은 강력한 관측 플랫폼인 Datadog과의 실시간 로그 관리 및 이벤트 모니터링을 위한 기본 통합 기능을 제공합니다. 단일 봇 인스턴스를 실행하든, 여러 거래소, 계정, 서버에 걸쳐 다수의 봇을 배포하든 관계없이, Datadog을 통해 거래 인프라에 대한 완전한 가시성을 확보할 수 있습니다.
🚀 개요
MagicTradeBot의 코어 엔진은 구조화된 로그 및 거래 이벤트를 Datadog으로 실시간 전송할 수 있도록 지원합니다. 이 통합은 다음과 같은 경우에 이상적입니다:
- 모든 인스턴스에서 봇의 동작 및 거래 실행 모니터링
- 중앙 집중식 디버깅 및 문제 추적
- 성능, 오류율, 트리거 조건 추적
- 대시보드 및 알림을 통한 거래 활동 시각화
🔧 주요 기능
- 📡 모든 활성 봇 인스턴스에서 실시간 로그 스트리밍
- 🧠 메타데이터(심볼, 전략, 결과 등)가 포함된 구조화된 이벤트 리포팅
- 🖥️ 여러 거래소 및 계정의 다중 인스턴스 로그 통합
- ☁️ 분산형 배포 환경(클라우드 네이티브 또는 셀프 호스팅) 지원
- 📊 Datadog 플랫폼 내의 중앙 집중식 대시보드 및 알림
🛠️ 사전 준비 사항
Datadog 지원을 활성화하기 전에 다음을 확인하세요:
- API 접근 권한이 있는 유효한 Datadog 계정
- Datadog API 키
- 환경에
@datadog/datadog-api-client또는 동등한 HTTP 클라이언트 설치됨 (사용자 정의 확장을 위한 경우)
⚙️ 설정 단계
1. 구성에서 Datadog 통합 활성화
MagicTradeBot 구성 파일(예: config.yaml 또는 appsettings.json)에서 다음 설정을 활성화하세요:
logging:
datadog:
enabled: true
api_key: "YOUR_DATADOG_API_KEY"
log_level: "info"
service_name: "magictradebot"
environment: "production"
tags:
- bot-instance:<instance_id>
- exchange:<exchange_name>
2. 로그 레벨 설정
원하는 로그의 상세 수준을 선택하세요:
debug: 매우 자세한 정보 (개발 전용)info: 거래 이벤트, 전략 동작, 일반 작업warn: 예상치 못한 비치명적 이벤트error: 실패, 거절된 주문, 잘못된 트리거
3. 봇 인스턴스 구성
각 봇 인스턴스가 고유한 instance_id와 Datadog에서 식별할 수 있는 태그를 갖도록 설정하세요.
4. 배포 및 모니터링
구성을 완료한 후 봇을 시작하세요. 몇 초 안에 로그 스트림이 Datadog 로그 탐색기에 나타납니다. 이후에는 다음과 같은 작업이 가능합니다:
- 심볼, 전략 또는 인스턴스로 로그 필터링
- 거래 지표 기반 대시보드 구축
- 오류, 수익 임계값, API 장애에 대한 경고 설정
🧪 로그 출력 예시 (JSON 형식)
{
"timestamp": "2025-06-20T09:15:32Z",
"level": "info",
"message": "거래 실행 완료",
"exchange": "binance",
"symbol": "BTC/USDT",
"strategy": "ScalpLong",
"amount": 0.002,
"price": 65250,
"profit": 3.45,
"instance_id": "bot-eu-1"
}
✅ Datadog 통합의 이점
- 📍 중앙 집중식 제어: 모든 환경 및 인스턴스의 로그를 한 곳에서 확인
- 📈 성능 모니터링: 거래 효율성, 오류, 가동 시간 분석
- 🚨 사전 경고 시스템: 문제가 거래에 영향을 주기 전에 경고 수신
- 🧩 간편한 디버깅: 분산 시스템 내 문제를 빠르게 파악