Servidores e Infraestructura
Cómo ver el estado de tus servidores, qué muestra el detalle de cada uno y qué se puede cambiar desde ahí.
En esta página
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).
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. |
| 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. |
| 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. |
| Qué se captura de los pedidos | Cabeceras, parámetros y cuerpos que se guardan. Ver Instrumentación. |
| 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.
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 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 y las anomalías 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#
- Entrá a Observar › Infraestructura › Qué logs recibir.
- Elegí el grupo o el servidor.
- Cambiá las opciones que necesites (ver la tabla de abajo). Lo que no toques queda en Igual que el grupo o Igual que Lymen.
- Tocá Guardar.
- 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).
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. | 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). 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/*.logy revisá que el usuariolymen-agentpueda 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. | 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. |