MagicTradeBot は、業界をリードするインシデント対応およびデジタル運用プラットフォームである PagerDuty とのネイティブ統合を提供します。この統合により、インフラ全体で実行されているすべてのボットインスタンスに対し、リアルタイムのログ転送、アラート通知、およびインシデント管理が可能になります。
単一の ボットインスタンス を実行している場合でも、複数の取引所、トレーディングアカウント、サーバーにまたがる 何百ものボット を管理している場合でも、PagerDuty を利用することで可観測性を一元化し、障害に即時対応し、取引操作の高可用性を確保できます。
🚀 概要
MagicTradeBot は、各ボットインスタンスから PagerDuty へログイベントおよびアラートをリアルタイムで転送できます。これは以下の目的で有効です：
- 分散されたボットインスタンスおよび市場活動の監視
- トレードの失敗や戦略エラー時の自動インシデント対応のトリガー
- タイムゾーン、チーム、環境を超えたアラート管理
ボットが 数百の暗号通貨ペア をスキャン・取引する場合、手動での監視は現実的ではありません。PagerDuty は、大規模での監視、制御、対応を可能にするインテリジェントな手段を提供します。
🔧 主な機能
- 📡 Webhook または REST API を介したリアルタイムイベントの PagerDuty への送信
- 🚨 ボットエラー、トレード失敗、システム障害などに対する柔軟なアラート条件
- 🌍 単一または複数インスタンス環境への対応
- 🧠 スマートなエスカレーションポリシーとインシデント自動ルーティング
- 📊 アラート履歴や取引ステータスを追跡できる中央ダッシュボード
🛠️ 前提条件
- 有効な API キーまたは統合トークンを持つ PagerDuty アカウント
- エスカレーションポリシーが定義された PagerDuty サービス
- Webhook または API 通知が有効な MagicTradeBot の設定
⚙️ 設定手順
1. PagerDuty 統合を作成
PagerDuty ダッシュボードで Services → Add Service に移動し、MagicTradeBot 監視用の新しいサービスを作成します。Events API v2 または Custom Webhook を選択してください。
2. 統合キーを取得
ボットの設定に使用するための 統合キー（ルーティングキー） または Webhook URL をコピーします。
3. ボット設定の更新
MagicTradeBot の設定ファイル（例：config.yaml）に PagerDuty 統合を追加します：
incident_reporting:
pagerduty:
enabled: true
integration_key: "YOUR_PAGERDUTY_ROUTING_KEY"
service_name: "magictradebot"
severity_threshold: "error"
environment: "production"
4. アラート条件の定義
内部ルールに基づいて PagerDuty にアラートを送信します。例：
- ボットによるトレード実行の失敗
- 取引所 API にアクセスできない
- 高エラー率またはメモリ使用量の急増
- 戦略エラーまたは無効なパラメーター
5. テストと検証
テストアラートを有効にしてボットを起動し、PagerDuty ダッシュボードにイベントが表示されるか確認します。必要に応じて重大度やフィルターを調整してください。
🧪 PagerDuty イベントの例（Payload）
{
"routing_key": "YOUR_PAGERDUTY_ROUTING_KEY",
"event_action": "trigger",
"payload": {
"summary": "MagicTradeBot が BTC/USDT のトレード実行に失敗しました",
"severity": "error",
"source": "bot-eu-1",
"component": "trade-engine",
"custom_details": {
"symbol": "BTC/USDT",
"exchange": "binance",
"reason": "証拠金残高が不足しています"
}
}
}
✅ PagerDuty 統合の利点
- 📍 全インスタンスおよび環境でのアラート一元管理
- 🚀 自動エスカレーションによる迅速なインシデント対応
- 🧩 SMS、メール、Slack、Opsツールなどとのチーム連携が簡単
- 📉 市場の変動による機会損失やダウンタイムの最小化
- 📈 取引健全性と実行信頼性の完全な可視化