Diagnoseeinstellungen in Azure Monitor

Mithilfe von Diagnoseeinstellungen in Azure Monitor können Sie Ressourcenprotokolle sammeln und platform-Metriken und das activity-Protokoll an verschiedene Ziele senden. Erstellen Sie eine separate Diagnoseeinstellung für jede Ressource, aus der Sie Daten sammeln möchten. Jede Einstellung definiert die Daten aus der zu erfassenden Ressource und die Ziele, an die diese Daten gesendet werden sollen. In diesem Artikel werden die Details der Diagnoseeinstellungen beschrieben, einschließlich der Erstellung und der Ziele, die für das Senden von Daten verfügbar sind.

Das folgende Video führt Sie durch das Routing von Ressourcenplattformprotokollen mit Diagnoseeinstellungen. Die folgenden Änderungen wurden an den Diagnoseeinstellungen vorgenommen, seit das Video aufgezeichnet wurde, aber diese Themen werden in diesem Artikel behandelt.

• Azure Monitor Partner
• Kategoriegruppen

Sources

Diagnoseeinstellungen können Daten aus den Quellen in der folgenden Tabelle sammeln. Ausführliche Informationen zu den Daten, die jede Quelle sammelt, und deren Format in jedem Ziel finden Sie im verknüpften Artikel.

Nachdem Sie eine Diagnoseeinstellung konfiguriert haben, variiert die Zeit für jede Datenquelle, die für die Analyse zur Verfügung steht. Die erwartete Latenz für Plattformmetriken, Ressourcenprotokolle und Aktivitätsprotokolle finden Sie unter Protokolldatenaufnahmezeit in Azure Monitor.

Destinations

Diagnoseeinstellungen senden Daten an die Ziele in der folgenden Tabelle. Um die Sicherheit von Daten während der Übertragung sicherzustellen, werden alle Zielendpunkte so konfiguriert, dass TLS 1.2 unterstützt wird.

Eine einzelne Diagnoseeinstellung kann nicht mehr als eines von jedem Ziel definieren. Wenn Sie Daten an mehrere eines bestimmten Zieltyps senden möchten (z. B. zwei Log Analytics Arbeitsbereiche), erstellen Sie mehrere Einstellungen. Jede Ressource kann bis zu fünf Diagnoseeinstellungen haben.

Alle Ziele, die eine Diagnoseeinstellung verwendet, müssen bereits vorhanden sein, bevor Sie die Einstellung erstellen können. Das Ziel muss sich nicht im gleichen Abonnement wie die Ressource befinden, die Protokolle sendet, wenn der Benutzer, der die Einstellung konfiguriert, über einen geeigneten Azure rollenbasierten Zugriffssteuerungszugriff (RBAC) für beide Abonnements verfügt. Verwenden Sie Azure Lighthouse, um Ziele in einen anderen Microsoft Entra Mandanten einzufügen.

Methoden zum Erstellen einer Diagnoseeinstellung

Sie können eine Diagnoseeinstellung mithilfe einer der folgenden Methoden erstellen.

Informationen zum Erstellen einer Diagnoseeinstellung für das Aktivitätsprotokoll mithilfe des Azure Portals finden Sie unter Exportieren des Aktivitätsprotokolls. Informationen zum Erstellen einer Diagnoseeinstellung für eine Verwaltungsgruppe finden Sie unter "Diagnoseeinstellungen für Verwaltungsgruppen".

$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 = New-AzDiagnosticSettingMetricSettingsObject -Enabled $true -Category AllMetrics
$log = New-AzDiagnosticSettingLogSettingsObject -Enabled $true -CategoryGroup allLogs  # use audit for only audit logs
New-AzDiagnosticSetting -Name 'KeyVault-Diagnostics' -ResourceId $KV.ResourceId -WorkspaceId $Law.ResourceId -Log $log -Metric $metric -Verbose

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

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

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

param scope string
param workspaceId string
param settingName string

resource diag 'Microsoft.Insights/diagnosticSettings@2021-05-01-preview' = {
    name: settingName
    scope: scope
    properties: {
      workspaceId: workspaceId
      logs: [
          {
              category: null
              categoryGroup: 'audit'
              enabled: true
          }
      ]
    }
}

using './<template-file-name>.bicep'

param settingName = 'audit3'

param workspaceId = '/subscriptions/<subscription id>/resourcegroups/<resourcegroup name>/providers/microsoft.operationalinsights/workspaces/<workspace name>'

param scope = 'Microsoft.<resource type>/<resourceName>

Kategoriegruppen

Sie können Kategoriegruppen verwenden, um Ressourcenprotokolle basierend auf vordefinierten Gruppierungen zu sammeln, anstatt einzelne Protokollkategorien auszuwählen. Microsoft definiert die Gruppierungen, um häufige Anwendungsfälle zu überwachen. Wenn die Kategorien in der Gruppe aktualisiert werden, wird Ihre Protokollsammlung automatisch geändert.

Nicht alle Azure Dienste verwenden Kategoriegruppen. Wenn Kategoriegruppen für eine bestimmte Ressource nicht verfügbar sind, ist die Option beim Erstellen der Diagnoseeinstellung nicht verfügbar.

Wenn Sie Kategoriegruppen in einer Diagnoseeinstellung verwenden, können Sie keine einzelnen Kategorietypen auswählen. Derzeit gibt es zwei Gruppen von Kategorien:

• allLogs: Alle Kategorien für die Ressource.
• audit: Alle Ressourcenprotokolle, die Kundeninteraktionen mit Daten oder den Einstellungen des Diensts aufzeichnen. Sie müssen diese Kategoriegruppe nicht auswählen, wenn Sie die allLogs Kategoriegruppe auswählen.

Metrikeinschränkungen

Nicht alle Metriken können mit Diagnoseeinstellungen an einen Log Analytics Arbeitsbereich gesendet werden. Siehe die Spalte "Exportierbar " in der Liste der unterstützten Metriken.

Diagnoseeinstellungen unterstützen derzeit keine multidimensionalen Metriken. Metriken mit Dimensionen werden als flache eindimensionale Metriken exportiert und über Dimensionswerte aggregiert. Beispielsweise kann die IOReadBytes Metrik einer Blockchain auf einer Knotenebene untersucht und diagrammiert werden. Wenn die Metrik mit Diagnoseeinstellungen exportiert wird, werden alle Lesebytes für alle Knoten angezeigt.

Um die Einschränkungen für bestimmte Metriken zu umgehen, können Sie sie mithilfe der Metrik-REST-API manuell extrahieren. Sie können sie dann in einen Log Analytics Arbeitsbereich importieren, indem Sie die API Logs Ingestion API verwenden.

Kontrolle von Kosten

Möglicherweise entstehen Kosten für Daten, die durch Diagnoseeinstellungen erhoben werden. Die Kosten hängen vom von Ihnen gewählten Ziel und dem Volumen der gesammelten Daten ab. Weitere Informationen finden Sie unter Azure Monitor-Preise oder im Abschnitt "Häufig gestellte Fragen".

Sammeln Sie nur die Kategorien, die Sie für jeden Dienst benötigen. Möglicherweise möchten Sie auch keine Plattformmetriken aus Azure-Ressourcen sammeln, da Metriken diese Daten bereits sammeln. Konfigurieren Sie Ihre Diagnosedaten so, dass Metriken nur gesammelt werden, wenn Sie Metrikdaten im Arbeitsbereich für eine komplexere Analyse mithilfe von Protokollabfragen benötigen.

Diagnoseeinstellungen lassen keine granulare Filterung innerhalb einer ausgewählten Kategorie zu. Mithilfe von Transformationen können Sie Daten nach unterstützten Tabellen in einem Log Analytics Arbeitsbereich filtern. Ausführliche Informationen finden Sie unter Transformationen in Azure Monitor.

Zeit, bis Daten an Zielorte gelangen

Nachdem Sie eine Diagnoseeinstellung erstellt haben, sollten die Daten innerhalb von 90 Minuten mit dem Fluss zu den ausgewählten Zielen beginnen. Wenn Sie Daten an einen Log Analytics Arbeitsbereich senden, wird die Tabelle automatisch erstellt, wenn sie noch nicht vorhanden ist. Die Tabelle wird nur erstellt, wenn die Ziele die ersten Protokolldatensätze empfangen.

Wenn Sie innerhalb von 24 Stunden keine Informationen erhalten, tritt möglicherweise eines der folgenden Probleme auf:

• Es werden keine Protokolle generiert.
• Im zugrunde liegenden Routingmechanismus ist ein Fehler aufgetreten.

Versuchen Sie, die Konfiguration zu deaktivieren und dann erneut zu aktivieren. Wenn das Problem weiterhin besteht, wenden Sie sich über das Azure-Portal an Azure support.

Application Insights

Berücksichtigen Sie die folgenden Informationen für Diagnoseeinstellungen für Application Insights-Anwendungen:

• Das Ziel kann nicht derselbe Log Analytics Arbeitsbereich sein, auf dem Ihre Application Insights-Ressource basiert.
• Der Application Insights-Benutzer kann nicht auf beide Arbeitsbereiche zugreifen. Legen Sie den Log Analytics Zugriffssteuerungsmodus auf Requires Workspace permissions fest. Stellen Sie über Azure RBAC sicher, dass der Benutzer nur auf den Log Analytics Arbeitsbereich zugreifen kann, auf dem die Application Insights-Ressource basiert.

Diese Schritte sind erforderlich, da Application Insights über Ressourcen hinweg auf Daten zugreift, um vollständige End-to-End-Transaktionsvorgänge und genaue Anwendungszuordnungen bereitzustellen. Zu diesen Ressourcen gehören die Log Analytics Arbeitsbereiche. Da Diagnoseprotokolle dieselben Tabellennamen verwenden, können doppelte Daten angezeigt werden, wenn der Benutzer Zugriff auf mehrere Ressourcen hat, die dieselben Daten enthalten.

Troubleshooting

Die Metrikkategorie wird nicht unterstützt.

Möglicherweise wird eine Fehlermeldung wie "Metrische Kategorie 'xxxx' wird nicht unterstützt" angezeigt, wenn Sie eine Resource Manager Vorlage, die REST-API, die Azure CLI oder Azure PowerShell verwenden. Metrikkategorien außer AllMetrics werden nicht unterstützt, mit Ausnahme einer begrenzten Anzahl von Azure-Diensten. Entfernen Sie alle Metrikkategorienamen außer AllMetrics und wiederholen Sie die Bereitstellung.

Die Einstellungen verschwinden aufgrund von Nicht-ASCII-Zeichen in einer Ressourcen-ID.

Diagnoseeinstellungen unterstützen keine Ressourcen-IDs mit Nicht-ASCII-Zeichen (z. B. Preproduccón). Da Sie Ressourcen in Azure nicht umbenennen können, müssen Sie eine neue Ressource ohne die Nicht-ASCII-Zeichen erstellen. Wenn sich die Charaktere in einer Ressourcengruppe befinden, können Sie die Ressourcen in eine neue Gruppe verschieben.

Ressource ist inaktiv

Wenn eine Ressource inaktiv ist und Nullwertmetriken exportiert, wird der Exportmechanismus der Diagnoseeinstellungen inkrementell deaktiviert, um unnötige Kosten beim Exportieren und Speichern von Nullwerten zu vermeiden. Dieser Rückfallmechanismus kann zu einer Verzögerung beim Export des nächsten Nicht-Null-Werts führen. Dieses Verhalten gilt nur für exportierte Metriken und wirkt sich nicht auf metrikbasierte Warnungen oder automatische Skalierung aus.

Wenn eine Ressource eine Stunde lang inaktiv ist, wird für den Exportmechanismus ein Backoff auf 15 Minuten ausgeführt. Diese Situation bedeutet, dass es eine potenzielle Latenz von bis zu 15 Minuten für den nächsten wert ungleich null gibt, der exportiert werden soll. Die Ressource erreicht die maximale Backoffzeit von zwei Stunden nach sieben Tagen Inaktivität. Nachdem die Ressource mit dem Exportieren von Nichtzerowerten begonnen hat, wird der Exportmechanismus auf die ursprüngliche Exportlatenz von drei Minuten zurückgesetzt.

Die erwartete Latenz unter normalen Betriebsbedingungen für alle Quelltypen finden Sie unter Protokolldatenaufnahmezeit in Azure Monitor.

Verwandte Inhalte

• Von der Diagnoseeinstellungen Speicheraufbewahrung zur Lebenszyklusverwaltung von Azure Storage migrieren
• Azure Monitor Datenquellen und Datensammlungsmethoden