# Servidores e Infraestructura

## Para qué sirve

**Observar › Infraestructura** es la lista de todos tus servidores: cuáles están conectados, cómo andan de CPU, memoria y disco, y qué versión del agente tienen. Al abrir uno ves su detalle y lo administrás desde ahí: gateway, grupo, actualización y reinicio del agente. Desde **Qué logs recibir** decidís qué logs manda cada servidor o grupo. Nada de esto se toca en el servidor.

## Cuándo usarlo

- Después de instalar el agente, para confirmar que el servidor se conectó.
- Para saber qué servidor está al límite de recursos.
- Para activar un servidor como gateway, cambiarle el grupo o la política de actualización, o quitarlo.
- Para recibir más logs de un servidor mientras investigás un problema, o para dejar de recibirlos.

## La lista

Cada servidor muestra el estado de su agente y su salud:

| Estado del agente | Qué significa |
|---|---|
| **Esperando conexión** | Se registró con el código pero todavía no mandó datos. |
| **Conectado** | El agente está reportando. |
| **Sin conexión** | Estuvo conectado, pero hoy no reporta (apagado, sin red o con el servicio detenido). |
| **Quitado** | Alguien lo quitó desde el portal. |

La salud usa el uso de recursos (CPU, memoria, disco):

| Salud | Cuándo |
|---|---|
| **Funciona bien** | Hasta 75 % de uso. |
| **Cerca del límite** | Más de 75 %. |
| **Al límite** | Más de 90 %. |
| **Sin datos** | El servidor dejó de mandar datos; se muestra desde cuándo. |

La lista de agentes tiene estas columnas: **Servidor** (con el sistema y el grupo), **Estado**, **Agente** (versión), **Último contacto**, **Rol** (*Gateway*, o el gateway que usa) y **Actualización**. Si un servidor tiene una versión anticipada con política estable, aparece en rojo "Versión anticipada con política estable". Si tu cuenta usa Kubernetes, hay una pestaña **Kubernetes** (ver [Kubernetes](https://lymen.app/docs/instalacion/kubernetes/)).

## El detalle de un servidor

Se abre tocando el servidor. Tiene estas secciones:

| Sección | Qué muestra o permite |
|---|---|
| **Datos** | Sistema, versión del agente, último contacto, fecha de alta y versión del sistema operativo. |
| **Actualización del agente** | Cómo va la actualización, los botones **Actualizar ahora**, **Cancelar la actualización** y **Volver a la versión…**, y la política. Ver [Grupos y actualización](https://lymen.app/docs/instalacion/grupos-y-actualizacion/). |
| **Agente** | El **Grupo** del servidor y el botón **Reiniciar el agente**. |
| **Gateway de la red** | Interruptor **Este servidor es gateway** y su dirección. Ver [Gateways](https://lymen.app/docs/instalacion/gateways/). |
| **Gateways que usa** | La lista ordenada por donde sale y **Por dónde sale** (el gateway que está usando ahora). |
| **Procesos, servicios y conexiones** | El inventario del servidor (solo Linux). La línea de comando de cada proceso se enmascara para no mostrar claves. Topes: 150 grupos de procesos, 150 servicios y 300 conexiones agregadas. |
| **Agente avanzado** | Opcional. **Ver estado** dice si este servidor lo usa; si lo usa, desde acá se pausa o reanuda el monitoreo en detalle, se actualiza el inventario, se reinicia el agente y se rota su certificado. |
| **Monitoreo en detalle de aplicaciones** | Aplicaciones del servidor que podés medir por dentro. Ver [Instrumentación](https://lymen.app/docs/instalacion/instrumentacion-aplicaciones/). |
| **Qué se captura de los pedidos** | Cabeceras, parámetros y cuerpos que se guardan. Ver [Instrumentación](https://lymen.app/docs/instalacion/instrumentacion-aplicaciones/). |
| **Historial** | Quién cambió qué y cuándo: alta, gateway, grupo, política, actualizaciones, reinicios y cambios en los logs que recibe. |

Solo el rol Administración puede cambiar algo; Sistemas lo ve en modo lectura.

### Reiniciar el agente

**Agente › Reiniciar el agente** reinicia solo el agente; el servidor y sus aplicaciones no se tocan. No se pierden datos: lo que no pudo mandar, lo reintenta. Si no está disponible, el portal explica por qué al lado del botón. Ya pedido, dice **Reinicio pedido** y el agente lo toma en unos segundos.

### Quitar un servidor

El botón **Quitar servidor**, al pie del detalle, revoca la identidad del agente: deja de poder mandar datos y **no se puede deshacer**. Para volver a conectarlo hay que reinstalar el agente con un código nuevo. Si otros servidores lo usan como gateway, el portal te avisa y los saca de su lista. Esto no desinstala el programa del equipo: para eso mirá [Desinstalar](https://lymen.app/docs/instalacion/desinstalar/).

## Qué logs recibir

### Para qué sirve

Las **métricas** y las **trazas** de tus servidores llegan siempre completas. Los **logs** (los mensajes que escriben el sistema y las aplicaciones) son otra cosa: la mayoría son informativos y ocupan mucho lugar. Por eso Lymen los pide **a demanda**: cada servidor manda solo los que elegís, y el filtro se hace **en el propio servidor, antes de que el dato salga**. Lo que no elegiste no viaja ni se guarda.

La pantalla está en **Observar › Infraestructura › Qué logs recibir**.

### Qué se recibe si no tocás nada: solo errores

Un servidor recién instalado manda, desde el primer segundo:

| Qué | Linux | Windows |
|---|---|---|
| Registro del sistema | Solo errores, críticos, alertas y emergencias. | Registros **Sistema** y **Aplicación**, solo los de nivel **Error** y **Crítico**. |
| Logs de las aplicaciones instrumentadas del servidor | Solo errores (y más graves). | Solo errores (y más graves). |
| Métricas y trazas | Todas. | Todas. |
| Eventos de negocio | Siempre, sin filtro. | Siempre, sin filtro. |

Este valor (el de Lymen) vale para todos los servidores que no tengan algo propio, también para los que ya estaban conectados.

**Qué te perdés con "Solo errores".** En [Explorar](https://lymen.app/docs/datos/explorar/) no vas a encontrar los mensajes informativos del sistema ni de las aplicaciones (por ejemplo, "servicio iniciado" o los accesos). Un servidor sano puede no mandar ningún log por un buen rato, porque no tiene errores que contar: es normal. Las alertas de reinicio del servidor, los [incidentes](https://lymen.app/docs/operacion/incidentes/) y las [anomalías](https://lymen.app/docs/operacion/anomalias/) no dependen de los logs (usan métricas): siguen funcionando igual.

### Por servidor o por grupo

Podés fijar los logs para un **grupo** (vale para todos sus servidores) o para un **servidor** puntual. Cada opción se hereda por separado:

- En un servidor, cada opción puede quedar en **Igual que el grupo**: toma lo del grupo y, si el grupo no fija nada, lo de Lymen.
- En un grupo, cada opción puede quedar en **Igual que Lymen**: toma el valor de Lymen (solo errores).

Así podés, por ejemplo, subir a **Todo** solo el nivel del registro del sistema de un servidor y dejar el resto como en su grupo.

### Paso a paso

1. Entrá a **Observar › Infraestructura › Qué logs recibir**.
2. Elegí el grupo o el servidor.
3. Cambiá las opciones que necesites (ver la tabla de abajo). Lo que no toques queda en **Igual que el grupo** o **Igual que Lymen**.
4. Tocá **Guardar**.
5. Mirá el estado de cada servidor afectado: la pantalla te dice si el cambio ya se aplicó, si se está aplicando o si el servidor está sin conexión (en ese caso lo toma cuando vuelva).

Al guardar, el agente de cada servidor afectado **se reinicia una vez** para tomar el cambio. Tarda unos segundos y no se pierden datos: lo que no pudo mandar en ese momento, lo manda después. El servidor y sus aplicaciones no se tocan.

Solo el rol **Administración** puede cambiar estas opciones; **Sistemas** las ve en modo lectura. Cada cambio queda en el **Historial** del servidor, con quién lo hizo y qué había antes.

Los clusters de Kubernetes no aparecen en esta pantalla: sus logs se eligen al instalar (ver [Kubernetes](https://lymen.app/docs/instalacion/kubernetes/#que-datos)).

### Campos

| Campo | Para qué sirve | Por defecto (Lymen) | Valores válidos | Impacto de cambiarlo |
|---|---|---|---|---|
| **Recibir logs** | Prende o apaga todos los logs del servidor. | Recibir logs | **Recibir logs** / **No recibir logs** | Con **No recibir logs** no llega ningún log: ni del sistema, ni de archivos, ni de las aplicaciones. Las métricas, las trazas y los eventos de negocio siguen llegando. |
| **Nivel del registro del sistema** | Qué mensajes del registro del sistema se mandan. | Solo errores | **Solo errores** / **Advertencias y errores** / **Todo** | En Linux, *Solo errores* son errores, críticos, alertas y emergencias; *Advertencias y errores* suma las advertencias; *Todo* suma también los avisos y los mensajes informativos (los de depuración no). En Windows, *Solo errores* son Error y Crítico; *Advertencias y errores* suma Advertencia; *Todo* manda todo. Subir el nivel trae más contexto, pero más volumen y más espacio usado. |
| **Servicios del sistema** (solo Linux) | Limita el registro del sistema a ciertos servicios del sistema (por ejemplo `nginx` o `postgresql`). | Vacío: todos los servicios, con el nivel elegido. | Hasta 30 nombres, sin repetir. Letras, números y `@ _ . : -`. | Con nombres, solo llegan los mensajes de esos servicios: lo de los demás no se manda, aunque sea un error. |
| **Archivos de log** (solo Linux) | Suma archivos de log puntuales que no pasan por el registro del sistema (por ejemplo, el de una aplicación que escribe en un archivo propio). | Ninguno | Hasta 20 rutas absolutas bajo `/var/log`, `/opt`, `/srv`, `/home`, `/var/www`, `/usr/local` o `/var/lib`. Se permite un `*` en el nombre del archivo (por ejemplo `/var/log/miapp/*.log`). | Estos archivos se mandan **enteros**, sin filtro de nivel: los elegiste vos. Se leen desde el momento en que los agregás (lo anterior no se manda). El usuario del agente (`lymen-agent`) tiene que poder leerlos; si no, no llega nada de ese archivo. Un archivo muy activo puede sumar mucho volumen. |
| **Registros de Windows** (solo Windows) | Qué registros del Visor de eventos se leen. | **Sistema** y **Aplicación** | **Sistema**, **Aplicación**, **Seguridad**, **Setup** u otros canales por su nombre (por ejemplo `Microsoft-Windows-PowerShell/Operational`). Hasta 15, sin repetir. | A todos se les aplica el **Nivel del registro del sistema**. **Seguridad** puede tener mucho volumen y datos de los inicios de sesión de las personas: sumalo solo si lo necesitás. |
| **Nivel de los logs de las aplicaciones** | Qué logs se mandan de las aplicaciones del servidor con [monitoreo en detalle](https://lymen.app/docs/instalacion/instrumentacion-aplicaciones/). | Solo errores | **Solo errores** / **Advertencias y errores** / **Todo** | Con *Todo* llegan también los mensajes informativos y de depuración de tus aplicaciones: más contexto, más volumen y más chance de que aparezcan datos personales (revisá [Privacidad](https://lymen.app/docs/datos/privacidad/)). Los eventos de negocio llegan siempre, con cualquier nivel. |

### Ejemplos

- **Investigar un problema en un servidor.** Subí **Nivel del registro del sistema** y **Nivel de los logs de las aplicaciones** a **Todo** solo en ese servidor. Cuando termines, volvé a **Igual que el grupo**.
- **Un servidor de pruebas que no te interesa.** **No recibir logs** en ese servidor: seguís viendo sus métricas y trazas.
- **Una aplicación que escribe en su propio archivo.** En **Archivos de log**, agregá `/opt/miapp/logs/*.log` y revisá que el usuario `lymen-agent` pueda leer esa carpeta.
- **Auditar los inicios de sesión de un Windows.** Sumá **Seguridad** a **Registros de Windows** en ese servidor.

## Campos que se guardan con la barra de la pantalla

Estos cambios se guardan juntos con la barra de abajo (**Cancelar** y **Guardar**). Mientras haya un campo inválido, la barra dice qué falta y **Guardar** queda deshabilitado.

| Campo | Para qué sirve | Por defecto | Valores válidos | Impacto de cambiarlo |
|---|---|---|---|---|
| **Este servidor es gateway** | Convierte al servidor en gateway de otros. | Apagado | Encendido / apagado | Los servidores que lo usen dependen de él: si se apaga, pierden su salida. No se puede apagar mientras otros lo usan. |
| **Dirección dentro de tu red** | Dirección que usan los otros servidores para llegar a este gateway. | — | `host` o `host:puerto`, hasta 260 caracteres. Sin puerto, se usa el 4390. | Si está mal, los servidores no lo alcanzan. |
| **Gateways que usa** | Lista ordenada de gateways de este servidor. | Vacía: sale directo | Hasta 5 | Cambia por dónde salen sus datos. Un servidor sin salida directa no puede quedarse sin el último. |
| **Grupo** | Grupo del servidor. | Sin grupo | Un grupo existente | Cambia la política de actualización que hereda y la etiqueta `grupo` de filtros y reglas. |
| **Actualización del agente** (política) | Ver [Grupos y actualización](https://lymen.app/docs/instalacion/grupos-y-actualizacion/). | Igual que el grupo | — | Cambia cuándo y a qué versión se actualiza. |

## Problemas comunes

| Síntoma | Qué hacer |
|---|---|
| Un servidor figura *Sin conexión* | Revisá que el servicio del agente esté corriendo y que el servidor tenga salida (o su gateway esté encendido). |
| "Todavía no confirmó que esté enviando por el gateway" | El servidor está apagado o tiene una versión vieja del agente. Esperá unos minutos o actualizalo. |
| "Lo usa N servidores: cambiales el gateway primero" | Antes de apagar un gateway, sacalo de la lista de los servidores que lo usan. |
| "Solo puede ser gateway un servidor conectado y con salida a Lymen" | El servidor tiene que estar *Conectado* y llegar directo a Lymen. |
| "Una cadena de gateways puede tener hasta 5 saltos" / ciclo de gateways | Rearmá las listas para que no formen un círculo ni pasen de 5 gateways encadenados. |
| En Explorar no veo los mensajes informativos de un servidor | Con el valor de Lymen (**Solo errores**) no se mandan. Subí el nivel en **Qué logs recibir**. |
| Un servidor sano no manda ningún log | Es normal con **Solo errores**: no tiene errores que mandar. Sus métricas y trazas llegan igual. |
| Agregué un archivo de log y no llega nada | Revisá que la ruta exista, que esté bajo una de las carpetas permitidas y que el usuario `lymen-agent` pueda leerla. Solo llega lo que se escribe después de agregarlo. |
| El cambio de logs no figura aplicado en un servidor | Si está sin conexión, lo toma cuando vuelva. Si está conectado y no lo toma en un par de minutos, escribinos a hola@lymen.app. |