Conceptos Básicos
Entender los conceptos clave en ReliaPulse te ayudará a usar la aplicación de manera efectiva.
Organizaciones
Una Organización es la entidad de nivel superior que contiene todos los datos de tu página de estado. Las organizaciones proporcionan:
- Multi-tenancy: Cada organización tiene sus propios componentes, incidentes, páginas de estado y configuraciones
- Colaboración en equipo: Múltiples usuarios pueden pertenecer a una organización con diferentes roles
- Aislamiento: Los datos están completamente separados entre organizaciones
Roles de Usuario
| Rol | Permisos |
|---|---|
| Owner | Acceso completo, puede eliminar organización, gestionar facturación |
| Admin | Acceso completo excepto eliminación de organización |
| Member | Crear y gestionar incidentes, componentes, mantenimientos |
| Viewer | Acceso de solo lectura al dashboard |
Un usuario puede pertenecer a múltiples organizaciones y cambiar entre ellas.
Componentes
Los Componentes representan los servicios, sistemas o infraestructura que quieres rastrear y mostrar en tu página de estado.
Tipos de Componentes
Los componentes usan un modelo polimórfico con tres tipos, cada uno con diferentes capacidades.
| Tipo | Descripción | Caso de Uso |
|---|---|---|
| SERVICE | Estado controlado manualmente | Agrupaciones lógicas, servicios externos que no monitoreas |
| ENDPOINT | Health checks HTTP con auto-incidentes | APIs, sitios web, endpoints de salud |
| METRIC | Métricas externas de integraciones | Métricas de Datadog, Prometheus, New Relic |
Jerarquía de Componentes
Los componentes pueden organizarse jerárquicamente:
├── Servicios Backend (SERVICE - grupo)
│ ├── API Gateway (ENDPOINT)
│ ├── Autenticación (ENDPOINT)
│ └── Cluster de Base de Datos (SERVICE)
│ ├── DB Principal (METRIC - uso de CPU)
│ └── DB Réplica (METRIC - lag de replicación)
└── Frontend (SERVICE - grupo)
├── App Web (ENDPOINT)
└── CDN (SERVICE)Estados de Componentes
| Estado | Icono | Descripción |
|---|---|---|
| Operacional | 🟢 | El servicio está funcionando normalmente |
| Rendimiento Degradado | 🟡 | El servicio está lento o parcialmente afectado |
| Interrupción Parcial | 🟠 | Alguna funcionalidad no está disponible |
| Interrupción Mayor | 🔴 | El servicio está completamente no disponible |
| En Mantenimiento | 🔵 | Mantenimiento planificado en progreso |
Incidentes
Los Incidentes representan interrupciones de servicio o problemas que afectan a tus usuarios.
Ciclo de Vida del Incidente
┌─────────────┐ ┌──────────────┐ ┌──────────────┐
│ Investigando│ ──► │ Identificado │ ──► │ Monitoreando │
└─────────────┘ └──────────────┘ └──────────────┘
│
▼
┌──────────────┐
│ Resuelto │
└──────────────┘| Estado | Descripción |
|---|---|
| Investigando | Problema reportado, el equipo está investigando |
| Identificado | Causa raíz encontrada, trabajando en la solución |
| Monitoreando | Solución aplicada, monitoreando estabilidad |
| Resuelto | Problema completamente resuelto |
Componentes del Incidente
Cada incidente puede afectar uno o más componentes. Cuando creas un incidente:
- Selecciona los componentes afectados
- Elige el nivel de impacto para cada componente
- Los componentes actualizan automáticamente su estado
Actualizaciones de Incidentes
Añade actualizaciones para mantener informados a los usuarios:
- Cada actualización tiene un estado (Investigando, Identificado, etc.)
- Las actualizaciones se muestran cronológicamente en la página de estado
- Los suscriptores reciben notificaciones por cada actualización
Postmortems
Después de resolver un incidente, puedes añadir un postmortem:
- Análisis de causa raíz - Qué salió mal
- Resumen de impacto - Quién/qué fue afectado
- Línea de tiempo - Secuencia de eventos
- Acciones - Pasos para prevenir recurrencia
Mantenimientos
Los Mantenimientos son eventos programados que pueden afectar la disponibilidad del servicio.
Estados de Mantenimiento
| Estado | Descripción |
|---|---|
| Programado | El mantenimiento está planificado para el futuro |
| En Progreso | El mantenimiento está ocurriendo actualmente |
| Completado | El mantenimiento finalizó exitosamente |
Transiciones Automáticas
ReliaPulse transiciona automáticamente los mantenimientos:
- Programado → En Progreso: Cuando se alcanza la hora de inicio
- En Progreso → Completado: Cuando se alcanza la hora de fin (si auto-completar está habilitado)
Páginas de Estado
Una Página de Estado es una página pública que muestra el estado de tus servicios.
Características Clave
- URL personalizada: Cada página tiene un slug único (ej.,
/status/mi-empresa) - Múltiples páginas: Crea diferentes páginas para diferentes audiencias
- Widgets: Componentes arrastrables como tarjetas de estado, gráficos de uptime, feeds de incidentes
- Branding: Logos, colores y temas personalizados
- Visibilidad: Pública, privada (contraseña) o borrador
Tipos de Widgets
| Widget | Descripción |
|---|---|
| Resumen de Estado | Estado general del sistema con indicador de color |
| Lista de Componentes | Lista de componentes con estado actual |
| Tabla de Infraestructura | Vista jerárquica con sparklines y métricas |
| Gráfico de Uptime | Visualización histórica de uptime |
| Feed de Incidentes | Lista de incidentes activos y recientes |
| Gráfico de Métricas | Mostrar métricas de integraciones |
| HTML Personalizado | Incrustar contenido personalizado |
Monitores
Los Monitores son health checks automatizados para componentes ENDPOINT.
Cómo Funciona el Monitoreo
- El worker ejecuta checks a intervalos configurados (ej., cada 60 segundos)
- Cada check evalúa condiciones (código de estado, tiempo de respuesta, JSON path)
- Los fallos disparan alertas y opcionalmente crean incidentes
- La recuperación limpia las alertas y resuelve incidentes auto-creados
Condiciones del Monitor
| Condición | Descripción |
|---|---|
| Código de Estado | Código de respuesta HTTP (ej., igual a 200) |
| Tiempo de Respuesta | Respuesta más rápida que umbral (ej., < 500ms) |
| JSON Path | Afirmar valores en respuesta JSON |
| Contiene | El cuerpo de respuesta contiene texto |
Suscriptores
Los Suscriptores son usuarios que quieren recibir notificaciones sobre cambios de estado.
Canales de Suscripción
| Canal | Descripción |
|---|---|
| Notificaciones por email | |
| SMS | Notificaciones por mensaje de texto |
| Webhook | HTTP POST a URL personalizada |
| RSS/Atom | Suscripciones a feeds |
Qué Reciben los Suscriptores
- Notificaciones de nuevos incidentes
- Actualizaciones de incidentes
- Resoluciones de incidentes
- Anuncios de mantenimiento programado
- Cambios de estado de mantenimiento
Integraciones
Las Integraciones conectan ReliaPulse con sistemas externos de monitoreo y métricas.
Integraciones Soportadas
| Integración | Tipo | Descripción |
|---|---|---|
| Datadog | Métricas | Obtener métricas y crear componentes METRIC |
| Prometheus | Métricas | Consultar métricas de Prometheus |
| New Relic | Métricas | Obtener métricas de New Relic |
| Grafana | Métricas | Consultar fuentes de datos de Grafana |
| Pingdom | Métricas | Obtener resultados de checks de Pingdom |
Flujo de Métricas
Integración → Consulta de Métricas → Polling (Worker) → Puntos de Datos → VisualizaciónPróximos Pasos
Ahora que entiendes los conceptos: