Regels voor gegevensverzameling (DCR's) maken en bewerken in Azure Monitor

Artikel
04/04/2024

Er zijn meerdere methoden voor het maken van een regel voor gegevensverzameling (DCR) in Azure Monitor. In sommige gevallen maakt en beheert Azure Monitor de DCR op basis van de instellingen die u in Azure Portal configureert. In andere gevallen moet u mogelijk uw eigen DCR's maken om bepaalde scenario's aan te passen.

In dit artikel worden de verschillende methoden beschreven voor het maken en bewerken van een DCR. Zie Structuur van een regel voor gegevensverzameling in Azure Monitor voor de inhoud van de DCR zelf.

Machtigingen

U hebt de volgende machtigingen nodig om DCR's en koppelingen te maken:

Ingebouwde rol	Bereiken	Reden
Bijdrager voor bewaking	Abonnement en/of Resourcegroep en/of Een bestaande DCR	Maak of bewerk DCR's, wijs regels toe aan de computer, implementeer koppelingen.
Inzender voor virtuele machines Azure Verbinding maken ed Machine Resource Beheer istrator	Virtuele machines, virtuele-machineschaalsets Servers met Azure Arc	Implementeer agentextensies op de VIRTUELE machine.
Elke rol die de actie Microsoft.Resources/deployments/ bevat*	Abonnement en/of Resourcegroep en/of Een bestaande DCR	Azure Resource Manager-sjablonen implementeren.

Geautomatiseerde methoden voor het maken van een DCR

De volgende tabel bevat methoden voor het maken van scenario's voor het verzamelen van gegevens met behulp van Azure Portal waar de DCR voor u wordt gemaakt. In deze gevallen hoeft u niet rechtstreeks met de DCR zelf te communiceren.

Scenario	Resources	Beschrijving
Azure Monitor-agent	Gegevensverzameling configureren voor Azure Monitor-agent	Gebruik De Azure-portal om een DCR te maken waarmee gebeurtenissen en prestatiemeteritems worden opgegeven die moeten worden verzameld vanaf een computer met Azure Monitor Agent. Koppel die regel vervolgens aan een of meer virtuele machines. De Azure Monitor-agent wordt geïnstalleerd op computers die deze momenteel niet hebben.
	Overzicht van VM-inzichten inschakelen	Wanneer u VM-inzichten op een VIRTUELE machine inschakelt, wordt de Azure Monitor-agent geïnstalleerd en wordt er een DCR gemaakt waarmee een vooraf gedefinieerde set prestatiemeteritems wordt verzameld. U moet deze DCR niet wijzigen.
Container Insights	Containerinzichten inschakelen	Wanneer u Container Insights inschakelt in een Kubernetes-cluster, wordt een containerversie van de Azure Monitor-agent geïnstalleerd en wordt er een DCR gemaakt waarmee gegevens worden verzameld op basis van de configuratie die u hebt geselecteerd. Mogelijk moet u deze DCR wijzigen om een transformatie toe te voegen.
Tekst- of JSON-logboeken	Logboeken verzamelen van een tekst- of JSON-bestand met Azure Monitor Agent	Gebruik Azure Portal om een DCR te maken om vermeldingen te verzamelen uit een tekstlogboek op een computer met Azure Monitor Agent.

Handmatig een DCR maken

Als u handmatig een DCR wilt maken, maakt u een JSON-bestand met de juiste configuratie voor de gegevensverzameling die u configureert. Begin met een van de voorbeeld-DCR's en gebruik informatie in structuur van een regel voor gegevensverzameling in Azure Monitor om het JSON-bestand voor uw specifieke omgeving en vereisten te wijzigen.

Zodra u het JSON-bestand hebt gemaakt, kunt u een van de volgende methoden gebruiken om de DCR te maken:

Gebruik de opdracht az monitor data-collection rule create om een DCR te maken op basis van uw JSON-bestand met behulp van de Azure CLI, zoals wordt weergegeven in het volgende voorbeeld.

az monitor data-collection rule create --location 'eastus' --resource-group 'my-resource-group' --name 'myDCRName' --rule-file 'C:\MyNewDCR.json' --description 'This is my new DCR'

Gebruik de cmdlet New-AzDataCollectionRule om de DCR te maken op basis van uw JSON-bestand met behulp van PowerShell, zoals wordt weergegeven in het volgende voorbeeld.

New-AzDataCollectionRule -Location 'east-us' -ResourceGroupName 'my-resource-group' -RuleName 'myDCRName' -RuleFile 'C:\MyNewDCR.json' -Description 'This is my new DCR'

Gebruik de DCR create-API om de DCR te maken op basis van uw JSON-bestand. U kunt elke methode gebruiken om een REST API aan te roepen, zoals wordt weergegeven in de volgende voorbeelden.

$ResourceId = "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/my-resource-group/providers/Microsoft.Insights/dataCollectionRules/my-dcr"
$FilePath = ".\my-dcr.json"
$DCRContent = Get-Content $FilePath -Raw 
Invoke-AzRestMethod -Path ("$ResourceId"+"?api-version=2022-06-01") -Method PUT -Payload $DCRContent

ResourceId="/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/my-resource-group/providers/Microsoft.Insights/dataCollectionRules/my-dcr"
FilePath="my-dcr.json"
az rest --method put --url $ResourceId"?api-version=2022-06-01" --body @$FilePath

Zie de volgende verwijzingen voor het definiëren van DCR's en koppelingen in een sjabloon.

Gebruik de volgende sjabloon om een DCR te maken met behulp van informatie uit de structuur van een regel voor gegevensverzameling in Azure Monitor en regels voor voorbeeldgegevensverzameling (DCR's) in Azure Monitor om het dcr-propertieste definiëren.

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "dataCollectionRuleName": {
            "type": "string",
            "metadata": {
                "description": "Specifies the name of the Data Collection Rule to create."
            }
        },
        "location": {
            "type": "string",
            "metadata": {
                "description": "Specifies the location in which to create the Data Collection Rule."
            }
        }
    },
    "resources": [
        {
            "type": "Microsoft.Insights/dataCollectionRules",
            "name": "[parameters('dataCollectionRuleName')]",
            "location": "[parameters('location')]",
            "apiVersion": "2021-09-01-preview",
            "properties": {
                "<dcr-properties>"
            }
        }
    ]
}

DCR-koppeling - Azure-VM

In het volgende voorbeeld wordt een koppeling gemaakt tussen een virtuele Azure-machine en een regel voor gegevensverzameling.

Bicep-sjabloonbestand

@description('The name of the virtual machine.')
param vmName string

@description('The name of the association.')
param associationName string

@description('The resource ID of the data collection rule.')
param dataCollectionRuleId string

resource vm 'Microsoft.Compute/virtualMachines@2021-11-01' existing = {
  name: vmName
}

resource association 'Microsoft.Insights/dataCollectionRuleAssociations@2021-09-01-preview' = {
  name: associationName
  scope: vm
  properties: {
    description: 'Association of data collection rule. Deleting this association will break the data collection for this virtual machine.'
    dataCollectionRuleId: dataCollectionRuleId
  }
}

ARM-sjabloonbestand

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "vmName": {
      "type": "string",
      "metadata": {
        "description": "The name of the virtual machine."
      }
    },
    "associationName": {
      "type": "string",
      "metadata": {
        "description": "The name of the association."
      }
    },
    "dataCollectionRuleId": {
      "type": "string",
      "metadata": {
        "description": "The resource ID of the data collection rule."
      }
    }
  },
  "resources": [
    {
      "type": "Microsoft.Insights/dataCollectionRuleAssociations",
      "apiVersion": "2021-09-01-preview",
      "scope": "[format('Microsoft.Compute/virtualMachines/{0}', parameters('vmName'))]",
      "name": "[parameters('associationName')]",
      "properties": {
        "description": "Association of data collection rule. Deleting this association will break the data collection for this virtual machine.",
        "dataCollectionRuleId": "[parameters('dataCollectionRuleId')]"
      }
    }
  ]
}

Parameterbestand

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "vmName": {
      "value": "my-azure-vm"
    },
    "associationName": {
      "value": "my-windows-vm-my-dcr"
    },
    "dataCollectionRuleId": {
      "value": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/my-resource-group/providers/microsoft.insights/datacollectionrules/my-dcr"
    }
   }
}

DCR-koppeling - Server met Arc

In het volgende voorbeeld wordt een koppeling gemaakt tussen een server met Azure Arc en een regel voor gegevensverzameling.

Bicep-sjabloonbestand

@description('The name of the virtual machine.')
param vmName string

@description('The name of the association.')
param associationName string

@description('The resource ID of the data collection rule.')
param dataCollectionRuleId string

resource vm 'Microsoft.HybridCompute/machines@2021-11-01' existing = {
  name: vmName
}

resource association 'Microsoft.Insights/dataCollectionRuleAssociations@2021-09-01-preview' = {
  name: associationName
  scope: vm
  properties: {
    description: 'Association of data collection rule. Deleting this association will break the data collection for this Arc server.'
    dataCollectionRuleId: dataCollectionRuleId
  }
}

ARM-sjabloonbestand

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "vmName": {
      "type": "string",
      "metadata": {
        "description": "The name of the virtual machine."
      }
    },
    "associationName": {
      "type": "string",
      "metadata": {
        "description": "The name of the association."
      }
    },
    "dataCollectionRuleId": {
      "type": "string",
      "metadata": {
        "description": "The resource ID of the data collection rule."
      }
    }
  },
  "resources": [
    {
      "type": "Microsoft.Insights/dataCollectionRuleAssociations",
      "apiVersion": "2021-09-01-preview",
      "scope": "[format('Microsoft.HybridCompute/machines/{0}', parameters('vmName'))]",
      "name": "[parameters('associationName')]",
      "properties": {
        "description": "Association of data collection rule. Deleting this association will break the data collection for this Arc server.",
        "dataCollectionRuleId": "[parameters('dataCollectionRuleId')]"
      }
    }
  ]
}

Parameterbestand

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "vmName": {
      "value": "my-hybrid-vm"
    },
    "associationName": {
      "value": "my-windows-vm-my-dcr"
    },
    "dataCollectionRuleId": {
      "value": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/my-resource-group/providers/microsoft.insights/datacollectionrules/my-dcr"
    }
   }
}

Een DCR bewerken

Als u een DCR wilt bewerken, kunt u een van de methoden gebruiken die in de vorige sectie worden beschreven om een DCR te maken met een gewijzigde versie van de JSON.

Als u de JSON voor een bestaande DCR wilt ophalen, kunt u deze kopiëren vanuit de JSON-weergave voor de DCR in Azure Portal. U kunt deze ook ophalen met behulp van een API-aanroep, zoals wordt weergegeven in het volgende PowerShell-voorbeeld.

$ResourceId = "<ResourceId>" # Resource ID of the DCR to edit
$FilePath = "<FilePath>" # Store DCR content in this file
$DCR = Invoke-AzRestMethod -Path ("$ResourceId"+"?api-version=2022-06-01") -Method GET
$DCR.Content | ConvertFrom-Json | ConvertTo-Json -Depth 20 | Out-File -FilePath $FilePath

Zie Zelfstudie: Een regel voor gegevensverzameling bewerken (DCR) voor een zelfstudie die het proces voor het ophalen en bewerken van een bestaande DCR doorloopt.