MagicTradeBot ofrece soporte nativo para integrarse con PagerDuty, una plataforma líder en respuesta a incidentes y operaciones digitales. Esta integración permite la transmisión de registros, alertas y gestión de incidentes en tiempo real en todas las instancias del bot dentro de tu infraestructura.
Ya sea que estés ejecutando una única instancia del bot o administrando cientos de bots en múltiples exchanges, cuentas y servidores, PagerDuty te permite centralizar la observabilidad, responder rápidamente a fallos y garantizar una alta disponibilidad de tus operaciones de trading.
🚀 Descripción general
MagicTradeBot puede enviar eventos de registro y alertas desde cada instancia del bot a PagerDuty en tiempo real. Esto es fundamental para:
- Monitorear instancias distribuidas del bot y la actividad del mercado
- Disparar respuestas automáticas ante fallos de trading o errores de estrategia
- Gestionar alertas entre zonas horarias, equipos y entornos
El monitoreo manual se vuelve impracticable cuando tus bots operan sobre cientos de pares de criptomonedas. PagerDuty ofrece una solución centralizada e inteligente para controlar, supervisar y responder a gran escala.
🔧 Funciones clave
- 📡 Envío de eventos en tiempo real a PagerDuty mediante webhooks o API REST
- 🚨 Condiciones de alerta configurables para errores del bot, fallos de trading o interrupciones del sistema
- 🌍 Escalable para entornos con una o múltiples instancias del bot
- 🧠 Políticas inteligentes de escalado y enrutamiento automático de incidentes
- 📊 Panel centralizado para el seguimiento del historial de alertas y el estado de las operaciones
🛠️ Requisitos previos
- Una cuenta de PagerDuty con una clave API o token de integración válido
- Un servicio existente en PagerDuty con políticas de escalado definidas
- MagicTradeBot configurado para enviar notificaciones mediante webhook o API
⚙️ Pasos de configuración
1. Crear una integración en PagerDuty
En tu panel de PagerDuty, ve a Services → Add Service y crea un nuevo servicio para monitorear MagicTradeBot. Elige el tipo de integración Events API v2 o Custom Webhook.
2. Obtener la clave de integración
Copia la clave de integración (routing key) o la URL del webhook para usarla en la configuración del bot.
3. Actualizar la configuración del bot
Agrega la integración con PagerDuty en el archivo de configuración de MagicTradeBot (por ejemplo, config.yaml):
incident_reporting:
pagerduty:
enabled: true
integration_key: "YOUR_PAGERDUTY_ROUTING_KEY"
service_name: "magictradebot"
severity_threshold: "error"
environment: "production"
4. Definir condiciones de alerta
El bot enviará alertas a PagerDuty según reglas internas como:
- Error al ejecutar una operación de trading
- API del exchange no disponible
- Tasa de errores alta o picos de uso de memoria
- Ejecución fallida de estrategia o parámetros inválidos
5. Probar y validar
Lanza el bot con alertas de prueba activadas y verifica que los eventos aparezcan en el panel de PagerDuty. Ajusta el nivel de severidad o filtros si es necesario.
🧪 Ejemplo de payload para evento en PagerDuty
{
"routing_key": "YOUR_PAGERDUTY_ROUTING_KEY",
"event_action": "trigger",
"payload": {
"summary": "MagicTradeBot no pudo ejecutar la operación BTC/USDT",
"severity": "error",
"source": "bot-eu-1",
"component": "trade-engine",
"custom_details": {
"symbol": "BTC/USDT",
"exchange": "binance",
"reason": "Saldo insuficiente en la cuenta de margen"
}
}
}
✅ Beneficios de la integración con PagerDuty
- 📍 Alertas centralizadas para todas las instancias del bot y entornos
- 🚀 Respuesta rápida ante incidentes mediante escalamiento automatizado
- 🧩 Fácil integración con equipos mediante SMS, correo, Slack u otras herramientas
- 📉 Menor tiempo de inactividad y reducción de pérdidas en mercados volátiles
- 📈 Visibilidad completa del estado de las operaciones y fiabilidad en la ejecución