Resourcewijzigingen ophalen

Resources veranderen in de loop van het dagelijks gebruik, herconfiguratie en zelfs opnieuw implementeren. De meeste verandering is standaard, maar soms niet. U kunt:

• Zien wanneer wijzigingen in een Azure Resource Manager-eigenschap zijn gedetecteerd.
• Details van eigenschapswijziging weergeven.
• Query's uitvoeren op wijzigingen op schaal in uw abonnementen, beheergroep of tenant.

In dit artikel leert u het volgende:

• Hoe de JSON van de nettolading eruitziet.
• Resourcewijzigingen opvragen via Resource Graph met behulp van de CLI, PowerShell of Azure Portal.
• Queryvoorbeelden en aanbevolen procedures voor het uitvoeren van query's op resourcewijzigingen.

Vereisten

• Als u Azure PowerShell wilt inschakelen om een query uit te voeren op Azure Resource Graph, voegt u de module toe.
• Als u wilt dat Azure CLI query's uitvoert op Azure Resource Graph, voegt u de extensie toe.

Inzicht in eigenschappen van wijzigingsevenementen

Wanneer een resource wordt gemaakt, bijgewerkt of verwijderd, wordt er een nieuwe wijzigingsresource (Microsoft.Resources/wijzigingen) gemaakt om de gewijzigde resource uit te breiden en de gewijzigde eigenschappen weer te geven. Wijzigingsrecords moeten binnen vijf minuten beschikbaar zijn. In het volgende voorbeeld van de JSON-nettolading ziet u de eigenschappen van de wijzigingsresource:

{
  "targetResourceId": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myResourceGroup/providers/microsoft.compute/virtualmachines/myVM",
  "targetResourceType": "microsoft.compute/virtualmachines",
  "changeType": "Update",
  "changeAttributes": {
    "previousResourceSnapshotId": "08584889383111245807_37592049-3996-ece7-c583-3008aef9e0e1_4043682982_1712668574",
    "newResourceSnapshotId": "08584889377081305807_38788020-eeee-ffff-028f-6121bdac9cfe_4213468768_1712669177",
    "correlationId": "04ff69b3-e162-4583-9cd7-1a14a1ec2c61",
    "changedByType": "User",
    "changesCount": 2,
    "clientType": "ARM Template",
    "changedBy": "john@contoso.com",
    "operation": "microsoft.compute/virtualmachines/write",
    "timestamp": "2024-04-09T13:26:17.347+00:00"
  },
  "changes": {
    "properties.provisioningState": {
      "newValue": "Succeeded",
      "previousValue": "Updating",
      "changeCategory": "System",
      "propertyChangeType": "Update",
      "isTruncated": "true"
    },
    "tags.key1": {
      "newValue": "NewTagValue",
      "previousValue": "null",
      "changeCategory": "User",
      "propertyChangeType": "Insert"
    }
  }
}

Zie de volledige referentiehandleiding voor het wijzigen van resource-eigenschappen.

Een query uitvoeren

Probeer een resourcegrafiekquery op basis van een tenant uit van de resourcechanges tabel. De query retourneert de eerste vijf meest recente Azure-resourcewijzigingen met de wijzigingstijd, het wijzigingstype, de doelresource-id, het doelresourcetype en de details van elke wijzigingsrecord.

# Login first with az login if not using Cloud Shell
 
# Run Azure Resource Graph query
az graph query -q 'resourcechanges | project properties.changeAttributes.timestamp, properties.changeType, properties.targetResourceId, properties.targetResourceType, properties.changes | limit 5'

# Login first with Connect-AzAccount if not using Cloud Shell
 
# Run Azure Resource Graph query
Search-AzGraph -Query 'resourcechanges | project properties.changeAttributes.timestamp, properties.changeType, properties.targetResourceId, properties.targetResourceType, properties.changes | limit 5'

U kunt deze query bijwerken om een gebruiksvriendelijkere kolomnaam op te geven voor de tijdstempeleigenschap .

# Run Azure Resource Graph query with 'extend'
az graph query -q 'resourcechanges | extend changeTime=todatetime(properties.changeAttributes.timestamp) | project changeTime, properties.changeType, properties.targetResourceId, properties.targetResourceType, properties.changes | limit 5'

# Run Azure Resource Graph query with 'extend' to define a user-friendly name for properties.changeAttributes.timestamp
Search-AzGraph -Query 'resourcechanges | extend changeTime=todatetime(properties.changeAttributes.timestamp) | project changeTime, properties.changeType, properties.targetResourceId, properties.targetResourceType, properties.changes | limit 5'

resourcechanges
| extend changeTime=todatetime(properties.changeAttributes.timestamp)
| project changeTime, properties.changeType, properties.targetResourceId, properties.targetResourceType, properties.changes
| limit 5

Als u de queryresultaten wilt beperken tot de meest recente wijzigingen, werkt u de query bij naar order by de door de gebruiker gedefinieerde changeTime-eigenschap .

# Run Azure Resource Graph query with 'order by'
az graph query -q 'resourcechanges | extend changeTime=todatetime(properties.changeAttributes.timestamp) | project changeTime, properties.changeType, properties.targetResourceId, properties.targetResourceType, properties.changes | order by changeTime desc | limit 5'

# Run Azure Resource Graph query with 'order by'
Search-AzGraph -Query 'resourcechanges | extend changeTime=todatetime(properties.changeAttributes.timestamp) | project changeTime, properties.changeType, properties.targetResourceId, properties.targetResourceType, properties.changes | order by changeTime desc | limit 5'

resourcechanges
| extend changeTime=todatetime(properties.changeAttributes.timestamp)
| project changeTime, properties.changeType, properties.targetResourceId, properties.targetResourceType, properties.changes
| order by changeTime desc
| limit 5

U kunt ook query's uitvoeren op beheergroep of abonnement met respectievelijk de -ManagementGroup of -Subscription parameters.

Resource Graph Explorer biedt ook een schone interface voor het converteren van de resultaten van sommige query's naar een grafiek die kan worden vastgemaakt aan een Azure-dashboard.

Wijzigingen in queryresources

Met Resource Graph kunt u query's uitvoeren op de resourcechanges, resourcecontainerchangesof healthresourcechanges tabellen om te filteren of te sorteren op een van de eigenschappen van de wijzigingsresource. In de volgende voorbeelden wordt een query uitgevoerd op de resourcechanges tabel, maar kan ook worden toegepast op de resourcecontainerchanges tabel of healthresourcechanges tabel.

Voorbeelden

Bekijk de volgende aanbevolen procedures voordat u query's uitvoert op wijzigingen in uw resources en deze analyseert.

• Voer een query uit voor wijzigingsevenementen tijdens een specifiek tijdvenster en evalueer de wijzigingsgegevens.
  • Deze query werkt het beste tijdens incidentbeheer om inzicht te krijgen in mogelijk gerelateerde wijzigingen.
• Houd een up-to-date CONFIGURATION Management Database (CMDB) bij.
  • In plaats van alle resources en hun volledige eigenschappensets te vernieuwen volgens een geplande frequentie, ontvangt u alleen hun wijzigingen.
• Meer informatie over andere eigenschappen die mogelijk zijn gewijzigd wanneer een resource de 'nalevingsstatus' wijzigt.
  • Evaluatie van deze extra eigenschappen kan inzicht bieden in andere eigenschappen die mogelijk moeten worden beheerd via een Azure Policy-definitie.
• De volgorde van queryopdrachten is belangrijk. In de volgende voorbeelden moet de order by opdracht vóór de limit opdracht komen.
  • Met order by de opdracht worden de queryresultaten gesorteerd op basis van de wijzigingstijd.
  • De limit opdracht beperkt vervolgens de geordende resultaten om ervoor te zorgen dat u de vijf meest recente resultaten krijgt.

Alle wijzigingen in de afgelopen periode van 24 uur

resourcechanges 
| extend changeTime = todatetime(properties.changeAttributes.timestamp), targetResourceId = tostring(properties.targetResourceId),
changeType = tostring(properties.changeType), correlationId = properties.changeAttributes.correlationId, 
changedProperties = properties.changes, changeCount = properties.changeAttributes.changesCount
| where changeTime > ago(1d)
| order by changeTime desc
| project changeTime, targetResourceId, changeType, correlationId, changeCount, changedProperties

Resources die zijn verwijderd in een specifieke resourcegroep

resourcechanges
| where resourceGroup == "myResourceGroup"
| extend changeTime = todatetime(properties.changeAttributes.timestamp), targetResourceId = tostring(properties.targetResourceId),
changeType = tostring(properties.changeType), correlationId = properties.changeAttributes.correlationId
| where changeType == "Delete"
| order by changeTime desc
| project changeTime, resourceGroup, targetResourceId, changeType, correlationId

Wijzigingen in een specifieke eigenschapswaarde

resourcechanges
| extend provisioningStateChange = properties.changes["properties.provisioningState"], changeTime = todatetime(properties.changeAttributes.timestamp), targetResourceId = tostring(properties.targetResourceId), changeType = tostring(properties.changeType)
| where isnotempty(provisioningStateChange)and provisioningStateChange.newValue == "Succeeded"
| order by changeTime desc
| project changeTime, targetResourceId, changeType, provisioningStateChange.previousValue, provisioningStateChange.newValue

Meest recente resourcewijzigingen voor resources die in de afgelopen zeven dagen zijn gemaakt

resourcechanges
| extend targetResourceId = tostring(properties.targetResourceId), changeType = tostring(properties.changeType), changeTime = todatetime(properties.changeAttributes.timestamp)
| where changeTime > ago(7d) and changeType == "Create"
| project  targetResourceId, changeType, changeTime
| join ( Resources | extend targetResourceId=id) on targetResourceId
| order by changeTime desc
| project changeTime, changeType, id, resourceGroup, type, properties

Wijzigingen in de grootte van de virtuele machine

resourcechanges
|extend vmSize = properties.changes["properties.hardwareProfile.vmSize"], changeTime = todatetime(properties.changeAttributes.timestamp), targetResourceId = tostring(properties.targetResourceId), changeType = tostring(properties.changeType) 
| where isnotempty(vmSize) 
| order by changeTime desc 
| project changeTime, targetResourceId, changeType, properties.changes, previousSize = vmSize.previousValue, newSize = vmSize.newValue

Aantal wijzigingen per wijzigingstype en abonnementsnaam

resourcechanges  
|extend changeType = tostring(properties.changeType), changeTime = todatetime(properties.changeAttributes.timestamp), targetResourceType=tostring(properties.targetResourceType)  
| summarize count() by changeType, subscriptionId 
| join (resourcecontainers | where type=='microsoft.resources/subscriptions' | project SubscriptionName=name, subscriptionId) on subscriptionId 
| project-away subscriptionId, subscriptionId1
| order by count_ desc  

Meest recente resourcewijzigingen voor resources die zijn gemaakt met een bepaalde tag

resourcechanges 
|extend targetResourceId = tostring(properties.targetResourceId), changeType = tostring(properties.changeType), createTime = todatetime(properties.changeAttributes.timestamp) 
| where createTime > ago(7d) and changeType == "Create" or changeType == "Update" or changeType == "Delete"
| project  targetResourceId, changeType, createTime 
| join ( resources | extend targetResourceId=id) on targetResourceId
| where tags ['Environment'] =~ 'prod' 
| order by createTime desc 
| project createTime, id, resourceGroup, type

Volgende stappen

Verwante koppelingen

• Starter Resource Graph-queryvoorbeelden
• Richtlijnen voor beperkte aanvragen
• Wijzigingen bijhouden van Azure Automation
• Machineconfiguratie van Azure Policy voor VM's
• Azure Resource Graph-query's per categorie