Qui a changé quoi ? Le journal d'activité Azure en KQL
Retrouver qui a redimensionné un pool, modifié un groupe de basculement ou une règle de pare-feu avec AzureActivity, plus l'analyse des changements Resource Graph.
Le pool d'élasticité est passé de 8 à 16 vCores pendant la nuit, une règle de pare-feu est apparue, un groupe de basculement a changé de configuration. Personne ne sait rien. Le journal d'activité Azure le sait : il enregistre chaque opération du plan de gestion (ARM), avec l'appelant, l'heure et le résultat. Une fois envoyé dans Log Analytics, il s'interroge en KQL en quelques secondes.
Le journal d'activité dans Log Analytics
Il faut un paramètre de diagnostic de l'abonnement qui envoie le journal d'activité vers un espace de travail Log Analytics. Les événements arrivent dans la table AzureActivity. Colonnes utilisées ici (vérifiées dans la documentation Microsoft) :
| Colonne | Contenu |
|---|---|
TimeGenerated |
heure de l'événement (UTC) |
OperationNameValue |
identifiant de l'opération, par exemple Microsoft.Sql/servers/elasticPools/write |
Caller |
identité à l'origine de l'appel |
ActivityStatusValue |
Started, Succeeded, Failed... |
CategoryValue |
Administrative, Policy, Security... |
ResourceGroup, ResourceId, SubscriptionId |
la cible |
CorrelationId |
regroupe les événements d'une même action |
CallerIpAddress, Properties_d, Authorization_d |
détails |
flowchart LR
A["Portail, CLI, pipeline, T-SQL"] --> B["Azure Resource Manager"]
B --> C["Journal d'activité"]
C --> D["Paramètre de diagnostic"]
D --> E["Log Analytics : AzureActivity"]
E --> F["Requête KQL"]
B --> G["Resource Graph : resourcechanges"]
G --> H["Diff des propriétés"]
Qui a modifié quoi : les requêtes
Les trois questions classiques, avec les noms d'opérations ARM correspondants :
AzureActivity
| where TimeGenerated > ago(7d)
| where CategoryValue == "Administrative"
| where ActivityStatusValue == "Succeeded"
| where OperationNameValue in~ (
"Microsoft.Sql/servers/elasticPools/write", // redimensionnement d'un pool
"Microsoft.Sql/servers/failoverGroups/write", // groupe de basculement
"Microsoft.Sql/servers/firewallRules/write", // règle de pare-feu SQL
"Microsoft.Sql/servers/firewallRules/delete")
| project TimeGenerated, OperationNameValue, Caller, CallerIpAddress, ResourceGroup, ResourceId
| order by TimeGenerated desc
Pour retrouver les actions d'une personne ou d'un compte de service :
AzureActivity
| where TimeGenerated > ago(24h)
| where Caller == "admin@contoso.com"
| where ActivityStatusValue != "Started"
| summarize Operations = count() by OperationNameValue, ActivityStatusValue
| order by Operations desc
Et pour les échecs (permission refusée, quota) :
AzureActivity
| where TimeGenerated > ago(7d) and ActivityStatusValue == "Failed"
| where OperationNameValue startswith "Microsoft.Sql/"
| project TimeGenerated, OperationNameValue, Caller, ActivitySubstatusValue, ResourceId
Pièges du journal d'activité
- Chaque opération apparaît plusieurs fois (
Started, puisSucceededouFailed). Filtrez sur le statut final, ou regroupez parCorrelationIdavecsummarize arg_max(TimeGenerated, *) by CorrelationId. Callerest tantôt un UPN, tantôt un identifiant d'objet (GUID) : un appel depuis le portail ou par une identité managée montre un GUID. Gardez à portée de main une table de correspondance GUID vers nom, ou résolvez-le dans l'annuaire.- Écritures nombreuses sur une seule action : un déploiement génère des dizaines de lignes
write. Cherchez parCorrelationIdpour voir l'ensemble. - Délai d'ingestion de quelques minutes, et rétention limitée à celle de l'espace de travail : pour remonter plus loin, archivez.
- Heure :
TimeGeneratedest en UTC. Pour l'affichage local :datetime_utc_to_local(TimeGenerated, 'Europe/Brussels'). - Seul le plan de gestion est couvert : ce qui se passe à l'intérieur de la base (T-SQL) n'y est pas. Pour cela, l'audit SQL.
- Passer par KQL est incomparablement plus rapide que l'API REST du journal d'activité, qui peut prendre plusieurs minutes pour quelques heures de données.
Option : Resource Graph et l'analyse des changements
Le journal d'activité dit qui a appelé quoi. Pour savoir quelle propriété a changé de quelle valeur à quelle valeur, Azure Resource Graph expose la table resourcechanges :
resourcechanges
| extend changeTime = todatetime(properties.changeAttributes.timestamp),
target = tostring(properties.targetResourceId),
changeType = tostring(properties.changeType),
changedBy = tostring(properties.changeAttributes.changedBy),
clientType = tostring(properties.changeAttributes.clientType)
| where changeTime > ago(7d) and target contains "/providers/microsoft.sql/"
| project changeTime, changeType, changedBy, clientType, target, properties.changes
| order by changeTime desc
properties.changes contient pour chaque propriété la valeur précédente et la nouvelle. Les enregistrements sont normalement disponibles en moins de cinq minutes. Limites à connaître : un enregistrement Create ou Delete n'a pas de détail de propriétés, et changedBy peut valoir Unspecified ou System. Resource Graph est une bonne source de vérité sur l'état, mais il n'indexe pas tous les types de ressources : vérifiez avant de vous y fier.
Retour d'expérience
- Commencez par
AzureActivity: c'est la réponse à « qui ? », le plus souvent suffisante. - Passez à
resourcechangesquand la question est « de quoi à quoi ? ». - Sauvegardez ces requêtes comme fichiers
.kql: un incident n'est pas le bon moment pour retrouver la syntaxe dein~. - Un rapport hebdomadaire des changements sur les pools, groupes de basculement et règles de pare-feu est un excellent filet de sécurité, bien plus utile que mille alertes.