Suporte a extensões de terceiros: Integração com o Datadog

O MagicTradeBot oferece suporte nativo para integração com o Datadog, uma poderosa plataforma de observabilidade, permitindo a gestão centralizada de logs em tempo real e monitoramento de eventos. Seja operando uma única instância do bot ou implantando vários bots em diferentes exchanges, contas e servidores, o Datadog proporciona visibilidade total sobre sua infraestrutura de trading.

🚀 Visão Geral

O núcleo do MagicTradeBot permite o envio em tempo real de logs estruturados e eventos de trade diretamente para o Datadog. Esta integração é ideal para:

  • Monitorar o comportamento do bot e execução das negociações em todas as instâncias
  • Depuração centralizada e rastreamento de problemas
  • Acompanhar desempenho, taxas de erro e condições de disparo
  • Visualizar atividades de trading por meio de dashboards e alertas

🔧 Recursos Principais

  • 📡 Streaming de logs em tempo real de todas as instâncias ativas do bot
  • 🧠 Relatórios estruturados de eventos com metadados (símbolo, estratégia, resultado, etc.)
  • 🖥️ Agregação multi-instância de diversas exchanges e contas
  • ☁️ Suporte para implantações distribuídas (nativas em nuvem ou auto-hospedadas)
  • 📊 Dashboards e alertas centralizados na plataforma Datadog

🛠️ Pré-Requisitos

Antes de ativar o suporte ao Datadog, certifique-se de:

  • Ter uma conta válida no Datadog com acesso à API habilitado
  • Possuir uma chave de API do Datadog
  • Ter o pacote @datadog/datadog-api-client (ou cliente HTTP equivalente) disponível no seu ambiente (para extensões personalizadas)

⚙️ Etapas de Configuração

1. Habilite a Integração com o Datadog na Configuração

No seu arquivo de configuração do MagicTradeBot (ex: config.yaml ou appsettings.json), habilite e defina os seguintes parâmetros:

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. Defina o Nível de Log

Escolha o nível de detalhamento apropriado para os logs:

  • debug: Detalhes extensos (somente para desenvolvimento)
  • info: Eventos de trade, ações de estratégia, operações normais
  • warn: Eventos inesperados, mas não críticos
  • error: Falhas, ordens rejeitadas, gatilhos inválidos

3. Configure as Instâncias do Bot

Certifique-se de que cada instância do bot tenha um instance_id exclusivo e tags apropriadas para que o Datadog possa diferenciá-las.

4. Faça o Deploy e Monitore

Após configurar, inicie seu(s) bot(s). Os fluxos de logs aparecerão no explorador de logs do Datadog em segundos. Agora você pode:

  • Filtrar logs por símbolo, estratégia ou instância
  • Criar dashboards com métricas de trade
  • Criar alertas para erros, limites de lucro ou falhas de API

🧪 Exemplo de Saída de Log (Formato JSON)

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

✅ Benefícios da Integração com o Datadog

  • 📍 Controle Centralizado: Veja todos os logs de ambientes e instâncias em um único local
  • 📈 Monitoramento de Desempenho: Analise eficiência de negociações, erros e tempo de atividade
  • 🚨 Alertas Proativos: Seja notificado sobre problemas antes que afetem seu trading
  • 🧩 Depuração Facilitada: Identifique rapidamente problemas em sistemas distribuídos

📎 Related Topics