# Infraestructura

## Para qué sirve

La pantalla **Infraestructura** muestra tus servidores (también llamados hosts): cuánta CPU, memoria y disco usan, si están reportando, qué aplicaciones corren en cada uno y cómo está el **agente** de Lymen que los mide. El agente es un programa liviano instalado en el servidor que manda sus métricas a Lymen. Una **métrica** es una medición que se repite en el tiempo, como el porcentaje de CPU usada cada minuto.

Esta guía cubre la consulta y el seguimiento. La instalación del agente se explica en otra guía.

## Quién la ve

- Todos los roles ven la tabla de servidores y el detalle rápido.
- Administración e IT ven además los agentes (estado, versión, actualización, procesos e inventario).
- Solo un administrador puede cambiar la configuración de un agente.

## Cuándo usarla

- Para saber si un servidor está al límite antes de que afecte a los usuarios.
- Cuando algo anda lento y querés ver si el servidor tiene la CPU, memoria o disco saturados.
- Para confirmar que un servidor nuevo ya está mandando datos.
- Para ver qué procesos y servicios corren en un servidor y con quién se conectan.
- Para controlar que los agentes estén al día.

## Lista de servidores

Entrás desde el menú **Infraestructura**. Arriba ves la cantidad de servidores, cuántos están sin datos ahora y el período elegido (hasta 31 días). Si tenés clusters de Kubernetes (un sistema que administra aplicaciones en contenedores), aparece además un selector para alternar entre servidores y clusters. Podés filtrar por etiqueta y, con **Elegir varios**, etiquetar varios servidores a la vez (ver [Etiquetas](https://lymen.app/docs/datos/etiquetas/)).

### Columnas

| Columna | Qué significa |
|---|---|
| Servidor | Nombre, nivel (si lo tiene), sistema operativo y arquitectura, y, para administración e IT, la versión del agente y su estado. |
| Estado | Semáforo de salud (ver abajo). |
| CPU | Porcentaje de procesador usado, con un gráfico del período. |
| Memoria | Porcentaje de memoria usada, con su gráfico. |
| Disco | Porcentaje de disco usado, con su gráfico. |

El número se pinta de color: sin color hasta 75 %, ámbar por encima de 75 % y rojo por encima de 90 %.

La lista viene ordenada con lo más urgente primero: críticos, después atención, luego los que funcionan bien y al final los que no reportan. Dentro de cada grupo, el más reciente primero.

### Cómo se calcula la salud

| Estado | Texto | Cuándo |
|---|---|---|
| Verde | Funciona bien | CPU, memoria y disco están en 75 % o menos. |
| Ámbar | Cerca del límite | Alguno de los tres supera 75 %. |
| Rojo | Al límite | Alguno de los tres supera 90 %. |
| Gris | Sin datos desde HH:MM | El servidor no mandó datos en los últimos 3 minutos. Se muestra atenuado y su gráfico termina donde se cortó. |

La salud toma el peor de los tres valores. Los valores son los del período elegido.

### Servidores sin métricas

Debajo de la tabla, administración e IT ven la sección **Agregados, todavía sin métricas**: agentes ya dados de alta que todavía no mandaron datos. Si ves ahí un servidor por mucho tiempo, el agente puede estar apagado o sin salida a Lymen.

## Detalle rápido de un servidor

Tocá una fila para abrir el detalle sin salir de la lista.

| Elemento | Qué significa |
|---|---|
| Nombre y estado | Con la leyenda de salud (por ejemplo "Funciona bien" o "Al límite"). |
| Línea del sistema | Por ejemplo "Linux · amd64 · 24 núcleos · 17 GB". Solo aparece lo que el servidor informa. |
| Último dato | Cuándo llegó lo último. |
| Etiquetas | Las del servidor. |
| CPU, Memoria, Disco | Uso con su gráfico. Se marca en alerta si supera 75 %. |
| Carga promedio | Cuántos procesos están esperando turno para usar el procesador, promediados en 1, 5 y 15 minutos. Se marca en alerta si el promedio de 1 minuto supera la cantidad de núcleos: el servidor está saturado. |
| Red recibida y Red enviada | Tráfico en bytes por segundo, sin contar el tráfico interno del propio servidor. |
| Qué corre acá | Las aplicaciones monitoreadas en ese servidor, con su salud y un link a [Servicios](https://lymen.app/docs/datos/servicios/). Si no hay, dice "No detectamos aplicaciones monitoreadas en este servidor". |
| Administrar agente | Para administración e IT: lleva al detalle del agente. |

Algunas tarjetas pueden no aparecer si el servidor no informa ese dato.

## Clusters de Kubernetes

Si tu instalación recibe métricas de Kubernetes, la vista de clusters muestra una tarjeta por cluster:

| Dato | Qué significa |
|---|---|
| Nodos | Cantidad de máquinas que forman el cluster. |
| Pods | Cantidad de pods (grupos de contenedores en ejecución), y cuántos están sin arrancar. |
| Reinicios | Reinicios de contenedores en la última hora. |

## Detalle del agente

Desde **Administrar agente** (administración e IT) entrás al detalle del servidor. Es una pantalla para seguir y administrar el agente.

### Lista de agentes

| Columna | Qué significa |
|---|---|
| Servidor | Nombre del servidor. |
| Estado | **Esperando conexión** (alta hecha, todavía no se conectó), **Conectado**, **Sin conexión** o **Quitado**. Se considera conectado si hubo contacto en los últimos 90 segundos. |
| Agente | Versión instalada. |
| Último contacto | Cuándo fue la última comunicación. |
| Rol | Si el servidor además hace de gateway. |
| Actualización | Estado de la actualización del agente (ver abajo). |

### Secciones del detalle

| Sección | Qué muestra |
|---|---|
| Datos | Sistema, versión del agente, último contacto, fecha de alta y versión del sistema. |
| Agente | El grupo al que pertenece y el botón **Reiniciar el agente**. |
| Gateway de la red | Si este servidor es gateway de otros. Un gateway es un servidor con salida a Lymen que sirve de puerta para los que no la tienen. No hace falta otro servidor aparte. |
| Gateways que usa | Qué gateways usa para enviar datos, en orden: si el primero no responde, pasa al siguiente. Hasta 5. Muestra también por dónde sale realmente cuando el agente lo confirma. |
| Actualización del agente | Versión actual y deseada, ventana de actualización y las últimas actualizaciones. |
| Historial | Qué cambios se hicieron en este servidor y quién los hizo. |
| Procesos, servicios y conexiones | El inventario (ver más abajo). |

Un servidor que solo llega a Lymen a través de gateways no puede quedarse sin el último. Si se instaló sin cifrado, la pantalla lo avisa: la clave y los datos viajan sin cifrar por tu red.

### Actualización del agente

El agente se actualiza solo, dentro de una ventana horaria, y vuelve a la versión anterior si la nueva no arranca bien.

Estados posibles: Al día, Versión fija, Actualización pendiente, Espera su turno, Actualizando, Volvió a la versión anterior, Versión frenada, Sin versión para este sistema, Actualización apagada y Sin datos de versión.

| Campo de la política | Valor por defecto | Valores válidos | Impacto |
|---|---|---|---|
| Actualizar el agente solo | Sí | Sí o no | Apagado, el agente se queda en la versión que tiene. |
| Canal | Estable | Estable o anticipado | El estable recibe las versiones ya probadas; el anticipado, las nuevas antes. |
| Ventana de actualización | Todos los días, de 01:00 a 05:00 | Horas HH:MM distintas entre sí y al menos un día | Solo se actualiza dentro de esta ventana. |
| Versión fija | Ninguna | Una versión válida | El agente se queda (o vuelve) en esa y no sigue al canal. |

La política puede definirse por servidor o por grupo; lo que no se define se hereda del grupo y, si no, de los valores por defecto. Los servidores de un grupo se actualizan por tandas, y los gateways de a uno, esperando que terminen los servidores que dependen de ellos.

Los botones **Actualizar ahora** (se actualiza ya, sin esperar la ventana; si no vuelve sano en unos minutos, regresa solo a la versión anterior) y **Cancelar la actualización** (solo si todavía no se entregó) quedan para el administrador.

## Procesos, servicios y conexiones (inventario)

El inventario muestra qué hay corriendo en el servidor. Lo manda el agente cada minuto. Para verlo, tocá **Ver inventario** en el detalle del agente. **Actualizar** vuelve a leerlo.

Un aviso arriba dice cuándo se actualizó. Si el último inventario tiene más de 5 minutos, avisa que el agente no lo está actualizando. Debajo aparecen las **tecnologías detectadas**.

Hay tres vistas: **Procesos**, **Servicios** y **Conexiones**, cada una con su cantidad.

| Vista | Columnas | Qué significa |
|---|---|---|
| Procesos | Proceso, CPU, Memoria, Instancias, Puertos | Los procesos se agrupan por programa. CPU y memoria son del grupo; Instancias es cuántas copias corren; Puertos son los que escuchan (se muestran hasta 4 y "y N más"). |
| Servicios | Servicio, Estado, Proceso, Puertos | Estado: Activo, Detenido o Con falla. |
| Conexiones | Proceso, Sentido, Con quién, Conexiones | Sentido: "Recibe" (alguien se conecta a este servidor) o "Se conecta" (este servidor llama a otro). "Con quién" muestra destino y puerto, o solo "Puerto N" para conexiones entrantes. |

Límites: se informan hasta 150 grupos de procesos, 150 servicios y 300 conexiones. Si hay más, se muestran los de mayor actividad y la pantalla avisa cuántos quedaron afuera.

**Privacidad.** El agente tapa contraseñas, claves, tokens y cadenas que parecen secretos en las líneas de comando antes de mandarlas (se ven como `***`), y Lymen vuelve a taparlas al recibirlas. Las líneas largas se recortan a 160 caracteres.

Los procesos y sus conexiones también se pueden ver en el mapa de [Topología](https://lymen.app/docs/datos/topologia/), con el interruptor "Procesos y conexiones". Esa capa la ven solo administración e IT.

## Ejemplo

El sistema de turnos de la clínica va lento. En **Infraestructura** el servidor de base de datos aparece en rojo (Al límite) con 93 % de memoria. Abrís el detalle rápido y ves la carga promedio por encima de los núcleos. Entrás a **Administrar agente**, abrís el inventario y ves que un proceso de la base de datos usa 14 GB. Ya sabés dónde buscar.

## Problemas comunes

- **Un servidor aparece gris ("Sin datos desde...")**: pasaron más de 3 minutos sin datos. Revisá que el servidor esté encendido, que el agente esté corriendo y que tenga salida a Lymen o a su gateway.
- **El agente figura "Sin conexión"**: no hubo contacto en los últimos 90 segundos. Suele ser un corte de red o un servidor apagado.
- **Un servidor está en "Agregados, todavía sin métricas"**: el agente se dio de alta pero todavía no mandó datos.
- **No veo el inventario**: el agente todavía no lo mandó (lo hace cada minuto; si es nuevo, esperá un momento).
- **"Qué corre acá" está vacío**: Lymen no detectó aplicaciones monitoreadas en ese servidor.
- **No veo la versión del agente ni "Administrar agente"**: esas secciones son solo para administración e IT.
- **El agente "Volvió a la versión anterior"**: la versión nueva no funcionó en ese servidor. No se reintenta sola; podés actualizar de nuevo a mano.
- **"Versión frenada"**: esa versión no volvió sana en otro servidor y no se despliega hasta que haya una nueva.