Erstellen von Diagnoseeinstellungen in Azure Monitor

Erstellen und bearbeiten Sie Diagnoseeinstellungen in Azure Monitor, um Metriken und Protokolle der Azure-Plattform an verschiedene Ziele zu senden, z. B. an Azure Monitor-Protokolle, Azure Storage oder Azure Event Hubs. Sie können verschiedene Methoden verwenden, um mit den Diagnoseeinstellungen zu arbeiten, z. B. das Azure-Portal, die Azure CLI, PowerShell und Azure Resource Manager.

Wichtig

Die Aufbewahrungsrichtlinie, so wie sie in den Einstellungen für die Diagnoseeinstellung festgelegt ist, ist jetzt veraltet und kann nicht mehr benutzt werden. Verwenden Sie die Azure Storage-Lebenszyklusrichtlinie, um die Dauer der Aufbewahrung Ihrer Protokolle zu verwalten. Weitere Informationen finden Sie unter Migrieren Sie die Speicheraufbewahrung von Diagnose-Einstellungen zu Azure Storage-Lebenszyklusverwaltung

Azure portal

Sie können Diagnoseeinstellungen im-Azure-Portal entweder über das Azure Monitor-Menü oder über das Menü für die Ressource konfigurieren.

1. Wo Sie Diagnoseeinstellungen im Azure-Portal konfigurieren, hängt von der Ressource ab:

   • Für eine einzelne Ressource wählen Sie Diagnoseeinstellungen unter Überwachung im Menü der Ressource aus.

     

   • Für eine oder mehrere Ressourcen wählen Sie im Azure Monitor-Menü unter Einstellungen die Option Diagnoseeinstellungen und dann die Ressource aus.

     

   • Für das Aktivitätsprotokoll wählen Sie die Option Aktivitätsprotokoll im Azure Monitor-Menü und dann Aktivitätsprotokolle exportieren aus. Stellen Sie sicher, dass Sie alle Legacykonfigurationen für das Aktivitätsprotokoll deaktivieren. Anweisungen finden Sie unter Deaktivieren vorhandener Einstellungen.

     

2. Wenn für die ausgewählte Ressource keine Einstellungen vorhanden sind, werden Sie aufgefordert, eine Einstellung zu erstellen. Klicken Sie auf Diagnoseeinstellung hinzufügen.

   

   Wenn bereits Einstellungen für die Ressource vorhanden sind, wird eine Liste der konfigurierten Einstellungen anagezeigt. Wählen Sie Diagnoseeinstellung hinzufügen aus, um eine neue Einstellung hinzuzufügen. Oder wählen Sie Einstellung bearbeiten aus, um eine bestehende Einstellung zu bearbeiten. Jede Einstellung kann höchstens einen der Zieltypen aufweisen.

   

3. Wenn noch kein Name für die Einstellung vorhanden ist, geben Sie ihr einen Namen.

   

4. Zu routende Protokolle und Metriken: Wählen Sie für Protokolle eine Kategoriegruppe aus oder aktivieren Sie die einzelnen Kontrollkästchen für jede Kategorie von Daten, die Sie später an die angegebenen Ziele senden möchten. Die Liste der Kategorien unterscheidet sich je nach Azure-Dienst. Wählen Sie AllMetrics aus, wenn Sie Metriken auch in Azure Monitor-Protokollen speichern möchten.

5. Zieldetails: Aktivieren Sie das Kontrollkästchen für jedes Ziel. Es werden Optionen angezeigt, sodass Sie weitere Informationen hinzufügen können.

   

   1. Senden an den Log Analytics-Arbeitsbereich: Wählen Sie Ihr Abonnement und den Log Analytics-Arbeitsbereich aus, an den Sie die Daten senden möchten. Wenn Sie noch nicht über einen Arbeitsbereich verfügen, müssen Sie einen Arbeitsbereich erstellen, bevor Sie fortfahren können.

   2. In einem Speicherkonto archivieren: Wählen Sie Ihr Abonnement und das Speicherkonto aus, in dem Sie die Daten speichern möchten.

      

      Tipp

      Verwenden Sie die Azure Storage-Lebenszyklusrichtlinie, um die Dauer der Aufbewahrung Ihrer Protokolle zu verwalten. Die Aufbewahrungsrichtlinie, so wie sie in den Einstellungen für die Diagnoseeinstellung festgelegt ist, ist jetzt veraltet.

   3. Streamen an einen Event Hub: Geben Sie die folgenden Kriterien an:

      • Abonnement: Das Abonnement, zu dem der Event Hub gehört.
      • Event Hub-Namespace: Wenn Sie über keinen verfügen, müssen Sie einen erstellen.
      • Event Hub-Name (optional): Der Name, an den alle Daten gesendet werden. Wenn Sie keinen Namen angeben, wird eine Event Hub für jede Protokollkategorie erstellt. Wenn Sie an mehrere Kategorien senden, können Sie einen Namen angeben, um die Anzahl der erstellten Event Hubs zu beschränken. Weitere Informationen finden Sie unter Kontingente und Grenzwerte in Azure Event Hubs.
      • Event Hub-Richtlinienname (auch optional): Eine Richtlinie definiert die Berechtigungen, über die der Streamingmechanismus verfügt. Weitere Informationen finden Sie unter Event Hubs-Features.

   4. Senden an Partnerlösung: Sie müssen zuerst Azure Native ISV Services in Ihrem Abonnement installieren. Die Konfigurationsoptionen variieren je nach Partner. Weitere Informationen finden Sie unter Übersicht über Azure Native ISV Services.

6. Wenn der Dienst sowohl den ressourcenspezifischen Modus als auch den Azure Diagnosemodus unterstützt, wird eine Option zum Auswählen der Zieltabelle angezeigt, sobald Sie Log Analytics-Arbeitsbereich als Ziel auswählen. In der Regel sollten Sie Ressourcenspezifisch auswählen, da die Tabellenstruktur mehr Flexibilität und effizientere Abfragen ermöglicht.

   

7. Wählen Sie Speichern aus.

Nach einigen Augenblicken wird die neue Einstellung in der Liste der Einstellungen für diese Ressource angezeigt. Protokolle werden an die angegebenen Ziele gestreamt, sobald neue Ereignisdaten generiert werden. Zwischen der Ausgabe eines Ereignisses und dessen Anzeige in einem Log Analytics-Arbeitsbereich können bis zu 15 Minuten vergehen.

PowerShell

Verwenden Sie das Cmdlet New-AzDiagnosticSetting, um eine Diagnoseeinstellung mit Azure PowerShell zu erstellen. Beschreibungen der zugehörigen Parameter finden Sie in der Dokumentation zu diesem Cmdlet.

Wichtig

Sie können diese Methode nicht für ein Aktivitätsprotokoll verwenden. Gehen Sie stattdessen nach der Methode Erstellen von Diagnoseeinstellungen in Azure Monitor mithilfe einer Azure Resource Manager-Vorlage vor, um eine Resource Manager-Vorlage zu erstellen und mit PowerShell bereitzustellen.

Mit dem folgenden Beispiel für ein PowerShell-Cmdlet wird mithilfe des Log Analytics-Arbeitsbereichs eine Diagnoseeinstellung für alle Protokolle oder für Audit-Protokolle und Metriken für einen Schlüsseltresor erstellt.

$KV= Get-AzKeyVault -ResourceGroupName <resource group name> -VaultName <key vault name>
$Law= Get-AzOperationalInsightsWorkspace -ResourceGroupName <resource group name> -Name <workspace name>  #LAW name is case sensitive

$metric = @()
$log = @()
$metric += New-AzDiagnosticSettingMetricSettingsObject -Enabled $true -Category AllMetrics
# For all available logs, use:
$log = New-AzDiagnosticSettingLogSettingsObject -Enabled $true -CategoryGroup allLogs  
# or, for audit logs, use:
$log = New-AzDiagnosticSettingLogSettingsObject -Enabled $true -CategoryGroup audit    
New-AzDiagnosticSetting -Name 'KeyVault-Diagnostics' -ResourceId $KV.ResourceId -WorkspaceId $Law.ResourceId -Log $log -Metric $metric -Verbose

BEFEHLSZEILENSCHNITTSTELLE (CLI)

Verwenden Sie den Befehl az monitor diagnostic-settings create, um eine Diagnoseeinstellung mit der Azure CLI zu erstellen. Beschreibungen der zugehörigen Parameter finden Sie in der Dokumentation zu diesem Befehl.

Wichtig

Sie können diese Methode nicht für ein Aktivitätsprotokoll verwenden. Gehen Sie stattdessen nach der Methode Erstellen von Diagnoseeinstellungen in Azure Monitor mithilfe einer Resource Manager-Vorlage vor, um eine Resource Manager-Vorlage zu erstellen und mit der Azure CLI bereitzustellen.

Der folgende Beispielbefehl erstellt eine Diagnoseeinstellung, bei der alle drei Ziele verwendet werden. Die Syntax kann je nach Client geringfügig variieren.

Um den ressourcenspezifischen Modus anzugeben, wenn der Dienst ihn unterstützt, fügen Sie den export-to-resource-specific Parameter mit dem Wert von true hinzu.

az monitor diagnostic-settings create  \
--name KeyVault-Diagnostics \
--resource /subscriptions/<subscription ID>/resourceGroups/<resource group name>/providers/Microsoft.KeyVault/vaults/mykeyvault \
--logs    '[{"category": "AuditEvent","enabled": true}]' \
--metrics '[{"category": "AllMetrics","enabled": true}]' \
--storage-account /subscriptions/<subscription ID>/resourceGroups/<resource group name>/providers/Microsoft.Storage/storageAccounts/<storage account name> \
--workspace /subscriptions/<subscription ID>/resourcegroups/<resource group name>/providers/microsoft.operationalinsights/workspaces/<log analytics workspace name> \
--event-hub-rule /subscriptions/<subscription ID>/resourceGroups/<resource group name>/providers/Microsoft.EventHub/namespaces/<event hub namespace>/authorizationrules/RootManageSharedAccessKey \
--event-hub <event hub name> \
--export-to-resource-specific true

Ressourcen-Manager

Die folgende JSON-Vorlage enthält ein Beispiel zum Erstellen einer Diagnoseeinstellung, mit der alle Überwachungsprotokolle an einen Log Analytics-Arbeitsbereich gesendet werden. Beachten Sie, dass sich die apiVersion je nach Ressource im Bereich ändern kann.

Vorlagendatei

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "scope": {
        "type": "string"
    },
    "workspaceId": {
        "type": "string"
    },
    "settingName": {
        "type": "string"
    }
},
  "resources": [
    {
      "type": "Microsoft.Insights/diagnosticSettings",
      "apiVersion": "2021-05-01-preview",
      "scope": "[parameters('scope')]",
      "name": "[parameters('settingName')]",
      "properties": {
       "workspaceId": "[parameters('workspaceId')]",
      "logs": [
             {
            "category": null,
            "categoryGroup": "audit",
            "enabled": true
          }
        ]
      }
    }
  ]
  }

Parameterdatei

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "settingName": {
        "value": "audit3"
    },
    "workspaceId": {
      "value": "/subscriptions/<subscription id>/resourcegroups/<resourcegroup name>/providers/microsoft.operationalinsights/workspaces/<workspace name>"
    },
    "scope": {
      "value": "Microsoft.<resource type>/<resourceName>"
    }
  }
}

REST-API

Informationen zum Erstellen oder Aktualisieren von Diagnoseeinstellungen mithilfe der Azure Monitor-REST-API finden Sie unter Diagnoseeinstellungen.

Azure Policy

Weitere Informationen zur Verwendung von Azure Policy zum Erstellen von Diagnoseeinstellungen in großem Stil finden Sie unter Erstellen von Diagnoseeinstellungen im großen Stil mithilfe von Azure Policy.

Problembehandlung

Hier folgen einige Tipps zur Problembehandlung.

Die Metrikkategorie wird nicht unterstützt.

Wenn Sie eine Diagnoseeinstellung bereitstellen, erhalten Sie eine Fehlermeldung ähnlich der folgenden: „Die Metrikkategorie 'xxxx' wird nicht unterstützt.“ Möglicherweise erhalten Sie diese Fehlermeldung, obwohl Ihre vorherige Bereitstellung erfolgreich war.

Das Problem tritt auf, wenn Sie eine Resource Manager-Vorlage, die REST-API, die CLI oder Azure PowerShell verwenden. Über das Azure-Portal erstellte Diagnoseeinstellungen sind nicht betroffen, da nur die unterstützten Kategorienamen angezeigt werden.

Das Problem tritt aufgrund einer kürzlich erfolgten Änderung in der zugrunde liegenden API auf. Andere Metrikkategorien als AllMetrics werden nicht unterstützt und wurden mit Ausnahme einiger weniger spezifischer Azure-Dienste auch nie unterstützt. In der Vergangenheit wurden andere Kategorienamen beim Bereitstellen einer Diagnoseeinstellung ignoriert. Das Azure Monitor-Back-End leitete diese Kategorien zu AllMetrics um. Im Februar 2021 wurde das Back-End aktualisiert, sodass speziell dafür gesorgt ist, dass die bereitgestellte Metrikkategorie korrekt ist. Diese Änderung kann dazu führen, dass einige Bereitstellungen zu Fehlern führen.

Wenn Sie diesen Fehler erhalten, aktualisieren Sie Ihre Bereitstellungen, sodass alle Metrikkategorienamen durch AllMetrics ersetzt werden, um das Problem zu beheben. Wenn bei der Bereitstellung zuvor mehrere Kategorien hinzugefügt wurden, behalten Sie nur eine mit dem AllMetrics-Verweis bei. Wenn das Problem weiterhin besteht, wenden Sie sich an den Azure-Support über das Azure-Portal.

Einstellung wird aufgrund von Nicht-ASCII-Zeichen in resourceID nicht mehr angezeigt

Diagnoseeinstellungen unterstützen keine Ressourcen-IDs mit Nicht-ASCII-Zeichen. Sehen Sie sich beispielsweise den Begriff „Präproduktion“ an. Da Sie Ressourcen in Azure nicht umbenennen können, besteht Ihre einzige Möglichkeit darin, eine neue Ressource ohne die Nicht-ASCII-Zeichen zu erstellen. Wenn sich die Zeichen in einer Ressourcengruppe befinden, können Sie die darin enthaltenen Ressourcen in eine neue verschieben. Andernfalls müssen Sie die Ressource neu erstellen.

Möglichkeit des Auftretens von duplizierten oder gelöschten Daten

Es wird alles dafür getan, um sicherzustellen, dass alle Protokolldaten ordnungsgemäß an Ihre Ziele gesendet werden. Zwischen Endpunkten kann jedoch keine hundertprozentige Datenübertragung von Protokollen garantiert werden. Wiederholungen und andere Mechanismen sind vorhanden, um diese Probleme zu umgehen und sicherzustellen, dass Protokolldaten beim Endpunkt ankommen.

Nächste Schritte

• Arbeiten mit Diagnoseeinstellungen in Azure Monitor
• Migrieren Sie die Speicheraufbewahrung von Diagnose-Einstellungen zu Azure Storage-Lebenszyklusverwaltung
• Weitere Informationen zu Protokollen der Azure-Plattform