Supporto per estensioni di terze parti: Integrazione con Datadog

MagicTradeBot offre supporto nativo per l'integrazione con Datadog, una potente piattaforma di osservabilità, per abilitare la gestione centralizzata dei log in tempo reale e il monitoraggio degli eventi. Che tu stia eseguendo una singola istanza del bot o distribuendo più bot su diversi exchange, account e server, Datadog ti consente di ottenere una visibilità completa sull’infrastruttura di trading.

🚀 Panoramica

Il motore principale di MagicTradeBot supporta l'invio in tempo reale di log strutturati ed eventi di trading direttamente a Datadog. Questa integrazione è ideale per:

Monitorare il comportamento del bot e l’esecuzione degli ordini su tutte le istanze
Effettuare il debug e tracciare problemi in modo centralizzato
Tenere traccia di prestazioni, tassi di errore e condizioni di attivazione
Visualizzare le attività di trading tramite dashboard e avvisi

🔧 Funzionalità principali

📡 Streaming dei log in tempo reale da tutte le istanze attive del bot
🧠 Report strutturati degli eventi con metadati (simbolo, strategia, risultato, ecc.)
🖥️ Aggregazione multi-istanza da più exchange e account
☁️ Supporto per distribuzioni distribuite (cloud-native o self-hosted)
📊 Dashboard e avvisi centralizzati sulla piattaforma Datadog

🛠️ Prerequisiti

Prima di abilitare il supporto Datadog, assicurati di:

Avere un account Datadog valido con accesso API abilitato
Disporre di una chiave API Datadog
Avere disponibile nel tuo ambiente il pacchetto @datadog/datadog-api-client (o un client HTTP equivalente per estensioni personalizzate)

⚙️ Passaggi di configurazione

1. Abilita l'integrazione con Datadog nella configurazione

Nel file di configurazione di MagicTradeBot (es. config.yaml o appsettings.json), abilita e imposta i seguenti parametri:

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. Imposta il livello di log

Scegli il livello di verbosità desiderato per i log:

debug: Dettagli molto approfonditi (solo in fase di sviluppo)
info: Eventi di trading, azioni delle strategie, operazioni normali
warn: Eventi inattesi ma non critici
error: Errori, ordini rifiutati, trigger non validi

3. Configura le istanze del bot

Assicurati che ogni istanza del bot abbia un instance_id univoco e tag pertinenti per consentire a Datadog di distinguerle.

4. Distribuisci e monitora

Una volta configurato, avvia il/i bot. I flussi di log inizieranno ad apparire nell'esploratore log di Datadog in pochi secondi. Ora puoi:

Filtrare i log per simbolo, strategia o istanza
Costruire dashboard basate su metriche di trading
Creare avvisi su errori, soglie di profitto o malfunzionamenti dell’API

🧪 Esempio di output log (formato JSON)

{
  "timestamp": "2025-06-20T09:15:32Z",
  "level": "info",
  "message": "Trade eseguito",
  "exchange": "binance",
  "symbol": "BTC/USDT",
  "strategy": "ScalpLong",
  "amount": 0.002,
  "price": 65250,
  "profit": 3.45,
  "instance_id": "bot-eu-1"
}

✅ Vantaggi dell'integrazione con Datadog

📍 Controllo centralizzato: Visualizza tutti i log da ambienti e istanze in un unico posto
📈 Monitoraggio delle prestazioni: Analizza l'efficienza dei trade, gli errori e i tempi di attività
🚨 Avvisi proattivi: Ricevi notifiche sui problemi prima che impattino l'attività
🧩 Debug facilitato: Identifica rapidamente problemi nei sistemi distribuiti