Español
Guía de Usuario
Mantenimientos

Mantenimientos

Programa y comunica tiempo de inactividad planificado a tus usuarios.

Lista de Mantenimientos

Vista General

Los mantenimientos son eventos programados que pueden afectar la disponibilidad del servicio. A diferencia de los incidentes (no planificados), los mantenimientos se planifican por adelantado y se comunican proactivamente.

Ciclo de Vida del Mantenimiento

EstadoDescripción
ProgramadoPlanificado para el futuro
En ProgresoActualmente ocurriendo
CompletadoFinalizado exitosamente
CanceladoCancelado antes de comenzar

Transiciones Automáticas

ReliaPulse transiciona automáticamente los mantenimientos:

Programado → En Progreso (a la hora de inicio)
En Progreso → Completado (a la hora de fin, si auto-completar está habilitado)

Crear un Mantenimiento

  1. Navega a Dashboard > Mantenimientos
  2. Haz clic en "Programar Mantenimiento"
  3. Completa los detalles:

Información Básica

CampoDescripción
TítuloDescripción clara
Hora de InicioCuándo comienza el mantenimiento
Hora de FinFinalización esperada
Auto IniciarAuto-transicionar a la hora de inicio
Auto CompletarAuto-transicionar a la hora de fin

Componentes Afectados

  1. Selecciona componentes afectados por el mantenimiento
  2. Elige el estado durante el mantenimiento:
    • En Mantenimiento (recomendado)
    • Rendimiento Degradado
    • Interrupción Parcial

Descripción

Explica:

  • Qué trabajo se está realizando
  • Impacto esperado
  • Acciones necesarias por parte del usuario (si las hay)
  1. Haz clic en "Programar"

Actualizaciones de Mantenimiento

Añade actualizaciones durante el mantenimiento:

  1. Abre el mantenimiento
  2. Haz clic en "Añadir Actualización"
  3. Escribe la actualización:
    • Información de progreso
    • Cambios en la línea de tiempo
    • Problemas encontrados
  4. Haz clic en "Publicar Actualización"

Gestionar Mantenimientos

Iniciar Antes de Tiempo

Para iniciar mantenimiento antes de la hora programada:

  1. Abre el mantenimiento
  2. Haz clic en "Iniciar Ahora"
  3. Confirma

Extender

Si el mantenimiento toma más tiempo:

  1. Abre el mantenimiento
  2. Haz clic en "Extender"
  3. Ingresa nueva hora de fin
  4. Añade una actualización explicando la extensión

Completar Antes de Tiempo

Si el mantenimiento termina antes de lo programado:

  1. Abre el mantenimiento
  2. Haz clic en "Completar"
  3. Añade actualización de finalización
  4. Asegura que los componentes vuelvan a operacional

Cancelar

Para cancelar un mantenimiento programado:

  1. Abre el mantenimiento
  2. Haz clic en "Cancelar"
  3. Proporciona razón de cancelación
  4. Los suscriptores serán notificados

Mantenimientos Recurrentes

Los mantenimientos recurrentes pueden configurarse vía API.

Configura ventanas de mantenimiento regulares:

curl -X POST http://localhost:3000/api/v1/maintenances \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Mantenimiento Semanal de Base de Datos",
    "recurrence": {
      "frequency": "weekly",
      "dayOfWeek": 0,
      "startTime": "02:00",
      "duration": 60
    },
    "componentIds": ["component-id"]
  }'

Notificaciones

Los suscriptores son notificados:

  • Cuando el mantenimiento es programado
  • Cuando el mantenimiento comienza
  • Cuando se publican actualizaciones
  • Cuando el mantenimiento se completa o cancela

Aviso Anticipado

Configura notificaciones anticipadas:

  • 24 horas antes
  • 1 hora antes
  • A la hora de inicio

Visualización en Página de Estado

Mantenimientos Programados

Se muestra como un banner en la página de estado:

🔧 Mantenimiento Programado
Migración de Base de Datos
Programado para: 25 Ene, 2026 02:00 - 04:00 UTC

En Progreso

Durante el mantenimiento:

  • El banner de estado muestra "Mantenimiento en Progreso"
  • Los componentes afectados muestran estado de mantenimiento
  • Las actualizaciones en vivo aparecen cuando se publican

Después de Completar

  • El mantenimiento se mueve al historial
  • Se puede ver en "Mantenimientos Pasados"
  • Los componentes vuelven al estado normal

Acceso API

Listar Mantenimientos

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

Crear Mantenimiento

curl -X POST http://localhost:3000/api/v1/maintenances \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Actualización de Servidor",
    "description": "Actualizando servidores para mejorar rendimiento",
    "scheduledStartAt": "2026-01-25T02:00:00Z",
    "scheduledEndAt": "2026-01-25T04:00:00Z",
    "componentIds": ["comp-1", "comp-2"],
    "autoStart": true,
    "autoComplete": true
  }'

Actualizar Mantenimiento

curl -X PATCH http://localhost:3000/api/v1/maintenances/{id} \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "in_progress"
  }'

Añadir Actualización

curl -X POST http://localhost:3000/api/v1/maintenances/{id}/updates \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Actualización de servidor 50% completada"
  }'

Mejores Prácticas

Programación

  • Programa durante períodos de bajo tráfico
  • Da aviso anticipado adecuado (24-72 horas)
  • Ten en cuenta la zona horaria de tus usuarios
  • Deja tiempo extra para problemas inesperados

Comunicación

  • Sé específico sobre el impacto esperado
  • Proporciona alternativas si están disponibles
  • Actualiza regularmente durante el mantenimiento
  • Confirma la finalización prontamente

Pruebas

  • Prueba procedimientos de mantenimiento en staging
  • Ten un plan de rollback listo
  • Verifica que el monitoreo esté configurado correctamente

Documentación

  • Mantén registros de mantenimiento
  • Documenta lo que se hizo
  • Anota cualquier problema para referencia futura

Documentación Relacionada

IncidentesMonitores