# Servicios

## 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](https://lymen.app/docs/datos/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

1. Entrá a **Servicios** (grupo Observar del menú). Está disponible para Sistemas y Administración.
2. Elegí el período arriba a la derecha. El máximo es de 31 días.
3. Buscá un servicio por nombre en "Buscar servicio…", o filtrá por etiqueta (ver [Etiquetas](https://lymen.app/docs/datos/etiquetas/)).
4. Tocá una fila para abrir el detalle del servicio en una ventana.
5. Dentro del detalle, "Trazas y logs" te lleva a la lista de trazas de ese servicio (ver [Trazas](https://lymen.app/docs/datos/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](https://lymen.app/docs/datos/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](https://lymen.app/docs/datos/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](https://lymen.app/docs/datos/topologia/).

## 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-turnos` y 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.