# Topología

## Para qué sirve

La Topología dibuja en un mapa todo lo que Lymen conoce de tu entorno y cómo se conecta: aplicaciones, servicios, bases de datos, colas, servicios externos, servidores y equipos de red. Cada elemento es una **entidad** y se pinta del color de su estado.

Sirve para responder tres preguntas: ¿qué hay?, ¿qué depende de qué?, ¿qué se rompería si esto falla?

## Cuándo usarla

- Un servicio falla y querés saber a quién afecta.
- Hay un incidente y querés una hipótesis de cuál es el origen.
- Vas a apagar o actualizar algo y querés saber qué cuelga de eso.
- Querés ver cómo estaba el sistema en un momento del pasado.

Está disponible para Sistemas y Administración.

## Qué hay en el mapa

| Tipo de entidad | Qué es |
|---|---|
| Aplicación | Un sitio o app (web, Android, iOS) con medición de experiencia de usuarios. |
| Chequeo | Una prueba automática que consulta una dirección cada tanto. |
| Servicio | Una pieza de software tuya que atiende pedidos. |
| Instancia | Un grupo de procesos de un servidor (solo con la capa "Procesos y conexiones"). |
| Base de datos | Una base que usan tus servicios. |
| Cola | Una cola de mensajes entre servicios. |
| Externo | Un servicio de terceros al que llaman tus servicios. |
| Servidor | Una máquina con el agente de Lymen instalado. |
| Equipo de red | Switches, routers, firewalls y puntos de acceso (solo con la capa "Red"). |

Los colores indican el estado: **Bien**, **Atención**, **Crítico** o **Sin datos** (gris). La leyenda está abajo a la izquierda.

El mapa no usa capas fijas: las entidades se acomodan solas según sus conexiones y quedan en la misma posición entre actualizaciones.

## Cómo se usa, paso a paso

1. Entrá a **Topología** (grupo Observar).
2. Elegí el período. Para ver el pasado, mirá "Viaje en el tiempo" más abajo.
3. Movete por el mapa: zoom con la rueda del mouse, la pinza en pantallas táctiles o los botones; arrastrá para mover. "Ver todo" encuadra el mapa.
4. Pasá el mouse por una entidad para resaltar sus vecinos.
5. Tocá una entidad para seleccionarla (se sincroniza con el panel de análisis de la derecha) y abrila para ver su detalle en una ventana.

## Controles del mapa

| Control | Para qué sirve | Valor por defecto | Valores válidos | Impacto |
|---|---|---|---|---|
| Buscar una entidad | Encuentra una entidad por nombre y te lleva a ella. | Vacío | Texto libre | Solo lectura. |
| Filtrar por tipo | Muestra solo ciertos tipos. | Todos | Los tipos presentes | Solo lectura. Útil cuando hay muchas entidades. |
| Filtrar por etiqueta o nivel | Muestra solo lo que tiene ciertas etiquetas o nivel. Todas las etiquetas elegidas tienen que cumplirse; de los niveles elegidos alcanza con uno. | Todo | Etiquetas y niveles en uso (ver [Etiquetas](https://lymen.app/docs/datos/etiquetas/)) | Solo lectura. |
| Mostrar solo lo que tiene problemas | Oculta lo que está bien. | Apagado | Prendido / apagado | Solo lectura. Si no hay nada con problemas, dice "Nada con problemas en este período". |
| Procesos y conexiones | Suma los procesos que corren en tus servidores y sus conexiones. Solo Sistemas y Administración. | Apagado | Prendido / apagado | Solo lectura. Aparece vacía si ningún servidor mandó su inventario. |
| Red | Suma los equipos de red y los enlaces que ellos mismos cuentan por LLDP o CDP. Solo Sistemas y Administración. | Apagado | Prendido / apagado | Solo lectura. Aparece vacía si todavía no diste de alta equipos. Ver [Equipos de red](https://lymen.app/docs/datos/equipos-red/). |

Detalles que ayudan a leer el mapa:

- Las entidades de **nivel T1** (las más importantes) se dibujan un 25 % más grandes y con un anillo marcado.
- Si hay más de 1.000 entidades, se muestran las 1.000 con peor estado y un aviso te sugiere achicar el período o filtrar por tipo.
- Si todavía no hay conexiones, el mapa te invita a instalar el agente en un servidor o a sumar una aplicación.

## Panel de análisis: impacto y causa raíz

A la derecha del mapa hay un panel con dos pestañas.

### Impacto

Elegí una entidad (en el desplegable o tocándola en el mapa) y Lymen te dice: "Si X falla, puede afectar a N…", con la lista de lo que depende de ella de forma **directa** (la usa directamente) e **indirecta** (depende de algo que depende de ella), y por dónde. Todo se resalta en el mapa y lo demás se atenúa.

Límites: el análisis usa las conexiones que Lymen vio en el período. No incluye procesos ni conexiones de red que no se hayan observado.

### Causa raíz

Elegí un incidente de los últimos 7 días y Lymen sugiere cuál entidad es la **posible causa**. Es una hipótesis, no una afirmación. Se basa en:

- Señales propias de cada entidad: estado, errores, lentitud, uso alto de disco, memoria o CPU, alertas.
- Si lo que depende de ella también falla (sería una consecuencia, no la causa).
- Quién empezó a fallar primero.

Muestra la evidencia a favor y en contra, hasta dos alternativas, quiénes dieron señales y en qué orden, y una **confianza**:

| Confianza | Qué significa |
|---|---|
| Alta | Hay varias señales propias fuertes que coinciden y el orden de los hechos acompaña. |
| Media | Hay señales propias de al menos dos clases, una de ellas fuerte. |
| Baja | Hay indicios débiles. |
| Insuficiente | No hay datos suficientes para sugerir una causa. Lo dice y no marca ninguna. |

También aclara "Qué no pudimos mirar" (por ejemplo, entidades sin datos). Con "Ver el mapa de ese momento" saltás a cómo estaba el entorno cuando empezó el incidente. Los detalles de cada incidente están en la sección de alertas.

## Viaje en el tiempo

Podés ver cómo estaba el entorno en un momento pasado (hasta 31 días atrás):

1. En el selector de período, elegí uno de "Cómo estaba": hace 1 hora, 6 horas o 1 día. O abrí la barra de tiempo y elegí día y hora.
2. El mapa muestra el estado de los 5 minutos previos a ese momento y un cartel dice "Estás viendo cómo estaba… No es en vivo".
3. Tocá "Volver a ahora" para regresar.

Qué cambia en el pasado:

- Los incidentes son los que estaban abiertos entonces.
- Lo que existe hoy pero no tenía datos entonces aparece en gris, con trazo punteado, y sin detalle.
- **Las etiquetas y el nivel son los de hoy**: no se guarda su historia.

## Detalle de una entidad

Al abrir una entidad ves sus métricas del período, con quién se conecta y sus etiquetas y nivel (editables). Un servicio o un servidor muestran su panel completo; los demás muestran uno genérico con "Ver en el mapa de servicios" cuando corresponde.

## Campos y opciones

Todo en esta pantalla es de consulta, salvo las etiquetas y el nivel de cada entidad.

| Elemento | Para qué sirve | Valor por defecto | Valores válidos | Impacto |
|---|---|---|---|---|
| Etiquetas de la entidad | Clasificarla (sede, equipo responsable, etc.). | Las automáticas de tus reglas | Pares clave y valor | Afectan filtros, avisos y mantenimiento. Ver [Etiquetas](https://lymen.app/docs/datos/etiquetas/). |
| Nivel | Importancia de la entidad. | Automático | T1 en adelante, o "Volver al automático" | T1 marca lo más crítico y lo hace más visible en el mapa. El nivel también se puede usar como filtro. |

## Ejemplos

- **"¿Qué pasa si se cae la base de turnos?"**: en Impacto elegí la base y mirá la lista de servicios y aplicaciones que dependen de ella.
- **"Ayer a la madrugada hubo un incidente"**: elegilo en Causa raíz, mirá la hipótesis y tocá "Ver el mapa de ese momento".
- **"Quiero ver solo lo que está mal"**: prendé "Mostrar solo lo que tiene problemas".

## Problemas comunes

- **El mapa está vacío**: todavía no hay conexiones vistas. Instalá el agente en un servidor o sumá una aplicación.
- **La causa raíz dice "Insuficiente"**: no hay datos suficientes de lo que estaba pasando. Es mejor que adivinar.
- **Una entidad aparece gris en el pasado**: no tenía datos en ese momento, o todavía no existía.
- **No veo las capas Procesos o Red**: solo las ven Sistemas y Administración, y quedan vacías hasta que haya datos.
- **El mapa no es el mismo que el de Servicios**: el de Servicios muestra solo servicios y quién llama a quién. La Topología suma todo lo demás.