Servicios
El estado de cada servicio de tu sistema (por ejemplo, el sitio de turnos o la API de pagos), su detalle, sus operaciones y el mapa de quién llama a quién.
En esta página
Para qué sirve#
Un servicio es una pieza de software tuya que atiende pedidos: el sitio de turnos, la API de pagos, el sistema de historia clínica. Esta pantalla lista cada servicio que Lymen detectó, con una semaforización simple: ¿responde rápido?, ¿tiene errores?, ¿cuántos pedidos recibe?
Un pedido es una consulta que le llega al servicio, por ejemplo "dame los turnos libres del jueves".
Cuándo usarla#
- El Resumen marca atención o crítico y querés saber cuál servicio es.
- Un usuario dice que "algo anda lento" y querés ver cuál servicio responde peor.
- Querés saber de quién depende un servicio antes de apagarlo o actualizarlo.
Los servicios aparecen solos: cuando una aplicación tuya manda datos de sus pedidos, Lymen la lista. No se dan de alta a mano. Para conectar aplicaciones, mirá la sección de instalación.
Cómo se usa, paso a paso#
- Entrá a Servicios (grupo Observar del menú). Está disponible para Sistemas y Administración.
- Elegí el período arriba a la derecha. El máximo es de 31 días.
- Buscá un servicio por nombre en "Buscar servicio…", o filtrá por etiqueta (ver Etiquetas).
- Tocá una fila para abrir el detalle del servicio en una ventana.
- Dentro del detalle, "Trazas y logs" te lleva a la lista de trazas de ese servicio (ver Trazas).
La tabla de servicios#
| Columna | Qué significa | Cómo se calcula | Impacto / cómo leerla |
|---|---|---|---|
| Servicio | Nombre del servicio. | El que manda la propia aplicación. | Si cambia el nombre en la aplicación, aparece como un servicio nuevo. |
| Estado | Semáforo del servicio. | Ver tabla de estados abajo. | Amarillo y rojo se reflejan en el Resumen. |
| Responde en | Tiempo de respuesta "p95": el 95 % de los pedidos responde en este tiempo o menos. | Del período elegido. | Mira los casos lentos, no el promedio. Un p95 de 2 s significa que 1 de cada 20 pedidos tarda más de 2 s. |
| Errores | Porcentaje de pedidos que terminaron en error. | Pedidos con error sobre el total. | Rojo arriba del 5 %, amarillo arriba del 1 %. |
| Pedidos/min | Cuántos pedidos por minuto recibe. | Del período elegido. | Sirve para dimensionar: una baja brusca puede significar que algo dejó de llegar. |
En cada fila también hay un gráfico chico de evolución. Si hubo ventanas de mantenimiento en el período, se ven rayadas en los gráficos.
Estados de un servicio#
| Estado | Condición | Texto que ves |
|---|---|---|
| Bien | Errores hasta 1 % y p95 hasta 800 ms. | "Funciona bien" |
| Atención | Errores mayores a 1 % o p95 mayor a 800 ms. | "Más errores de lo normal" o "Más lento de lo normal" |
| Crítico | Errores mayores a 5 % o p95 mayor a 2 segundos. | "Con errores" o "Muy lento" |
| Sin datos | Sin pedidos en el período. | "Sin tráfico" |
Si un servicio dejó de mandar datos, la fila dice "Sin datos desde HH:MM" y los números se ven atenuados.
Estos umbrales son fijos y valen para todos los servicios. Para avisos a medida, usá las reglas de alerta.
Detalle de un servicio#
Al abrir un servicio ves:
| Bloque | Qué muestra |
|---|---|
| Gráficos | "Responde en" (rojo si pasa de 2 s), "Errores" (rojo si pasa de 5 %) y "Pedidos por minuto". |
| Operaciones | Cada acción que hace el servicio (por ejemplo GET /turnos), con cuánto tarda y qué porcentaje falla. |
| Con quién habla | "Lo llaman": quién le pide cosas. "Llama a": a quién le pide cosas (bases de datos, otros servicios, servicios externos). |
| Incidentes abiertos | Incidentes sin resolver que afectan a este servicio. |
| Etiquetas y nivel | Las etiquetas del servicio y su nivel de importancia. Se editan acá o en Etiquetas. |
| Trazas | Los últimos pedidos del servicio. Se filtran por Todas, Con error o Lentas. |
"Lentas" son las trazas que tardaron al menos lo mismo que el p95 del servicio en el período. Si no hay dato, se usa 800 ms.
Una traza es el recorrido completo de un pedido, paso por paso. Más en Trazas.
Mapa de dependencias#
Dentro del detalle hay un mapa chico, y el enlace "Ver mapa completo" abre todo el mapa de servicios. Se lee de izquierda a derecha: primero los que reciben pedidos de afuera, después a quiénes llaman.
- Punto verde: funciona bien. Punto rojo: con errores.
- Línea punteada: servicio externo (por ejemplo, la pasarela de pagos de un tercero).
- Tocá un nodo para centrarlo. "Ajustar" encuadra todo el mapa.
- "Ver servicio" en un nodo abre su detalle.
- Si hay un incidente abierto, el servicio señalado como causa lleva la marca "CAUSA DEL INCIDENTE".
Para ver todo tu entorno (servidores, aplicaciones, bases de datos, equipos de red), usá Topología.
Campos y filtros de la pantalla#
| Elemento | Para qué sirve | Valor por defecto | Valores válidos | Impacto |
|---|---|---|---|---|
| Período | Ventana de tiempo. | Últimas 24 horas | Hasta 31 días | Solo lectura. Un período largo suaviza picos cortos. |
| Buscar servicio | Filtra la tabla por nombre. | Vacío | Texto libre | Solo lectura. |
| Filtro por etiqueta | Muestra solo los servicios con ciertas etiquetas. | Sin filtro | Etiquetas en uso | Solo lectura. También permite seleccionar varios servicios. |
| Filtro de trazas | Filtra las trazas del detalle. | Todas | Todas, Con error, Lentas | Solo lectura. |
La pantalla no modifica nada de tu sistema: es de consulta.
Ejemplos#
- El Resumen dice "web-turnos está más lento de lo habitual": abrí Servicios, buscá
web-turnosy mirá "Responde en". Después, en Operaciones, buscá cuál operación tarda más. - Antes de apagar la base de datos de pagos: abrí el servicio de pagos, mirá "Llama a" y verificá quién más depende de ella en el mapa.
Problemas comunes#
- No veo un servicio que debería estar: ese servicio no mandó pedidos en el período. Probá con un período más largo y revisá que la aplicación esté conectada.
- Todo dice "Sin tráfico": ninguna aplicación mandó datos de pedidos en ese período.
- Un servicio aparece duplicado con otro nombre: la aplicación cambió el nombre con el que se identifica.
- El estado es amarillo pero los usuarios no se quejan: los umbrales son estrictos a propósito para avisar con tiempo. Revisá si es un pico aislado achicando el período.
- No veo la pantalla: Servicios es para Sistemas y Administración.