Erstellen und Bearbeiten von Datensammlungsregeln (Data Collection Rules, DCRs) in Azure Monitor
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 |
|
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 |
|
Stellen Sie Agent-Erweiterungen auf der VM bereit. |
Jede Rolle, die die Aktion Microsoft.Resources/deployments/* enthält |
|
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'
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).