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

O MagicTradeBot oferece suporte nativo para integração com o PagerDuty — uma plataforma líder em resposta a incidentes e operações digitais. Essa integração permite o encaminhamento de logs em tempo real, envio de alertas e gerenciamento de incidentes em todas as instâncias de bots em sua infraestrutura.

Seja você operando uma única instância de bot ou gerenciando centenas de bots em múltiplas exchanges, contas de negociação e servidores, o PagerDuty permite centralizar a observabilidade, responder rapidamente a falhas e garantir alta disponibilidade das operações de trading.

🚀 Visão Geral

O MagicTradeBot pode encaminhar eventos de log e alertas de cada instância de bot diretamente para o PagerDuty em tempo real. Isso é essencial para:

  • Monitorar instâncias de bots distribuídas e atividade de mercado
  • Acionar respostas automáticas a incidentes em falhas de negociação ou erros de estratégia
  • Gerenciar alertas em diferentes fusos horários, equipes e ambientes

Monitoramento manual se torna inviável quando seus bots estão negociando centenas de pares de criptomoedas. O PagerDuty oferece uma forma centralizada e inteligente de controlar, monitorar e reagir em escala.

🔧 Recursos Principais

  • 📡 Entrega de eventos em tempo real para o PagerDuty via webhooks ou API REST
  • 🚨 Condições de alerta configuráveis para erros do bot, falhas de negociação ou quedas de sistema
  • 🌍 Escalável para ambientes com uma ou várias instâncias de bots
  • 🧠 Políticas de escalonamento inteligentes e roteamento automático de incidentes
  • 📊 Painel centralizado para rastrear histórico de alertas e integridade das negociações

🛠️ Pré-Requisitos

  • Conta do PagerDuty com chave de API válida ou token de integração
  • Serviço do PagerDuty existente com políticas de escalonamento definidas
  • MagicTradeBot configurado para notificação externa via webhook ou API

⚙️ Etapas de Configuração

1. Criar uma Integração no PagerDuty

No painel do PagerDuty, vá para Services → Add Service e crie um novo serviço para monitoramento do MagicTradeBot. Escolha o tipo de integração Events API v2 ou Webhook Personalizado.

2. Obter a Chave de Integração

Copie a chave de integração (routing key) ou a URL do webhook para usar na configuração do bot.

3. Atualizar a Configuração do Bot

Adicione a integração do PagerDuty ao seu arquivo de configuração do MagicTradeBot (por exemplo, config.yaml): 

incident_reporting:
  pagerduty:
    enabled: true
    integration_key: "YOUR_PAGERDUTY_ROUTING_KEY"
    service_name: "magictradebot"
    severity_threshold: "error"
    environment: "production"

4. Definir Condições de Alerta

O bot enviará alertas ao PagerDuty com base em regras internas, como:

  • Falha ao executar uma negociação
  • API da exchange inacessível
  • Taxas de erro elevadas ou picos de memória
  • Erros de estratégia ou parâmetros inválidos

5. Testar e Validar

Execute o bot com alertas de teste ativados e verifique se os eventos aparecem no painel do PagerDuty. Ajuste a severidade ou filtros conforme necessário.

🧪 Exemplo de Payload de Evento do PagerDuty

{
  "routing_key": "YOUR_PAGERDUTY_ROUTING_KEY",
  "event_action": "trigger",
  "payload": {
    "summary": "MagicTradeBot falhou ao executar negociação BTC/USDT",
    "severity": "error",
    "source": "bot-eu-1",
    "component": "trade-engine",
    "custom_details": {
      "symbol": "BTC/USDT",
      "exchange": "binance",
      "reason": "Saldo de margem insuficiente"
    }
  }
}

✅ Benefícios da Integração com PagerDuty

  • 📍 Alertas centralizados em todas as instâncias e ambientes de bots
  • 🚀 Resposta e recuperação rápida com escalonamento automatizado
  • 🧩 Integração fácil com equipes via SMS, e-mail, Slack ou ferramentas de operações
  • 📉 Tempo de inatividade e oportunidades perdidas reduzidas em mercados voláteis
  • 📈 Visibilidade completa da saúde das negociações e confiabilidade na execução

📎 Related Topics