# Primeros pasos

## Para qué sirve

Lymen te muestra, en un solo portal, cómo andan tus sistemas: los servidores, las aplicaciones, los sitios web y apps que usan tus pacientes o clientes, y los equipos de red (switches, routers, firewalls). Cuando algo se rompe o se pone lento, lo ves ahí, con el contexto para entender por qué.

Para ponerlo en marcha alcanza con instalar un programa chico (el **agente**) en tus servidores y pegar un código en tus sitios y apps. Todo lo demás se configura desde el portal. Esta sección tiene el paso a paso para cada cosa que quieras sumar: un servidor, un sitio, una app o un switch.

## Las direcciones de tu cuenta

Cuando contratás Lymen te pasamos el nombre de tu cuenta (por ejemplo `clinica-x`). Con ese nombre se arman las dos direcciones que vas a usar:

| Para qué | Dirección | Ejemplo |
|---|---|---|
| Entrar al portal | `https://<tu-cuenta>.lymen.app` | `https://clinica-x.lymen.app` |
| Mandar datos (agente, SDK, gateways) | `<tu-cuenta>-ingesta.lymen.app` | `clinica-x-ingesta.lymen.app` |

Donde esta documentación dice `<tu-cuenta>`, poné el nombre de la tuya. Los comandos que arma el portal ya vienen con tus direcciones. Si tu firewall filtra las salidas, habilitá también `https://paquetes.lymen.app`, de donde el instalador baja el agente.

## Qué datos junta Lymen

| Qué querés mirar | Cómo se conecta | Dónde se ve |
|---|---|---|
| Servidores (Linux o Windows) | Instalás el agente con una línea | Infraestructura |
| Aplicaciones que corren en esos servidores | Se activa desde el portal, sin tocar su código | Servicios, Trazas, Topología |
| Sitios web y apps móviles | Pegás un código (SDK) en el sitio o la app | Aplicaciones |
| Switches, routers, firewalls y puntos de acceso | Un servidor de tu red los consulta (gateway) | Equipos de red |
| Servidores sin salida a internet | Salen a través de otro servidor de tu red (gateway) | Infraestructura |
| Clusters de Kubernetes | Instalás el operador de Lymen con Helm y aplicás el LymenKube que arma el portal ([Kubernetes](https://lymen.app/docs/instalacion/kubernetes/)) | Observar › Kubernetes |

## Un recorrido por el portal

El menú lateral tiene estos grupos:

- **Resumen, Dashboards e Incidentes**: lo primero que ve cualquier persona al entrar.
- **Observar**: Servicios, Topología (el mapa de cómo se conecta todo), Aplicaciones (sitios y apps), Infraestructura (servidores), Equipos de red y Explorar (consultas libres y trazas).
- **Cumplimiento**: Objetivos (SLO).
- **Alertas**: Reglas, A quién avisar y Mantenimiento.
- **Automatizar**: Flujos.
- **Configuración**:
  - *Datos*: Procesamiento, Muestreo, Almacenamiento, Reglas de captura, Privacidad y Etiquetas.
  - *Conexiones*: **Agregar datos**, Integraciones y Llavero.

Al principio vas a usar sobre todo **Configuración › Conexiones › Agregar datos**: desde ahí das de alta servidores, equipos de red y grupos, y ves tus gateways. Los sitios y apps se dan de alta en **Observar › Aplicaciones**.

## Qué ve cada rol

| Rol | Qué puede hacer |
|---|---|
| **Administración** | Todo. Es el único rol que da de alta servidores, gateways, equipos de red y aplicaciones, cambia la política de actualización y entra a la sección Configuración. |
| **Sistemas** | Mira todo lo técnico (Servicios, Topología, Aplicaciones, Infraestructura, Equipos de red, Explorar, Reglas, A quién avisar, Mantenimiento). Puede ver el detalle de un servidor, pero no cambiarlo. No ve Configuración ni Flujos. |
| **Negocio** | Ve Resumen, Dashboards, Incidentes y Objetivos (SLO). No ve las pantallas técnicas ni Configuración. |

Si quien instala no tiene el rol Administración, pedile a quien lo tenga que genere el comando de instalación.

## Por dónde empezar

Seguí este orden. El aviso de arriba de **Agregar datos** te va marcando el próximo paso:

1. **Instalá el agente en tu primer servidor.** Es una sola línea que copiás del portal. Mirá [Agregar datos](https://lymen.app/docs/instalacion/agregar-datos/) y después [Linux](https://lymen.app/docs/instalacion/agente-linux/) o [Windows](https://lymen.app/docs/instalacion/agente-windows/).
2. **Revisá que aparezca en Infraestructura.** En uno o dos minutos el servidor figura como *Conectado*. Más en [Servidores e Infraestructura](https://lymen.app/docs/instalacion/servidores-infraestructura/).
3. **Si tenés servidores sin salida a internet o equipos de red, creá un [gateway](https://lymen.app/docs/instalacion/gateways/):** uno de tus servidores que reenvía los datos de los demás.
4. **Sumá tus [equipos de red](https://lymen.app/docs/instalacion/equipos-de-red/)**, uno por uno o buscándolos en un rango.
5. **Medí tus sitios y apps** desde [Aplicaciones](https://lymen.app/docs/instalacion/aplicaciones/), con el SDK que corresponda: [web](https://lymen.app/docs/instalacion/sdk-web/), [Android](https://lymen.app/docs/instalacion/sdk-android/), [iOS](https://lymen.app/docs/instalacion/sdk-ios/) o [React Native](https://lymen.app/docs/instalacion/sdk-react-native/).
6. **Activá el monitoreo en detalle de tus aplicaciones** (opcional): [Instrumentación de aplicaciones](https://lymen.app/docs/instalacion/instrumentacion-aplicaciones/).
7. Si tenés muchos servidores, armá [grupos](https://lymen.app/docs/instalacion/grupos-y-actualizacion/) para actualizarlos ordenadamente.

## Qué pasa con tus datos al empezar

- **Métricas y trazas, completas.** Una cuenta nueva arranca guardando el 100 % de las trazas (los recorridos de cada pedido por tus sistemas). Para guardar menos, usá **Configuración › Datos › Muestreo**.
- **De los logs, solo los errores.** Cada servidor manda solo los errores del registro del sistema (en Windows, los de nivel Error y Crítico de los registros Sistema y Aplicación) y de sus aplicaciones; en Kubernetes, solo las líneas de error de los contenedores. El filtro se hace en el servidor, antes de que el dato salga. Por eso, en un servidor sano puede pasar un rato sin que llegue ningún log, y en Explorar no vas a ver mensajes informativos. Los eventos de negocio llegan siempre, y los incidentes y anomalías no dependen de los logs. Para recibir más, usá **Observar › Infraestructura › Qué logs recibir** (ver [Qué logs recibir](https://lymen.app/docs/instalacion/servidores-infraestructura/#que-logs-recibir)) o, en Kubernetes, [Namespaces y logs](https://lymen.app/docs/instalacion/kubernetes/#que-datos).
- **La privacidad está activa desde el inicio.** Las reglas de **Configuración › Datos › Privacidad** se aplican en el servidor o en el dispositivo antes de que el dato salga, y otra vez al recibirlo. Nunca se captura lo que las personas escriben en formularios y no se graban sesiones.
- **Las claves no viajan en claro.** El token de cada servidor queda en un archivo que solo puede leer el administrador del equipo.

## Problemas comunes

| Síntoma | Qué revisar |
|---|---|
| No veo "Agregar datos" en el menú | Esa pantalla es solo para el rol Administración. |
| Instalé el agente y no aparece | Esperá 1-2 minutos. Si sigue sin aparecer, mirá [Linux](https://lymen.app/docs/instalacion/agente-linux/#problemas-comunes) o [Windows](https://lymen.app/docs/instalacion/agente-windows/#problemas-comunes). |
| No sé qué servidor es cuál | Usá el nombre del servidor (es el que informa el propio equipo) y los [grupos](https://lymen.app/docs/instalacion/grupos-y-actualizacion/) para ordenarlos. |