LLI Wiki — My Digital Knowledge Base

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é

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

Mastodon LLIMastodon SocialFosstodon