On-Call

Gestiona horarios on-call, rotaciones y escalamiento de alertas.

Vista General

El sistema on-call asegura que las personas correctas sean alertadas cuando ocurren problemas:

• Horarios: Define quién está on-call cuándo
• Rotaciones: Rotación automática entre miembros del equipo
• Escalamiento: Escalamiento de alertas multinivel
• Alertas: Rastrea y reconoce alertas entrantes

Dashboard On-Call

Navega a Dashboard > On-Call para ver:

• Persona(s) actualmente on-call
• Alertas activas
• Próximos cambios de horario
• Historial de alertas recientes

Horarios

Crear un Horario

1. Navega a On-Call > Horarios
2. Haz clic en "Nuevo Horario"
3. Configura:

Tipos de Rotación

Semanal

Cada persona está on-call por una semana completa:

Semana 1: Alice
Semana 2: Bob
Semana 3: Charlie
Semana 4: Alice (cicla)

Diaria

Cada persona está on-call por un día:

Lunes: Alice
Martes: Bob
Miércoles: Charlie
...

Horas Personalizadas

Define franjas horarias específicas:

Días de semana 9am-5pm: Equipo A
Días de semana 5pm-9am: Equipo B
Fines de semana: Equipo C

Añadir Participantes

1. Abre el horario
2. Haz clic en "Añadir Participante"
3. Selecciona miembro del equipo
4. Establece su orden de rotación
5. Configura métodos de contacto

Anulaciones

Crea anulaciones temporales:

1. Abre el horario
2. Haz clic en "Añadir Anulación"
3. Selecciona:
   • Usuario a reemplazar
   • Usuario de reemplazo
   • Horas de inicio/fin
4. Guarda

Políticas de Escalamiento

Define cómo escalan las alertas si no se reconocen:

Crear una Política

1. Navega a On-Call > Horarios
2. Abre un horario
3. Haz clic en "Política de Escalamiento"
4. Añade niveles:

Nivel 1 (inmediato):

• On-call primario
• Esperar 5 minutos

Nivel 2 (5 min):

• On-call secundario
• Esperar 10 minutos

Nivel 3 (15 min):

• Líder de equipo + manager
• Escalamiento final

Reglas de Escalamiento

Ejemplo de Escalamiento

Alerta disparada
  ↓
Nivel 1: Alertar ingeniero on-call
  ↓ (5 min, no reconocida)
Nivel 2: Alertar on-call + backup
  ↓ (10 min, no reconocida)
Nivel 3: Alertar equipo completo

Alertas

Cómo se Disparan las Alertas

Las alertas se crean cuando:

• Monitor falla (componente ENDPOINT)
• Incidente manual creado con notificación on-call
• Alerta creada vía API

Estados de Alerta

Reconocer Alertas

Desde el dashboard:

1. Haz clic en la alerta
2. Haz clic en "Reconocer"

Vía email/SMS:

• Responde con "ack" o haz clic en el enlace

Vía API:

curl -X POST http://localhost:3000/api/v1/oncall/alerts/{id}/acknowledge \
  -H "Authorization: Bearer sk_live_xxx"

Posponer Alertas

Silencia temporalmente una alerta:

1. Abre la alerta
2. Haz clic en "Posponer"
3. Selecciona duración (5m, 15m, 1h, etc.)

La alerta se re-disparará después del período de posposición si no está resuelta.

Resolver Alertas

Marca una alerta como solucionada:

1. Abre la alerta
2. Haz clic en "Resolver"

O se resuelve automáticamente cuando:

• El monitor se recupera
• El incidente vinculado se resuelve

Métodos de Contacto

Configura cómo los miembros del equipo reciben alertas:

Configurar Contactos

1. Navega a Configuración > Contactos On-Call
2. Haz clic en "Añadir Contacto"
3. Configura métodos:

Orden de Notificación

Establece el orden para intentar métodos de contacto:

1. Notificación push (inmediata)
2. SMS (30 seg de retraso si no hay respuesta)
3. Llamada telefónica (2 min de retraso si no hay respuesta)

Horas Silenciosas

Define tiempos cuando ciertos métodos están deshabilitados:

Horas silenciosas: 10pm - 8am
Durante horas silenciosas: Solo llamadas telefónicas

Contactos On-Call

Configuración por Usuario

Cada usuario puede configurar:

• Email/teléfono primario
• Métodos de contacto de respaldo
• Preferencias de notificación
• Horas silenciosas

Probar Contactos

1. Abre configuración de contacto
2. Haz clic en "Probar" junto a cada método
3. Verifica recepción

Vistas de Horario

Vista de Calendario

Ve el horario como calendario:

• Codificado por color por persona
• Muestra anulaciones
• Clic para editar

Vista de Línea de Tiempo

Línea de tiempo lineal de cobertura:

• Quién está on-call cuándo
• Detección de huecos
• Resumen de cobertura

Vista de Lista

Tabla de próximos turnos:

• Usuario, inicio, fin
• Ordenable y buscable

Acceso API

On-Call Actual

curl http://localhost:3000/api/v1/oncall/schedules/{id}/current \
  -H "Authorization: Bearer sk_live_xxx"

Crear Alerta

curl -X POST http://localhost:3000/api/v1/oncall/alerts \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Alto Uso de CPU",
    "description": "CPU del servidor al 95%",
    "scheduleId": "schedule-id",
    "severity": "critical"
  }'

Listar Alertas

curl http://localhost:3000/api/v1/oncall/alerts \
  -H "Authorization: Bearer sk_live_xxx"

Mejores Prácticas

Diseño de Horario

• Asegura cobertura 24/7
• Balancea carga equitativamente
• Ten en cuenta zonas horarias
• Planifica para días festivos

Escalamiento

• Comienza con equipo pequeño
• Añade management en niveles posteriores
• Mantén tiempos de escalamiento razonables
• Prueba escalamiento periódicamente

Prevención de Fatiga de Alertas

• Ajusta umbrales de monitor
• Usa umbrales de fallo apropiados
• Revisa y elimina alertas ruidosas
• Agrupa alertas relacionadas

Documentación

• Documenta procedimientos de escalamiento
• Crea runbooks para problemas comunes
• Mantén info de contacto actualizada
• Revisiones regulares de horario

Solución de Problemas

Alertas No Se Disparan

1. Verifica que el horario tiene participantes
2. Verifica que existe política de escalamiento
3. Confirma que métodos de contacto están configurados
4. Verifica configuración de auto-incidente del monitor

Persona Incorrecta Alertada

1. Verifica horario actual
2. Busca anulaciones
3. Verifica configuración de zona horaria
4. Verifica orden de rotación

Alertas No Escalan

1. Verifica política de escalamiento
2. Verifica tiempos de espera
3. Confirma que siguiente nivel tiene contactos
4. Revisa logs de escalamiento

Documentación Relacionada

• Monitores - Configurar health checks
• Notificaciones - Canales de alerta
• Incidentes - Gestión de incidentes