Connecter Azure Monitor
Connectez Azure Monitor pour faire entrer vos ressources Azure dans Excubius, avec leurs métriques de plateforme, leurs alertes déclenchées, les exécutions de Data Factory et les secrets qui arrivent à expiration. Ce guide présente les rôles de moindre privilège côté Azure, la façon d'ajouter la source et celle de recevoir les alertes par un groupe d'actions.
Avant de commencer
- Vous devez disposer du rôle Entity admin sur l'entité à laquelle appartiennent les abonnements.
- Dans Azure, une personne capable d'attribuer des rôles sur les abonnements et, pour l'expiration des inscriptions d'applications, d'accorder le consentement administrateur dans Entra ID.
- La fonctionnalité
sources.azure_monitorest activée. Consultez Sources.
Ce qu'Excubius lit
Excubius lit Azure par Azure Resource Manager, Resource Graph, Azure Monitor, Alerts Management, Data Factory, le plan de données de Key Vault et Microsoft Graph. Chaque appel est une lecture ; les rares requêtes POST sont des interrogations, comme une requête Resource Graph, une requête d'exécutions de pipelines ou de déclencheurs, ou l'état d'un runtime d'intégration.
| Phase | Contenu | Intervalle par défaut |
|---|---|---|
| Inventaire | Une requête Resource Graph sur les abonnements, limitée aux types de ressources que vous choisissez | 15 minutes |
| Métriques | Les vérifications du module Azure (métriques de plateforme et lignes Resource Graph, comme les travaux de sauvegarde), l'état des tunnels VPN et, chacune pouvant être activée séparément, les vérifications de Data Factory, l'expiration de Key Vault et l'expiration des secrets des inscriptions d'applications | 5 minutes |
| Alertes | Alertes Azure Monitor déclenchées au cours des 30 derniers jours, par ressource cible | 5 minutes en Polling ; rapprochement toutes les 15 minutes en Hybrid |
Choisir l'identité
| Identité | À utiliser quand |
|---|---|
| The server's managed identity (recommandé) | Le serveur Excubius s'exécute dans Azure et son identité peut atteindre les abonnements. Rien à stocker ni à renouveler. Il s'agit de l'identité affectée par le système de la machine virtuelle, ou d'une identité affectée par l'utilisateur lorsque AZURE_CLIENT_ID dans le fichier .env la désigne |
| A service principal | Les abonnements se trouvent dans un locataire que l'identité du serveur ne peut pas atteindre. Une inscription d'application avec un secret client ; renouvelez le secret avant son expiration |
Lorsque le fichier .env définit à la fois AZURE_TENANT_ID, AZURE_CLIENT_ID et AZURE_CLIENT_SECRET, le serveur utilise ce principal de service au lieu de son identité managée.
Accorder les autorisations
Accordez uniquement ce dont les options que vous utilisez ont besoin. Les ID de rôle sont ceux des rôles intégrés d'Azure.
| Pour | Rôle ou autorisation | ID de rôle | Étendue |
|---|---|---|---|
| Inventaire et alertes | Reader | acdd72a7-3385-48ef-bd42-f606fba81ae7 | Chaque abonnement, ou un groupe d'administration |
| Métriques de plateforme | Monitoring Reader | 43d0d8ad-25c7-4714-9337-8ba259a9fe05 | Idem |
| Exécutions de Data Factory, exécutions de déclencheurs, état des runtimes d'intégration | Rôle personnalisé Data Factory run reader, ci-dessous | Créé dans votre locataire | Les fabriques, ou leurs groupes de ressources |
| Expiration de Key Vault | Key Vault Reader pour les coffres avec Azure RBAC, ou une stratégie d'accès avec List sur les secrets, les clés et les certificats | 21090545-7ca7-4776-b22c-e363652d74d2 | Chaque coffre |
| Expiration des inscriptions d'applications | Autorisation d'application Microsoft Graph Application.Read.All, avec consentement administrateur | — | Le locataire |
Par exemple, pour l'identité managée du serveur sur un abonnement :
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 rôle en lecture seule pour Data Factory
Data Factory expose l'historique de ses exécutions sous forme d'actions. Reader ne les inclut pas, et le rôle intégré Data Factory Contributor les accorderait avec un accès en écriture. Un rôle personnalisé garantit la lecture seule. Enregistrez ce contenu sous le nom 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>"]
}
Créez ensuite le rôle et attribuez-le :
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>
Sans ce rôle, tout le reste fonctionne, et Test indique Data Factory comme une permission facultative qui a échoué.
Ajouter la source
- Ouvrez Settings › Sources, sélectionnez Add a source et choisissez Azure Monitor.
- Sous General, saisissez un Name et choisissez l'Entity.
- Sous Identity, choisissez The server's managed identity ou A service principal. Pour un principal de service, saisissez le Tenant ID, le Client ID et le Client secret.
- Sous Subscriptions, saisissez les ID d'abonnement, un par ligne, ou laissez le champ vide pour lire tous les abonnements que l'identité peut lire. Les lister permet de répartir un même locataire entre plusieurs entités clientes.
- Sous Resource types, conservez les types voulus : machines virtuelles, bases de données Azure SQL, instances gérées SQL, serveurs flexibles PostgreSQL, comptes de stockage, coffres de clés, coffres Recovery Services, fabriques de données, ainsi que passerelles réseau, pare-feu et équilibreurs de charge.
- Choisissez ce qu'il faut lire : Platform metrics, Fired alerts et Data Factory runs sont activés par défaut ; Key Vault secret expiry et App registration secret expiry restent désactivés tant que vous n'avez pas accordé leurs autorisations.
- Définissez le Time zone (fuseau horaire) dans lequel « aujourd'hui » commence pour le résumé de Data Factory, par exemple
America/Santo_Domingo. - Sous Ingest mode, choisissez Hybrid (recommended) lorsque vos règles d'alerte peuvent joindre le serveur Excubius, ou Polling dans le cas contraire.
- Sélectionnez Create source et copiez l'URL du webhook. Elle n'est affichée qu'une seule fois.
Recevoir les alertes par un groupe d'actions
En mode Hybrid ou Webhook only :
- Dans Azure Monitor, créez un action group (groupe d'actions) avec une action Webhook vers l'URL qu'Excubius a affichée, et activez le common alert schema (schéma d'alerte commun).
- Utilisez ce groupe d'actions dans les règles d'alerte dont vous voulez recevoir les alertes dans Excubius.
Les groupes d'actions ne peuvent pas ajouter d'en-têtes ; le jeton contenu dans l'URL constitue donc l'information d'identification. Gardez l'URL privée et sélectionnez Rotate URL sur la source si elle est divulguée.
Tester et synchroniser
- Sur la page de la source, sélectionnez Test. Chaque lecture est listée avec son résultat, les lectures facultatives étant signalées : informations d'identification, abonnements, inventaire, alertes, métriques, Data Factory, Key Vault et inscriptions d'applications.
- Sélectionnez Sync now pour importer immédiatement les ressources, les métriques et les alertes, sans attendre.
Les ressources Azure apparaissent sous l'entité de la source, rapprochées des mêmes serveurs issus d'autres sources par leur ID de ressource et leur nom. Chaque fabrique de données obtient une carte sur le tableau de bord Overview, et les secrets qui expirent dans les 30 jours apparaissent sous Expiry and risk.