Conectar Azure Monitor
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_monitorestá 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.
| Fase | Qué | Intervalo predeterminado |
|---|---|---|
| Inventario | Una consulta de Resource Graph sobre las suscripciones, limitada a los tipos de recurso que elijas | 15 minutos |
| Métricas | Las 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ón | 5 minutos |
| Alertas | Las alertas disparadas de Azure Monitor de los últimos 30 días, por recurso de destino | 5 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 servicio | Las 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.
| Para | Rol o permiso | ID de rol | Ámbito |
|---|---|---|---|
| Inventario y alertas | Reader | acdd72a7-3385-48ef-bd42-f606fba81ae7 | Cada suscripción, o un grupo de administración |
| Métricas de plataforma | Monitoring Reader | 43d0d8ad-25c7-4714-9337-8ba259a9fe05 | El mismo |
| Ejecuciones y ejecuciones de desencadenadores de Data Factory, estado de los entornos de ejecución de integración | Rol personalizado Data Factory run reader, más abajo | Se crea en tu inquilino | Las factorías, o sus grupos de recursos |
| Vencimiento de Key Vault | Key Vault Reader para los almacenes con Azure RBAC, o una directiva de acceso con List sobre secretos, claves y certificados | 21090545-7ca7-4776-b22c-e363652d74d2 | Cada almacén |
| Vencimiento de los registros de aplicación | Permiso 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
- Abre Configuración › Fuentes, selecciona Añadir una fuente y elige Azure Monitor.
- En General, escribe un Nombre y elige la Entidad.
- 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.
- 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.
- 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.
- 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.
- Establece la Zona horaria en la que empieza el "hoy" del resumen de Data Factory, por ejemplo
America/Santo_Domingo. - En Modo de ingesta, elige Híbrido (recomendado) cuando tus reglas de alerta puedan llegar al servidor de Excubius, o Sondeo en caso contrario.
- 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:
- 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.
- Usa ese grupo de acciones en las reglas de alerta cuyas alertas quieras en Excubius.
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
- 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.
- 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.