Monitoreo y alertas
Qué deben monitorear los market makers y sobre qué deben configurar alertas.
Verificaciones de estado
Estado de la API
Endpoint: GET /health
Respuesta: {"status":"ok"}
Disponibilidad: GET /ready devuelve {"status":"ready","components":[...]} con un indicador ready por componente. Úselo para distinguir una API accesible que aún no está atendiendo solicitudes de una API en buen estado.
Monitoreo: Verifique cada 30-60 segundos
Alerta: Si la verificación de estado falla, es posible que el servidor de la API esté caído
Conexión WebSocket
Monitoreo: Haga seguimiento del estado de la conexión WebSocket
Alerta: Si la conexión se cae, reconecte de inmediato
Buena práctica: Implemente backoff exponencial en la reconexión
Monitoreo de órdenes
Tasa de rechazo
Métrica: Porcentaje de órdenes rechazadas
Alerta: Si la tasa de rechazo es > 5%, investigue:
- Problemas de margen
- Restricciones de nivel (tier)
- Instrumentos vencidos
- Sobrecarga del sistema
Tasa de ejecución
Métrica: Porcentaje de órdenes ejecutadas
Alerta: Si la tasa de ejecución cae de forma significativa, investigue:
- Condiciones del mercado
- Competitividad de las cotizaciones
- Profundidad del libro de órdenes
Latencia de órdenes
Métrica: Tiempo desde la colocación de la orden hasta la ejecución o el acuse de recibo (ack)
Alerta: Si la latencia es > 1s, investigue:
- Sobrecarga del sistema
- Problemas de red
- Retrasos de procesamiento del motor
Monitoreo del portafolio
Uso de margen
Métrica: utilización de margen a partir de margin_summary en GET /portfolio?wallet=.... margin_summary.initial_margin y margin_summary.maintenance_margin son holgura (lo que queda después de los requisitos), no margen en uso. Calcule la utilización sobre la base que realmente respalda el margen en cada modo:
margin_summary.mode | Base | Holgura de margen inicial | Holgura de margen de mantenimiento |
|---|---|---|---|
portfolio | equity | initial_margin | maintenance_margin |
standard | standard_margin.cash_margin | standard_margin.initial_margin_headroom | standard_margin.maintenance_margin_headroom |
im_utilization = (basis - initial_margin_headroom) / basis
mm_utilization = (basis - maintenance_margin_headroom) / basis
Trate una base de cero o menos como 100% utilizada.
Alerta: Si la utilización del margen inicial supera el 80%, las nuevas órdenes están cerca de ser rechazadas. Si la utilización del margen de mantenimiento se acerca al 100%, la cuenta está cerca de la liquidación. Considere:
- Reducir el tamaño de la posición
- Añadir colateral
- Cerrar posiciones
Colateral libre
Métrica: available_balance de GET /portfolio?wallet=.... Es colateral libre para nuevas operaciones, no el saldo de efectivo en USDC. Las marcas de opciones, el PnL de perps y los requisitos de margen lo mueven sin que cambie el efectivo. Para el importe que puede retirar, use withdrawable_usdc.
Alerta: Si el colateral libre es < umbral, reduzca el riesgo o deposite fondos
Monitoreo de MMP
Activaciones de MMP
Métrica: Número de activaciones de MMP por hora
Alerta: Si MMP se activa con frecuencia, considere:
- Aumentar los límites de MMP
- Reducir la frecuencia de cotización
- Revisar los patrones de ejecución
Tasa de cancelación por MMP
Métrica: Porcentaje de órdenes canceladas por MMP
Alerta: Si la tasa de cancelación por MMP es > 10%, revise la configuración de MMP
Monitoreo del sistema
Tiempos de respuesta de la API
Métrica: Tiempos de respuesta P50, P95, P99
Alerta: Si P95 > 500ms, investigue la carga del sistema
Tasa de mensajes WebSocket
Métrica: Mensajes por segundo en WebSocket
Alerta: Si la tasa de mensajes se dispara, investigue:
- Volatilidad del mercado
- Sobrecarga del sistema
- Retrasos en el procesamiento de mensajes
Alertas recomendadas
- Fallo de la verificación de estado: servidor de la API caído
- Tasa de rechazo alta: > 5% de órdenes rechazadas
- Tasa de ejecución baja: < 50% de órdenes ejecutadas (depende del contexto)
- Uso de margen alto: > 80% del margen utilizado
- Activaciones de MMP: > 5 activaciones por hora
- Desconexión de WebSocket: conexión perdida
- Latencia alta: P95 > 500ms
Herramientas de monitoreo
Recomendadas:
- Endpoint de verificación de estado para monitorear la disponibilidad
- Seguimiento del estado de la conexión WebSocket
- Conciliación de órdenes y ejecuciones para mayor exactitud
- Seguimiento del margen del portafolio
Actualmente: No hay un panel de monitoreo integrado. Use herramientas externas (por ejemplo, Prometheus, Grafana).