서드파티 확장 기능 지원: LogDNA 통합

MagicTradeBot은 실시간 로그 스트리밍 및 중앙 집중식 모니터링을 가능하게 하는 클라우드 네이티브 로그 관리 플랫폼인 LogDNA와의 기본 통합을 제공합니다. 이 통합을 통해 각 봇 인스턴스에서 생성된 모든 이벤트와 로그를 LogDNA로 즉시 전송할 수 있습니다.

단일 봇 인스턴스를 운영하든, 다양한 거래소, 계정, 거래쌍, 또는 분산된 서버에서 수백 개의 인스턴스를 관리하든, LogDNA는 관측 가능성과 진단을 중앙화할 수 있도록 지원합니다. 이 규모에서는 수동 추적이 비현실적이며, LogDNA는 직관적인 대시보드와 고성능 인덱싱으로 이 문제를 해결합니다.

🚀 개요

MagicTradeBot은 LogDNA의 수집 API 또는 로깅 에이전트를 통해 모든 로그 및 거래 이벤트를 전송할 수 있습니다. 이 설정을 통해 다음 작업이 가능합니다:

심볼, 거래소 또는 인스턴스별 로그 검색, 필터링, 시각화
오류, 거래 실행 실패 및 API 문제 상관 분석
모든 계정 및 거래소에 걸친 봇 활동을 한 곳에서 모니터링

🔧 주요 기능

📡 HTTPS 또는 로깅 에이전트를 통한 실시간 로그 스트리밍
🌍 다중 인스턴스 및 다중 서버 배포 지원
🧠 사용자 정의 태그 및 메타데이터가 포함된 검색 가능한 로그
📊 거래 활동, 오류 및 이벤트를 시각화하는 중앙 대시보드
🚨 Slack, PagerDuty, Webhook 등을 통한 알림 연동

🛠️ 사전 요구사항

유효한 LogDNA 계정
로그 수집용 LogDNA Ingest Key (API 키)
선택 사항: 봇 호스팅 환경에 LogDNA 에이전트 설치

⚙️ 구성 단계

1. LogDNA Ingest Key 얻기

LogDNA 계정에 로그인한 후 설정 → API 키로 이동하여 수집 키를 생성하거나 복사합니다.

2. 봇 구성 업데이트

config.yaml 등의 구성 파일에서 LogDNA 로깅을 활성화합니다:

logging:
  logdna:
    enabled: true
    ingest_key: "YOUR_LOGDNA_API_KEY"
    app_name: "magictradebot"
    environment: "production"
    hostname: "bot-eu-1"
    tags:
      - exchange:binance
      - region:eu

3. (선택 사항) LogDNA 에이전트 설치

원할 경우 서버(Linux/Windows/macOS)에 LogDNA 에이전트를 설치할 수 있습니다:

curl -sSL https://assets.logdna.com/logdna-agent.sh | sudo bash -s -- -k YOUR_LOGDNA_API_KEY

또는 /etc/logdna.conf 파일을 수동으로 설정하고 에이전트를 시작하세요.

4. 배포 및 확인

봇을 실행하고, 올바른 태그, 호스트명, 인스턴스 ID와 함께 로그가 실시간으로 LogDNA 대시보드에 표시되는지 확인합니다.

🧪 LogDNA JSON 로그 예시

{
  "timestamp": "2025-06-20T12:12:11Z",
  "level": "info",
  "message": "Executed short trade",
  "exchange": "binance",
  "symbol": "DOGE/USDT",
  "strategy": "ScalpShort",
  "profit": 1.05,
  "bot_instance": "bot-apac-02"
}

✅ LogDNA 통합의 장점

📍 여러 거래소의 모든 봇 인스턴스를 위한 통합 로그 접근
🧩 전략 성능 및 런타임 동작에 대한 전체 가시성 확보
📈 고급 필터링을 통한 빠른 디버깅 및 오류 추적
🚨 실시간 사고 대응을 위한 경고 도구와의 통합
💾 컴플라이언스 및 감사용으로 검색 가능한 영구 로그 기록