Docs
Ctrl K
Volver al sitio Pedí una demo
DocsInstalaciónConectar Azure

Conectar Azure

.md

Cómo conectar una suscripción de Azure a Lymen con una service principal de solo lectura, elegir qué recursos monitorear y dónde ver lo que mide.

En esta página
Para qué sirveCuándo usarloRequisitosCrear la service principalPaso a pasoQué ves y dóndeEstados de la cuentaCosto del lado de AzureProblemas comunes

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.
  • 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.

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.

Cada recurso se puede etiquetar y marcar T1, T2 o T3 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 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); 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.