SLA

Configura y rastrea Acuerdos de Nivel de Servicio para tus componentes.

Vista General

Las configuraciones de SLA (Acuerdo de Nivel de Servicio) te ayudan a:

• Definir objetivos de uptime para componentes
• Rastrear cumplimiento contra objetivos
• Generar reportes de SLA
• Mostrar estado de SLA en dashboards

Crear una Configuración de SLA

1. Navega a Configuración > SLA
2. Haz clic en "Nuevo SLA"
3. Configura:

Configuración Básica

Selección de Componentes

Selecciona uno o más componentes a rastrear:

1. Bajo "Componentes", marca los componentes a incluir
2. El cumplimiento del SLA se calcula a través de todos los componentes seleccionados
3. Cualquier tiempo de inactividad de componente afecta el SLA general

Cálculo del SLA

Cálculo de Uptime

Uptime % = (Tiempo Total - Tiempo de Inactividad) / Tiempo Total × 100

Qué Cuenta Como Tiempo de Inactividad

Tiempo Excluido

Tiempo no contado contra SLA:

• Mantenimiento programado (si está configurado)
• Tiempo antes de creación del componente
• Ventanas de tiempo excluidas (si están configuradas)

Objetivos de SLA

Objetivos comunes de SLA:

Ver Estado de SLA

Vista de Dashboard

La sección de SLA muestra:

• Cumplimiento del período actual
• Días restantes en el período
• Minutos restantes en presupuesto
• Tendencia vs. período anterior

Vista de Componente

Cada página de componente muestra:

• Uptime de 24h/7d/30d/90d
• Estado de SLA si está configurado
• Eventos de tiempo de inactividad

Reportes de SLA

Genera reportes de cumplimiento:

1. Navega a Configuración > SLA
2. Selecciona una configuración de SLA
3. Haz clic en "Generar Reporte"
4. Selecciona período
5. Descarga como PDF o CSV

Contenido del Reporte

• Porcentaje de cumplimiento general
• Desglose por componente
• Eventos de tiempo de inactividad con timestamps
• Correlación con incidentes

Widgets de SLA

Muestra SLA en páginas de estado:

Widget de Gráfico de Uptime

Muestra uptime histórico con barras de colores:

• Verde: Sobre objetivo
• Amarillo: Bajo objetivo pero sobre mínimo
• Rojo: Bajo mínimo

Widget de Gauge de SLA

Indicador de progreso circular mostrando:

• Porcentaje de cumplimiento actual
• Línea de objetivo
• Color de estado

Acceso API

Listar SLAs

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

Crear SLA

curl -X POST http://localhost:3000/api/v1/sla \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "SLA de Producción",
    "target": 99.9,
    "period": "monthly",
    "componentIds": ["comp-1", "comp-2"]
  }'

Obtener Estado de SLA

curl http://localhost:3000/api/v1/sla/{id}/status \
  -H "Authorization: Bearer sk_live_xxx"

Respuesta:

{
  "current": 99.95,
  "target": 99.9,
  "isCompliant": true,
  "downtimeMinutes": 21.6,
  "remainingBudget": 21.4,
  "periodStart": "2026-01-01T00:00:00Z",
  "periodEnd": "2026-01-31T23:59:59Z"
}

Umbrales Personalizados de Uptime

Personaliza cómo se colorean los porcentajes de uptime:

1. Navega a Configuración > Organización
2. Configura "Umbrales de Visualización de Uptime":

Estos afectan visualizaciones en dashboard y página de estado.

Mejores Prácticas

Selección de Objetivo

• Sé realista basado en arquitectura
• Considera dependencias
• Documenta exclusiones claramente
• Revisa objetivos trimestralmente

Selección de Componentes

• Incluye componentes críticos orientados al usuario
• Agrupa componentes relacionados
• Excluye servicios no críticos

Monitoreo

• Establece alertas para aproximación a violación de SLA
• Revisa tendencias regularmente
• Investiga todos los eventos de tiempo de inactividad

Reportes

• Genera reportes mensuales
• Comparte con stakeholders
• Usa datos para impulsar mejoras

Documentación Relacionada

• Componentes - Rastrear uptime de componentes
• Monitores - Configurar health checks
• Incidentes - Rastreo de tiempo de inactividad