Agregar datos

Para qué sirve#

Configuración › Conexiones › Agregar datos es el punto de partida para conectar tu infraestructura a Lymen. Reúne en tarjetas el alta de servidores, gateways, equipos de red, grupos y clusters de Kubernetes. Solo la ve el rol Administración.

Todo se configura desde acá: el portal arma los comandos completos, con todas las opciones que elegiste. No hace falta editar archivos ni agregar variables a mano.

Lo que ya conectaste se mira y se administra en Observar › Infraestructura y Observar › Equipos de red; esta pantalla es para el alta.

Cuándo usarla#

• Vas a conectar un servidor nuevo.
• Necesitás un comando de instalación nuevo (los códigos vencen).
• Querés crear un grupo, revisar tus gateways o ver qué rangos de red aprobaste.
• Vas a conectar un cluster de Kubernetes, o querés revocar la credencial de uno.

Cómo se usa#

Arriba aparece un aviso con lo que conviene hacer ahora, según lo que ya tengas:

Debajo están las tarjetas.

Paso 1: Servidores#

Máquinas físicas o virtuales donde corre el agente. El estado muestra cuántos están conectados.

1. Tocá Agregar servidor.
2. (Opcional) Elegí gateways y un grupo, y tildá Instalar también el monitoreo en detalle si querés medir tus aplicaciones por dentro (ver la tabla de campos más abajo).
3. Tocá Generar comando.
4. Elegí la pestaña Linux o Windows y tocá Copiar.
5. Pegalo en una consola del servidor con permisos de administrador. Los detalles están en Linux y Windows.
6. Dejá abierto el diálogo: cuando el servidor se conecta, aparece "Servidor conectado: nombre". Tocá Listo.

El código del comando vale una sola vez, vence a las 24 horas y no se vuelve a mostrar. Si lo perdés, generá otro.

Si hay comandos que nadie usó, la tarjeta muestra el botón N códigos sin usar: ahí ves quién generó cada uno y cuándo vence, y podés descartarlo con Anular. Anulá los que ya no necesites: un código vigente sirve para dar de alta un servidor.

Paso 2: Gateways#

Un gateway es un servidor de tu red, con salida a internet, que reenvía los datos de los demás. La tarjeta se habilita cuando ya tenés al menos un servidor. Los gateways no se crean acá sino en el detalle del servidor: tocá Elegir un servidor, abrí el que quieras en Infraestructura y activá Este servidor es gateway (ver Gateways).

Con Ver gateways ves la lista: dirección, si está Conectado, si el enlace está cifrado y si tiene Sin salida directa. Administrar abre el detalle de ese servidor.

Paso 3: Equipos de red#

Switches, routers, firewalls y puntos de acceso, consultados por un gateway. Dice Bloqueado hasta que exista un gateway. Tiene tres acciones: Agregar equipo, Buscar en un rango y Qué aprobaste (lo que cada gateway permite consultar). Ver Equipos de red.

Opcional: Grupos de servidores#

Reúnen servidores con la misma política de actualización y sirven de filtro en reglas y dashboards. Cada servidor está en un solo grupo. Se crean con Nuevo grupo y se administran con Ver grupos. Ver Grupos y actualización.

Opcional: Kubernetes#

Para clusters de Kubernetes, que se conectan con el operador de Lymen en lugar del comando de una línea. La tarjeta muestra los clusters que ya tienen credencial, con su distribución y su estado (Esperando conexión, Conectado o Sin conexión), y para cada uno los botones Configuración, Rotar credencial y Revocar.

1. Tocá Agregar cluster.
2. Escribí el Nombre del cluster (es como lo vas a ver en Observar › Kubernetes) y elegí la Distribución.
3. Elegí desde dónde vas a cambiar qué datos se mandan (Desde el portal, recomendado, o Desde el cluster si usás GitOps), qué namespaces monitorear, qué logs de los contenedores y qué eventos recibir, y si querés el monitoreo en detalle de las aplicaciones. Lo avanzado (recursos, réplicas, ubicación, registro propio y proxy) está plegado. Si no tocás nada: todos los namespaces menos los del sistema y el de Lymen, Solo errores y eventos de advertencia.
4. Tocá Generar.
5. Copiá y corré, en una consola con acceso al cluster (kubectl y Helm), los tres pasos que arma el portal: instalar el operador, guardar la credencial como Secret y aplicar el LymenKube.
6. Tocá Listo.

La credencial es propia de ese cluster y no se vuelve a mostrar. Si la perdés, rotala: Rotar credencial genera otra para el mismo cluster y la anterior sigue valiendo 24 horas. Con Revocar (pide confirmación) el cluster deja de enviar datos en el momento; los datos que ya llegaron se conservan.

Para cambiar después los namespaces, los logs, los eventos o la captura de cuerpos, tocá Configuración: llega sola al cluster, sin correr nada. Ver Kubernetes.

Aparte: Sitios web y apps#

Se miden desde Observar › Aplicaciones (botón Ir a Aplicaciones), con su propio paso a paso. Ver Aplicaciones.

Campos del diálogo "Agregar servidor"#

Servidor que ya está conectado. Para sumarle el monitoreo en detalle, generá el comando con la casilla tildada (y los mismos gateways y grupo) y corrélo de nuevo en ese servidor: se reinstala sobre el mismo servidor, que conserva su grupo, su política y su historial.

Si elegís un gateway que todavía no publicó su certificado, Generar comando queda deshabilitado. El gateway lo publica solo, un minuto después de arrancar: esperá o, si no puede tener certificado, tildá Sin cifrar.

Ejemplo#

Comandos que genera el portal para un servidor que sale directo a Lymen, en el grupo produccion (el código y la cuenta son de ejemplo):

curl -fsSL https://<tu-cuenta>-ingesta.lymen.app/agente/instalar.sh | sudo LYMEN_ENROLAR=<código> LYMEN_INGESTA=<tu-cuenta>-ingesta.lymen.app sh -s -- --grupo 'produccion'

powershell -NoProfile -ExecutionPolicy Bypass -Command "& ([scriptblock]::Create((iwr -useb https://<tu-cuenta>-ingesta.lymen.app/agente/instalar.ps1).Content)) --codigo '<código>' --ingesta '<tu-cuenta>-ingesta.lymen.app' --grupo 'produccion'"

Con gateways, el comando baja el instalador desde el primer gateway y agrega sus direcciones y huellas: copialo siempre entero.

Con la casilla del monitoreo en detalle tildada, el comando termina en --instrumentar.

Para un cluster, la tarjeta Kubernetes arma el operador, el Secret y el LymenKube (la credencial y la organización son de ejemplo; el LymenKube completo está en Kubernetes):

helm install lymen-operador oci://ghcr.io/lymen-ops/charts/lymen-operador -n lymen --create-namespace --wait
kubectl label namespace lymen pod-security.kubernetes.io/enforce=privileged --overwrite
kubectl -n lymen create secret generic lymen-token --from-literal=token='<credencial>'
kubectl apply -f lymenkube.yaml

Problemas comunes#