Objetivos (SLO)
Definí promesas medibles de servicio, por ejemplo "el 99,9 % de los turnos se reservan bien", y mirá cuánto margen de error te queda. Si el margen se gasta muy rápido, Lymen abre un incidente.
En esta página
Para qué sirve#
Un objetivo de servicio (en inglés, SLO) es una promesa que se puede medir. Por ejemplo: "el 99,9 % de los pagos terminan bien" o "el 99 % de las pantallas cargan en menos de 2 segundos". Sirve para dejar de discutir sensaciones ("anda lento") y mirar un número.
Tres conceptos que se repiten en toda la pantalla:
| Concepto | Qué es |
|---|---|
| Indicador (SLI) | La medida en sí: los eventos que salieron bien sobre el total de eventos, en porcentaje. |
| Objetivo | El porcentaje que prometés. Por ejemplo 99,9 %. |
| Presupuesto de error | Lo que se puede fallar sin romper la promesa. Con 99,9 % se aguanta fallar 1 evento de cada 1.000. A medida que fallan eventos, el presupuesto se gasta; si se gasta todo antes de que termine el período, el objetivo no se cumple. |
Cuándo usarlo#
- Cuando querés acordar con el negocio qué significa "funciona bien".
- Para vigilar un servicio crítico (turnos, pagos, historia clínica) con un número claro.
- Para recibir un aviso cuando el servicio se degrada de a poco, algo que una regla fija no siempre detecta.
Quién puede qué#
| Rol | Qué puede hacer |
|---|---|
| Administración y Sistemas | Crear, editar, pausar y eliminar objetivos. |
| Negocio | Ver los objetivos y su estado. No puede modificarlos. |
Se pueden tener hasta 50 objetivos.
La lista#
Cada fila muestra: objetivo, servicio, Meta, Cumplimiento actual, Presupuesto que queda (barra) y Estado. Los más graves van primero.
| Estado | Qué significa |
|---|---|
| Cumpliendo | Va bien y queda margen. |
| En riesgo | Queda menos del 25 % del presupuesto, o se está gastando más rápido de lo permitido. |
| Presupuesto agotado | Ya se gastó todo el margen: el objetivo no se está cumpliendo. |
| Sin datos | Todavía no hubo eventos para calcular. No es lo mismo que cumplir al 100 %. |
Un objetivo con la marca Incidente abierto tiene una alerta de consumo activa; En pausa significa que no se está calculando.
El detalle#
Al abrir un objetivo ves:
| Dato | Qué es |
|---|---|
| Cumplimiento | El porcentaje de eventos buenos en el período (con los decimales necesarios, nunca "100 %" si no lo es). |
| Presupuesto que queda | Qué parte del margen sobra; puede ser negativo si ya te pasaste. También cuántos fallos se gastaron de los permitidos. |
| Velocidad de consumo (última hora) | Cuántas veces más rápido que lo permitido se está gastando. 1 = alcanza justo hasta el final del período; más de 1, no alcanza. |
| Se agota | Cuándo se acabaría el presupuesto con el ritmo de la última hora. |
| Alertas de consumo | Si están o no activas, y los incidentes que abrieron. |
Si el objetivo es nuevo, puede decir "Estamos juntando el historial": el cálculo se completa solo a medida que se acumulan datos.
Cómo crear un objetivo, paso a paso#
- Entrá a Cumplimiento › Objetivos (SLO) y tocá Nuevo objetivo.
- Qué querés cuidar: nombre, servicio y descripción.
- Cómo se mide: elegí el tipo de medida. Se arman solas las dos consultas (eventos buenos y totales).
- Tocá Ver cómo daría con las últimas 24 h para comprobar que mide lo que querés.
- Objetivo y período: el porcentaje y el período.
- Avisos: dejá activada la alerta de consumo rápido y guardá.
Campos#
1. Qué querés cuidar#
| Campo | Para qué sirve | Valor por defecto | Valores válidos | Impacto |
|---|---|---|---|---|
| Nombre | Cómo lo ves en la lista. | Vacío | 3 a 80 caracteres, sin llaves, $, <, > ni barra invertida; no puede repetirse |
Visible para todos los que ven el objetivo. |
| Servicio (opcional) | Servicio al que pertenece. | Ninguno (todo el sistema) | Un servicio que envíe datos | Cambia qué eventos cuenta el indicador y qué funcionalidades se ofrecen. |
| Descripción (opcional) | Para qué sirve y quién depende de él. | Vacío | Hasta 300 caracteres | Ninguno. |
2. Cómo se mide#
| Campo | Para qué sirve | Valor por defecto | Valores válidos | Impacto |
|---|---|---|---|---|
| Qué querés medir | El tipo de indicador. | Que funcione | Que funcione (pedidos sin error sobre todos los pedidos), Que sea rápido (pedidos bien y en menos del tiempo elegido), A medida (vos armás los dos números, como en Explorar) | "A medida" sirve para métricas, trazas, logs, eventos de negocio, chequeos o experiencia de usuarios, pero exige que sepas armar la consulta. |
| Sobre qué | La funcionalidad medida. | Todo el servicio | Las funcionalidades del servicio, o todo el servicio / todo el sistema | Medir "todo" mezcla partes de distinta importancia. |
| Tiempo máximo para que cuente como bueno (solo "rápido") | El umbral de lentitud. | 2 segundos | 200 ms, 500 ms, 1 s, 2 s, 5 s | Un tiempo muy exigente baja el cumplimiento y gasta presupuesto; muy laxo no detecta lentitud. |
| Eventos buenos | Los que salieron bien. | Se arma sola | Una consulta que dé un solo número (un conteo o una suma), sin agrupar y sin período | Si la modificás a mano, el próximo cambio de tipo, servicio o funcionalidad la vuelve a armar. |
| Eventos totales | Todos los que se tendrían que haber cumplido (incluye a los buenos). | Se arma sola | Igual que arriba | Si totales no incluye a los buenos, el indicador sale mal. |
| Ver cómo daría con las últimas 24 h | Probar el indicador. | — | Botón | Muestra el porcentaje, cuántos eventos buenos de cuántos totales y la serie por hora. No guarda nada ni avisa. |
3. Objetivo y período#
| Campo | Para qué sirve | Valor por defecto | Valores válidos | Impacto |
|---|---|---|---|---|
| Objetivo | Porcentaje prometido. | 99,9 % | 90 a 99,999 %, hasta 3 decimales (atajos: 99, 99,5, 99,9, 99,95) | Más alto: menos margen de error. Pasar de 99,9 a 99,99 reduce el margen a la décima parte. Un objetivo imposible genera avisos todo el tiempo. |
| Período | La ventana que se mide. | Últimos 30 días | Últimos 7, 28 o 30 días (móviles), Semana calendario (lunes a domingo) o Mes calendario | Los períodos móviles se renuevan cada día; los calendario se reinician al empezar la semana o el mes (el presupuesto vuelve a lleno). |
Debajo se ve cuánto margen significa tu objetivo: "Con 99,9 % se aguanta fallar 1 evento de cada 1.000".
4. Avisos#
| Campo | Para qué sirve | Valor por defecto | Valores válidos | Impacto |
|---|---|---|---|---|
| Avisar si el presupuesto se gasta muy rápido | Abre un incidente si el consumo se acelera. | Sí | Sí / No | Si lo apagás, el objetivo se sigue calculando pero nadie se entera de que se está degradando. Los incidentes se avisan con los perfiles de alerta y los flujos de siempre. |
| Objetivo activo | Si se calcula. | Sí | Sí / No | Pausado deja de calcularse y cierra sus incidentes. |
Cómo se decide que el consumo es "muy rápido": se miran dos ritmos a la vez.
| Alerta | Se mira | Se confirma en | Avisa si se gasta más de | Severidad |
|---|---|---|---|---|
| Consumo muy rápido | La última hora | Los últimos 5 minutos | 14,4 veces lo permitido | Alta |
| Consumo sostenido | Las últimas 6 horas | Los últimos 30 minutos | 6 veces lo permitido | Media |
Hacen falta al menos 20 eventos en el tramo largo para que se active, así un servicio con muy poco tráfico no genera falsas alarmas. El incidente se cierra solo cuando el ritmo vuelve a la normalidad.
Ejemplos#
| Objetivo | Tipo | Servicio / funcionalidad | Meta | Período |
|---|---|---|---|---|
| "Reserva de turnos sin errores" | Que funcione | Servicio de turnos | 99,9 % | Últimos 30 días |
| "Pantalla de turnos rápida" | Que sea rápido (2 s) | Servicio de turnos | 99 % | Últimos 7 días |
| "Pagos aprobados" | A medida | Eventos de pagos | 99,5 % | Mes calendario |
Problemas comunes#
- "Sin datos". Todavía no hubo eventos. Verificá que el servicio envíe datos y probá el indicador con las últimas 24 h.
- "Ya hay un objetivo con ese nombre". Los nombres no se pueden repetir.
- El indicador sale por debajo de lo esperado. Revisá que la consulta de eventos totales incluya a los buenos y que "Sobre qué" sea la funcionalidad correcta.
- Me avisa demasiado. Probablemente el objetivo es muy exigente para lo que el servicio entrega: bajá la meta o ampliá el período.
- No avisa y el presupuesto se agota. Fijate que "Avisar si el presupuesto se gasta muy rápido" esté activado y que algún perfil reciba incidentes de ese servicio.
- Alcanzaste el tope de 50 objetivos. Eliminá alguno que ya no uses.