# Conectar Azure

## Para qué sirve

Hay cosas donde no podés instalar un agente: una base administrada, un App Service, una Container App. Si conectás tu suscripción de Azure, Lymen le pregunta a Azure Monitor por la CPU, la memoria, el almacenamiento, los pedidos y los errores de esos recursos y los muestra junto al resto. Lymen se conecta con una identidad de **solo lectura** (una *service principal*) que creás vos, y **no cambia nada** en tu suscripción.

**Conectar una cuenta no mide nada todavía.** Después elegís qué recursos monitorear: solo esos se consultan y cuentan para tu plan.

## Cuándo usarlo

- Tenés bases PostgreSQL, MySQL o SQL administradas en Azure y querés ver su CPU, memoria y almacenamiento junto a las [métricas de SQL](https://lymen.app/docs/instalacion/bases-de-datos/).
- Tenés máquinas virtuales, App Services o Container Apps sin agente.
- Querés ver en un solo lugar a Azure y a AWS.

## Requisitos

- Acceso a tu suscripción de Azure con permiso para crear una *app registration* y asignar roles (por ejemplo, Propietario o Administrador de acceso de usuarios).
- El permiso **Nubes › Administrar** en Lymen para conectar, editar o quitar cuentas, y **Nubes › Ver** para mirarlas.
- Poder guardar una credencial en el [Llavero](https://lymen.app/docs/operacion/llavero/).

## Crear la service principal

Una **service principal** es una identidad de Azure para programas, con una clave propia. La de Lymen solo necesita dos roles, y los dos son de lectura:

| Rol de Azure | Para qué lo usa Lymen |
|---|---|
| **Reader** | Listar tus suscripciones y los recursos que tienen (nombre, tipo, región, etiquetas). |
| **Monitoring Reader** | Leer las métricas de esos recursos en Azure Monitor. |

Hacelo en Azure Cloud Shell (el diálogo de Lymen también muestra estos comandos, con botón para copiarlos). Reemplazá `ID_SUSCRIPCION` por el id de tu suscripción:

```sh
az ad sp create-for-rbac --name lymen-lectura --role Reader --scopes /subscriptions/ID_SUSCRIPCION
```

El comando muestra el **tenant**, el **appId** (client id) y el **password** (el secreto). El secreto se muestra una sola vez. Después sumá el permiso de métricas, con el `appId` que te dio el comando:

```sh
az role assignment create --assignee APP_ID --role "Monitoring Reader" --scope /subscriptions/ID_SUSCRIPCION
```

Si tenés varias suscripciones, asigná los dos roles en cada una que quieras conectar.

Después guardá los tres datos en el Llavero: **Ajustes › Conectar › Llavero › nueva credencial**, tipo **Azure: service principal**, con **Tenant ID**, **Client ID** y **Secreto de cliente**. El secreto nunca se vuelve a mostrar.

## Paso a paso

1. Andá a **Ajustes › Conectar › Integraciones**, pestaña **Nubes**, y tocá **Conectar Azure**. Si todavía no conectaste ninguna nube, la tarjeta de Azure tiene el mismo botón.
2. **Credencial.** Elegí la credencial del Llavero (tipo service principal). Si no hay, **Crear en el Llavero** la abre en otra pestaña. Tocá **Siguiente**.
3. **Suscripción.** Lymen prueba la credencial y muestra *La credencial funciona. Lymen puede ver N suscripciones.* Tildá las suscripciones a conectar y poné el **Nombre de la cuenta** (es como la vas a ver en Lymen). Tocá **Conectar** (o **Conectar N suscripciones**).
4. **Listo.** La cuenta queda conectada y Lymen empieza a buscar sus recursos. Tocá **Elegir recursos**.

Si la prueba falla, el diálogo explica el motivo. Si la credencial no tiene permiso de lectura, muestra el comando para darle el rol **Reader**, con **Reintentar** y **Abrir el Llavero**.

### Elegir recursos

**Elegir recursos** se abre también desde la lista de cuentas (el ícono de la lista, en la fila de la cuenta). Mientras Lymen recorre la suscripción ves *Descubriendo recursos…*; en cuentas grandes puede tardar un minuto.

1. Filtrá lo que necesites: **Buscar por nombre**, **Solo elegidos**, **Categoría**, **Región**, **Grupo de recursos** y **Etiqueta** (clave o `clave=valor`).
2. Tildá recursos de a uno, o un tipo completo. Cada tipo tiene un botón **Métricas**: las principales vienen elegidas y podés sumar o sacar otras; **Volver a las principales** deshace los cambios.
3. **Reglas por etiqueta** (por ejemplo `entorno=produccion`): todo lo que tenga esa etiqueta se mide, **también lo que crees después**. Podés tocar la etiqueta de un recurso para convertirla en regla.
4. En **Consultar cada** elegí cada cuántos minutos se lee (de fábrica 5; mínimo 1, máximo 1.440).
5. Abajo ves la estimación: *N recursos · N métricas · cada N min*, con *Suma unas ~N series nuevas a tu plan*. Tocá **Guardar**.

Un recurso que figura **Ya no existe en la nube** se borró en Azure.

## Qué ves y dónde

Lo que Lymen mide aparece en tres lugares:

- **Mirar › Infraestructura › Nubes**: todos los recursos monitoreados, con su salud (**Normal**, **Atención**, **Crítico** o **Sin datos**) y tres señales clave. Arriba ves las cuentas conectadas y un resumen por estado. Los recursos se agrupan en categorías: **Cómputo**, **Contenedores**, **Serverless**, **Bases de datos**, **Almacenamiento**, **Redes**, **Mensajería**, **IA y análisis**, **Seguridad e identidad** y **Otros**. Cualquier tipo de recurso de Azure se puede descubrir; los que Lymen todavía no conoce van a **Otros**, con todas sus métricas para que elijas.
- **Mirar › Infraestructura › Servidores**, pestaña **Nube**: los recursos que corren cargas como un servidor o un contenedor también se listan acá. Son las **máquinas virtuales** y sus conjuntos de escalado, las **Container Apps** y los **App Service y Function Apps**. Si una máquina virtual tiene el mismo nombre que un servidor con agente, se muestra una sola vez en **Servidores**, con las dos marcas. Los clusters AKS y las bases de datos no entran: tienen su propia pantalla.
- **Bases de datos**: una base PostgreSQL, MySQL o SQL de Azure se **vincula sola** con su recurso por el host y muestra arriba su infraestructura. Ver [Vínculo automático con la nube](https://lymen.app/docs/instalacion/bases-de-datos/#vinculo-automatico-con-la-nube).

Cada recurso se puede [etiquetar y marcar T1, T2 o T3](https://lymen.app/docs/datos/etiquetas/) desde su detalle.

## Estados de la cuenta

| Estado | Qué significa | Qué hacer |
|---|---|---|
| **Conectada** | Todo bien. | — |
| **Descubriendo recursos** | Lymen está buscando los recursos de la cuenta. | Esperá un minuto. |
| **Sin datos** | Está conectada, pero todavía no elegiste qué monitorear. | Tocá **Elegir recursos**. |
| **Sin permisos** | La credencial ya no tiene el permiso de lectura (Reader). | Pedile a quien administra Azure que lo restituya. |
| **Credencial vencida** | El secreto venció o ya no es válido. | Actualizalo en el Llavero: Lymen vuelve a consultar solo. |
| **Con error** | No se pudo consultar la cuenta; la tarjeta dice el motivo. | Seguí el motivo. |
| **Pausada** | La consulta está pausada. | — |

En cada fila de cuenta podés **Elegir recursos**, **Editar la conexión** y **Quitar**. Quitar deja de consultar la cuenta y borra la selección de recursos; la credencial del Llavero no se toca.

## Costo del lado de Azure

Según la documentación pública de Azure Monitor, **las métricas estándar de los recursos de Azure no se cobran** por recolectarlas, y sí hay un costo por **recuperar métricas con la API REST**, que es lo que hace Lymen. Para mantenerlo bajo, Lymen pide las métricas en lote (hasta 50 recursos por llamada) y solo de los recursos que elegiste. El costo exacto depende de la tarifa vigente de tu plan de Azure Monitor: revisala en la [página de precios de Azure Monitor](https://azure.microsoft.com/pricing/details/monitor/) y mirá lo que se factura en **Cost Management** de tu suscripción.

Del lado de Lymen, cada métrica elegida suma series a tu plan (ver [Plan y consumo](https://lymen.app/docs/operacion/plan-y-consumo/)); el diálogo **Elegir recursos** te muestra cuántas antes de guardar.

## Problemas comunes

| Qué pasa | Por qué | Qué hacer |
|---|---|---|
| "Todavía no tenés ninguna service principal en el Llavero." | No cargaste la credencial. | **Crear en el Llavero**, tipo **Azure: service principal**. |
| La prueba dice que falta permiso | A la service principal le falta el rol **Reader** en esa suscripción. | Corré el comando de rol que muestra el diálogo. |
| La cuenta se conecta pero no hay métricas | Falta el rol **Monitoring Reader**, o todavía no elegiste recursos. | Asignale el rol y tocá **Elegir recursos**. |
| No veo una suscripción | La service principal no tiene rol en ella. | Asignale **Reader** y **Monitoring Reader** en esa suscripción y volvé a probar. |
| "Esta cuenta no tiene recursos que podamos medir" | Todavía no hay recursos, o recién se crearon. | Esperá unos minutos y tocá **Volver a buscar**. |
| Un recurso nuevo no se mide | Lo elegiste a mano antes de que existiera. | Usá una **regla por etiqueta** para que lo tome solo. |
