Erstellen und Bearbeiten von Datensammlungsregeln (Data Collection Rules, DCRs) in Azure Monitor

Artikel
04/11/2024

Es gibt mehrere Methoden zum Erstellen einer Datensammlungsregel (Data Collection Rule, DCR) in Azure Monitor. In einigen Fällen erstellt und verwaltet Azure Monitor die DCR entsprechenden Einstellungen, die Sie im Azure-Portal konfigurieren. In anderen Fällen müssen Sie möglicherweise eigene DCRs erstellen, um bestimmte Szenarien anzupassen.

In diesem Artikel werden die verschiedenen Methoden zum Erstellen und Bearbeiten einer DCR beschrieben. Informationen zum Inhalt der DCR selbst finden Sie unter Struktur einer Datensammlungsregel in Azure Monitor.

Berechtigungen

Sie benötigen die folgenden Berechtigungen zum Erstellen von DCRs und Zuordnungen zu erstellen:

Integrierte Rolle	Bereiche	`Reason`
Überwachungsmitwirkender	Abonnement und/oder Ressourcengruppe und/oder Eine vorhandene DCR	Erstellen oder bearbeiten Sie DCRs, weisen Sie dem Computer Regeln zu, stellen Sie Zuordnungen bereit.
Mitwirkender von virtuellen Computern Ressourcenadministrator für Azure Connected Machine	VMs, VM-Skalierungsgruppen Server mit Azure Arc-Unterstützung	Stellen Sie Agent-Erweiterungen auf der VM bereit.
Jede Rolle, die die Aktion Microsoft.Resources/deployments/* enthält	Abonnement und/oder Ressourcengruppe und/oder Eine vorhandene DCR	Stellen Sie die Azure Resource Manager-Vorlagen bereit.

Automatisierte Methoden zum Erstellen einer DCR

Die folgende Tabelle enthält Methoden zum Erstellen von Datensammlungsszenarien mithilfe des Azure-Portals, in denen die DCR für Sie erstellt wird. In diesen Fällen müssen Sie nicht direkt mit der DCR selbst interagieren.

Szenario	Ressourcen	BESCHREIBUNG
Azure Monitor-Agent	Konfigurieren der Datensammlung für Azure Monitor-Agent	Im Azure-Portal können Sie eine DCR erstellen, mit der Ereignisse und Leistungsindikatoren angegeben werden, die von einem Computer mit Azure Monitor-Agent erfasst werden. Ordnen Sie diese Regel dann mindestens einer VM zu. Azure Monitor-Agent wird auf allen Computern installiert, auf denen er noch nicht installiert wurde.
	Übersicht zum Aktivieren von VM Insights	Wenn Sie VM-Erkenntnisse auf einer VM aktivieren, wird der Azure Monitor-Agent installiert. Außerdem wird eine DCR erstellt, die einen vordefinierten Satz von Leistungsindikatoren erfasst. Sie sollten diese DCR nicht ändern.
Container Insights	Aktivieren von Container Insights	Wenn Sie Containererkenntnisse für einen Kubernetes-Cluster aktivieren, wird eine containerisierte Version des Azure Monitor-Agents installiert. Zudem wird eine DCR erstellt, die Daten gemäß der ausgewählten Konfiguration sammelt. Möglicherweise müssen Sie diese DCR ändern, um eine Transformation hinzuzufügen.
Text- oder JSON-Protokolle	Sammeln von Protokollen aus einer Text- oder JSON-Datei mit dem Azure Monitor-Agent	Verwenden Sie das Azure-Portal zum Erstellen einer DCR, um Einträge aus einem Textprotokoll auf einem Computer mit dem Azure Monitor-Agent zu erfassen.

Manuelles Erstellen einer DCR

Erstellen Sie zum manuellen Erstellen einer DCR eine JSON-Datei mit der entsprechenden Konfiguration für die von Ihnen konfigurierte Datensammlung. Beginnen Sie mit einer der Beispiel-DCRs, und verwenden Sie die Informationen unter Struktur einer Datensammlungsregel in Azure Monitor, um die JSON-Datei Ihrer Umgebung und Ihren Anforderungen entsprechend anzupassen.

Nachdem Sie die JSON-Datei erstellt haben, können Sie eine der folgenden Methoden verwenden, um die DCR zu erstellen:

Verwenden Sie den Befehl az monitor data-collection rule create, um eine DCR auf der Grundlage Ihrer JSON-Datei mithilfe der Azure CLI zu erstellen, wie im folgenden Beispiel gezeigt:

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'

Verwenden Sie das Cmdlet New-AzDataCollectionRule, um die DCR auf der Grundlage Ihrer JSON-Datei mithilfe von PowerShell zu erstellen, wie im folgenden Beispiel gezeigt:

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

Verwenden Sie die API zum Erstellen von DCRs, um die DCR auf der Grundlage Ihrer JSON-Datei zu erstellen. Sie können eine beliebige Methode verwenden, um eine REST-API aufzurufen, wie in den folgenden Beispielen gezeigt:

$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

Weitere Informationen zur Definition von DCRs und Assoziationen in einer Vorlage finden Sie in den folgenden Referenzen.

Verwenden Sie die folgende Vorlage, um eine DCR zu erstellen, indem Sie die Informationen aus Struktur einer Datensammlungsregel in Azure Monitor und Beispiel für Datensammlungsregeln (Data Collection Rules, DCRs) in Azure Monitor verwenden, um dcr-properties festzulegen.

{
    "$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-Zuordnung -Azure VM

Mit dem folgenden Beispiel wird eine Zuordnung zwischen einem virtuellen Azure-Computer und einer Datensammlungsregel erstellt.

Bicep-Vorlagendatei

@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-Vorlagendatei

{
  "$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')]"
      }
    }
  ]
}

Parameterdatei

{
  "$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-Zuordnung -Arc-enabled server

Im folgenden Beispiel wird eine Zuordnung zwischen einem Server mit Azure Arc-Unterstützung und einer Datensammlungsregel erstellt.

Bicep-Vorlagendatei

@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-Vorlagendatei

{
  "$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')]"
      }
    }
  ]
}

Parameterdatei

{
  "$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"
    }
   }
}

Bearbeiten einer DCR

Zum Bearbeiten einer DCR können Sie eine der im vorherigen Abschnitt beschriebenen Methoden verwenden, um eine DCR mithilfe einer geänderten Version der JSON-Datei zu erstellen.

Wenn Sie die JSON-Datei für eine vorhandene DCR abrufen müssen, können Sie sie aus der JSON-Ansicht für die DCR im Azure-Portal kopieren. Sie können sie auch mithilfe eines API-Aufrufs abrufen, wie im folgenden PowerShell-Beispiel gezeigt:

$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

Ein Tutorial, in dem der Prozess zum Abrufen und Bearbeiten einer vorhandenen DCR erläutert wird, finden Sie unter Tutorial: Bearbeiten einer Datensammlungsregel (Data Collection Rule, DCR).