Saltar al contenido principal
Versión: 0.4 · actual

Conectar Azure Monitor

Guía paso a pasoRevisada el 11 de octubre de 2026
Se aplica a:Excubius 0.4Roles: Administrador de entidad
PlanesFree · Core · Pro · EnterpriseImplementaciónEn tus servidores

Conecta Azure Monitor para traer tus recursos de Azure a Excubius con sus métricas de plataforma, sus alertas disparadas, las ejecuciones de Data Factory y los secretos que van a vencer. Esta guía muestra los roles con privilegios mínimos del lado de Azure, cómo agregar la fuente y cómo recibir alertas mediante un grupo de acciones.

Antes de empezar​

  • Necesitas el rol Administrador de entidad en la entidad a la que pertenecen las suscripciones.
  • En Azure, alguien que pueda asignar roles en las suscripciones y, para el vencimiento de los registros de aplicación, conceder el consentimiento de administrador en Entra ID.
  • La función sources.azure_monitor está activada. Consulta Fuentes.

Lo que lee Excubius​

Azure se lee mediante Azure Resource Manager, Resource Graph, Azure Monitor, Alerts Management, Data Factory, el plano de datos de Key Vault y Microsoft Graph. Cada llamada lee; las pocas solicitudes POST son consultas, como una consulta de Resource Graph, una consulta de ejecuciones de canalizaciones o de desencadenadores, o el estado de un entorno de ejecución de integración.

FaseQuéIntervalo predeterminado
InventarioUna consulta de Resource Graph sobre las suscripciones, limitada a los tipos de recurso que elijas15 minutos
MétricasLas comprobaciones del módulo de Azure (métricas de plataforma y filas de Resource Graph, como los trabajos de copia de seguridad), el estado de los túneles VPN y, cada una con su propio interruptor, las comprobaciones de Data Factory, el vencimiento de Key Vault y el vencimiento de los secretos de los registros de aplicación5 minutos
AlertasLas alertas disparadas de Azure Monitor de los últimos 30 días, por recurso de destino5 minutos en Sondeo; conciliación cada 15 minutos en Híbrido

Elegir la identidad​

IdentidadÚsala cuando
La identidad administrada del servidor (recomendada)El servidor de Excubius se ejecuta en Azure y su identidad puede llegar a las suscripciones. No hay nada que guardar ni rotar. Es la identidad asignada por el sistema de la máquina virtual, o una asignada por el usuario cuando AZURE_CLIENT_ID la nombra en el archivo .env
Una entidad de servicioLas suscripciones están en un inquilino al que la identidad del servidor no puede llegar. Un registro de aplicación con un secreto de cliente; rota el secreto antes de que venza

Cuando el archivo .env define AZURE_TENANT_ID, AZURE_CLIENT_ID y AZURE_CLIENT_SECRET, el servidor usa esa entidad de servicio en lugar de su identidad administrada.

Conceder los permisos​

Concede solo lo que necesitan las opciones que usas. Los ID de rol son los de los roles integrados de Azure.

ParaRol o permisoID de rolÁmbito
Inventario y alertasReaderacdd72a7-3385-48ef-bd42-f606fba81ae7Cada suscripción, o un grupo de administración
Métricas de plataformaMonitoring Reader43d0d8ad-25c7-4714-9337-8ba259a9fe05El mismo
Ejecuciones y ejecuciones de desencadenadores de Data Factory, estado de los entornos de ejecución de integraciónRol personalizado Data Factory run reader, más abajoSe crea en tu inquilinoLas factorías, o sus grupos de recursos
Vencimiento de Key VaultKey Vault Reader para los almacenes con Azure RBAC, o una directiva de acceso con List sobre secretos, claves y certificados21090545-7ca7-4776-b22c-e363652d74d2Cada almacén
Vencimiento de los registros de aplicaciónPermiso de aplicación de Microsoft Graph Application.Read.All, con consentimiento de administrador—El inquilino

Por ejemplo, para la identidad administrada del servidor en una suscripción:

az role assignment create --assignee <principal-id> --role "Reader" \
--scope /subscriptions/<subscription-id>
az role assignment create --assignee <principal-id> --role "Monitoring Reader" \
--scope /subscriptions/<subscription-id>

Un rol de solo lectura para Data Factory​

Data Factory expone su historial de ejecuciones como acciones. Reader no las incluye, y el rol integrado Data Factory Contributor las concedería junto con acceso de escritura. Un rol personalizado lo mantiene de solo lectura. Guarda esto como data-factory-run-reader.json:

{
"Name": "Data Factory run reader",
"Description": "Read Data Factory pipelines, triggers, runs and integration runtime status.",
"Actions": [
"Microsoft.DataFactory/factories/read",
"Microsoft.DataFactory/factories/pipelines/read",
"Microsoft.DataFactory/factories/triggers/read",
"Microsoft.DataFactory/factories/integrationruntimes/read",
"Microsoft.DataFactory/factories/querypipelineruns/action",
"Microsoft.DataFactory/factories/querytriggerruns/action",
"Microsoft.DataFactory/factories/integrationruntimes/getstatus/action"
],
"NotActions": [],
"AssignableScopes": ["/subscriptions/<subscription-id>"]
}

Después, créalo y asígnalo:

az role definition create --role-definition data-factory-run-reader.json
az role assignment create --assignee <principal-id> --role "Data Factory run reader" \
--scope /subscriptions/<subscription-id>/resourceGroups/<resource-group>

Sin este rol todo lo demás funciona, y Probar muestra Data Factory como un permiso opcional que falló.

Agregar la fuente​

  1. Abre Configuración › Fuentes, selecciona Añadir una fuente y elige Azure Monitor.
  2. En General, escribe un Nombre y elige la Entidad.
  3. En Identidad, elige La identidad administrada del servidor o Una entidad de servicio. Para una entidad de servicio, escribe el ID de inquilino, el ID de cliente y el Secreto de cliente.
  4. En Suscripciones, escribe los ID de suscripción, uno por línea, o déjalo vacío para leer todas las suscripciones que la identidad puede leer. Enumerarlas es la forma de repartir un inquilino entre varias entidades de cliente.
  5. En Tipos de recurso, conserva los tipos que quieras: máquinas virtuales, bases de datos de Azure SQL, instancias administradas de SQL, servidores flexibles de PostgreSQL, cuentas de almacenamiento, almacenes de claves, almacenes de Recovery Services, factorías de datos, y puertas de enlace de red, firewalls y equilibradores de carga.
  6. Elige qué leer: Métricas de plataforma, Alertas disparadas y Ejecuciones de Data Factory están activadas de forma predeterminada; Vencimiento de secretos de Key Vault y Vencimiento de secretos de registros de aplicación están desactivadas hasta que concedas sus permisos.
  7. Establece la Zona horaria en la que empieza el "hoy" del resumen de Data Factory, por ejemplo America/Santo_Domingo.
  8. En Modo de ingesta, elige Híbrido (recomendado) cuando tus reglas de alerta puedan llegar al servidor de Excubius, o Sondeo en caso contrario.
  9. Selecciona Crear la fuente y copia la URL del webhook. Solo se muestra una vez.

Recibir alertas mediante un grupo de acciones​

En el modo Híbrido o Solo webhook:

  1. En Azure Monitor, crea un grupo de acciones con una acción de Webhook hacia la URL que mostró Excubius, y activa el esquema de alertas común.
  2. Usa ese grupo de acciones en las reglas de alerta cuyas alertas quieras en Excubius.
aviso

Los grupos de acciones no pueden agregar encabezados, así que el token de la URL es la credencial. Mantén la URL en privado, y selecciona Rotar la URL en la fuente si se filtra.

Probar y sincronizar​

  1. En la página de la fuente, selecciona Probar. Cada lectura aparece con su resultado, con las opcionales marcadas: credenciales, suscripciones, inventario, alertas, métricas, Data Factory, Key Vault y registros de aplicación.
  2. Selecciona Sincronizar ahora para traer recursos, métricas y alertas sin esperar.

Los recursos de Azure aparecen debajo de la entidad de la fuente, emparejados con los mismos servidores de otras fuentes por su ID de recurso y sus nombres. Cada factoría de datos recibe una tarjeta en la Vista general, y los secretos que vencen en los próximos 30 días aparecen en Vencimientos y riesgos.