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

O MagicTradeBot oferece integração nativa com o Sentry — uma poderosa plataforma de monitoramento e rastreamento de erros em tempo real. Isso permite que desenvolvedores e operadores enviem logs e dados de eventos estruturados de cada instância do bot para o Sentry, facilitando o diagnóstico rápido, alertas centralizados e visibilidade total da saúde do sistema.

Seja executando uma única instância do bot ou centenas de bots em várias corretoras, contas, símbolos ou nós de servidor, o Sentry ajuda a centralizar o monitoramento e rastrear problemas com eficiência. Em larga escala, o monitoramento manual não é viável — o Sentry preenche essa lacuna com automação robusta e insights detalhados.

🚀 Visão Geral

Com a integração do Sentry, o MagicTradeBot pode capturar automaticamente:

  • Exceções em tempo de execução e erros não tratados
  • Falhas na execução de ordens
  • Problemas de conectividade com corretoras
  • Logs personalizados e eventos de diagnóstico

Todos os logs e eventos de erro são enviados em tempo real ao Sentry, permitindo que você:

  • Rastreie problemas por instância, símbolo ou corretora
  • Analise stack traces, gargalos de desempenho e frequência de erros
  • Configure alertas via e-mail, Slack ou webhooks para falhas críticas

🔧 Funcionalidades Principais

  • 📡 Relatórios de exceções e erros em tempo real
  • 🧠 Captura automática de stack trace com metadados contextuais
  • 🌍 Suporte a ambientes distribuídos e com múltiplas instâncias
  • 🕵️ Agrupamento de problemas, marcação de gravidade e rastreamento de versões
  • 📊 Painel centralizado com regras de alerta e integrações

🛠️ Pré-requisitos

  • Uma conta Sentry válida e um DSN (Data Source Name)
  • SDK do Sentry instalado no ambiente de execução do MagicTradeBot
  • Bot configurado com instance_id ou tags únicos para melhor rastreabilidade

⚙️ Etapas de Configuração

1. Instalar o SDK do Sentry

Instale o SDK do Sentry para seu ambiente (ex: Python, Go, Node.js):

pip install --upgrade sentry-sdk

2. Inicializar o Sentry no código de inicialização do bot

Adicione o seguinte trecho de código para inicializar o Sentry:

import sentry_sdk

sentry_sdk.init(
    dsn="YOUR_SENTRY_DSN",
    environment="production",
    release="magictradebot@2.0.0",
    traces_sample_rate=1.0,
    send_default_pii=True
)

3. Ativar o Sentry no arquivo de configuração

No config.yaml ou appsettings.json, ative a integração do Sentry:

monitoring:
  sentry:
    enabled: true
    dsn: "YOUR_SENTRY_DSN"
    environment: "production"
    release: "magictradebot@2.0.0"
    tags:
      instance_id: "bot-apac-01"
      exchange: "binance"

4. Adicionar captura de logs e erros personalizados (opcional)

Você pode relatar erros críticos manualmente assim:

from sentry_sdk import capture_exception

try:
    bot.execute_trade()
except Exception as e:
    capture_exception(e)

🧪 Exemplo de Payload de Evento do Sentry

{
  "level": "error",
  "message": "Trade execution failed",
  "timestamp": "2025-06-20T11:25:41Z",
  "bot_instance": "bot-us-1",
  "symbol": "SOL/USDT",
  "exchange": "kucoin",
  "exception": {
    "type": "InsufficientBalanceError",
    "value": "Not enough USDT to place order",
    "stacktrace": [...]
  }
}

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

  • 📍 Rastreamento centralizado de logs e erros para todas as atividades do bot
  • ⚠️ Visibilidade imediata sobre falhas, configurações incorretas ou interrupções
  • 📈 Painéis visuais para frequência e tendências de erros
  • 🚨 Integração com alertas via Slack, Teams, Email e Webhooks
  • 🔍 Resolução mais rápida de incidentes com stack traces e breadcrumbs

📎 Related Topics