# 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:

| Si todavía no tenés... | El aviso dice | Botón |
|---|---|---|
| Servidores | "Empezá por instalar el agente en tu primer servidor" | **Agregar servidor** |
| Gateways | "Para sumar switches y routers, creá un gateway" | **Elegir un servidor** |
| Equipos de red | "Todo listo para sumar equipos de red" | **Agregar equipo** |

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](https://lymen.app/docs/instalacion/agente-linux/) y [Windows](https://lymen.app/docs/instalacion/agente-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](https://lymen.app/docs/instalacion/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](https://lymen.app/docs/instalacion/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](https://lymen.app/docs/instalacion/grupos-y-actualizacion/).

### 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](https://lymen.app/docs/instalacion/kubernetes/#configuracion-desde-el-portal).

### Aparte: Sitios web y apps

Se miden desde **Observar › Aplicaciones** (botón **Ir a Aplicaciones**), con su propio paso a paso. Ver [Aplicaciones](https://lymen.app/docs/instalacion/aplicaciones/).

## Campos del diálogo "Agregar servidor"

| Campo | Para qué sirve | Por defecto | Valores válidos | Impacto de cambiarlo |
|---|---|---|---|---|
| **Gateways (opcional)** | Lista ordenada de gateways por donde sale este servidor. | Vacía: el servidor sale directo a Lymen. | Hasta 5 gateways existentes. El primero es el preferido; los demás, de repuesto. | Con gateways, el servidor **no necesita salida a internet**: instala y manda todo por el primero que responda. Después se cambia desde el detalle del servidor. |
| **Sin cifrar (no recomendado)** | Habla con los gateways por http en vez de https. | Apagado: todo va cifrado, con el certificado de cada gateway fijado. | Encendido / apagado. Solo aparece si elegiste gateways. | **Seguridad.** Encendido, la clave del servidor y sus datos viajan en claro por tu red hasta el gateway. Queda un aviso en el servidor y, para cifrar, hay que reinstalar. |
| **Grupo (opcional)** | Asigna el servidor a un grupo al instalarlo. Queda en el comando como `--grupo`. | Sin grupo. | Un grupo existente, "Sin grupo" o "Grupo nuevo…". | El grupo decide la política de actualización y es la etiqueta `grupo` de filtros, reglas y dashboards. Se corrige después desde el detalle del servidor. |
| **Nombre del grupo nuevo** | Crea el grupo en el momento. | — | Hasta 60 caracteres, sin comas, comillas, barra invertida, `$` ni acento grave. | Igual que el grupo. Hay un tope de 100 grupos. |
| **Instalar también el monitoreo en detalle** | Suma al servidor el paquete que mide tus aplicaciones por dentro (Java, .NET, Node.js y Python). Queda en el comando como `--instrumentar`. | Sin tildar. | Tildada / sin tildar. | **No toca ninguna aplicación**: el monitoreo se activa después, aplicación por aplicación, en el detalle del servidor ([Instrumentación](https://lymen.app/docs/instalacion/instrumentacion-aplicaciones/)). Si el paquete no está publicado para ese sistema, o falla, el agente se instala igual y lo avisa. |

**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):

```sh
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'
```

```bat
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](https://lymen.app/docs/instalacion/kubernetes/#ejemplo-de-lymenkube)):

```sh
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

| Síntoma | Causa probable | Qué hacer |
|---|---|---|
| "El código no es válido, ya se usó o venció" | Pasaron más de 24 horas, o el código ya se usó en otro servidor. | Generá un código nuevo. |
| El servidor no se conecta | El código se gastó pero algo falló después (descarga, permisos). | Quitá ese servidor en Infraestructura y generá un código nuevo. |
| "Demasiados intentos" | Se probó muchas veces seguidas. | Esperá un minuto. |
| **Generar comando** está deshabilitado | Un gateway elegido todavía no publicó su certificado. | Esperá un minuto después de que arranque el gateway. |
| La tarjeta de Equipos de red dice "Bloqueado" | No hay ningún gateway. | Creá uno primero ([Gateways](https://lymen.app/docs/instalacion/gateways/)). |
| "Ya hay un cluster llamado…" | Ese nombre ya tiene una credencial vigente. | Usá otro nombre, o revocá la credencial anterior y generá una nueva. |
| El cluster sigue en *Esperando conexión* | El chart no terminó de instalarse o los nodos no llegan a Lymen. | Revisá los pods del namespace `lymen` y que el Secret tenga la credencial que copiaste. |