Skapa diagnostikinställningar i Azure Monitor

Skapa och redigera diagnostikinställningar i Azure Monitor för att skicka Azure-plattformsmått och -loggar till olika mål som Azure Monitor-loggar, Azure Storage eller Azure Event Hubs. Du kan använda olika metoder för att arbeta med diagnostikinställningarna, till exempel Azure-portalen, Azure CLI, PowerShell och Azure Resource Manager.

Viktigt!

Kvarhållningsprincipen som anges i inställningarna för diagnostikinställning är nu inaktuell och kan inte längre användas. Använd livscykelpolicyn för Azure Storage för att hantera hur lång tid loggarna behålls. Mer information finns i Migrera lagringskvarhållning för diagnostikinställningar till livscykelhantering i Azure Storage

Azure-portalen

Du kan konfigurera diagnostikinställningar i Azure-portalen antingen från Azure Monitor-menyn eller från menyn för resursen.

1. Var du konfigurerar diagnostikinställningar i Azure-portalen beror på resursen:

   • För en enskild resurs väljer du Diagnostikinställningar under Övervakning på resursens meny.

     

   • För en eller flera resurser väljer du Diagnostikinställningar under Inställningar på Azure Monitor-menyn och väljer sedan resursen.

     

   • För aktivitetsloggen väljer du Aktivitetslogg på Azure Monitor-menyn och väljer sedan Exportera aktivitetsloggar. Se till att du inaktiverar alla äldre konfigurationer för aktivitetsloggen. Anvisningar finns i Inaktivera befintliga inställningar.

     

2. Om det inte finns några inställningar för den resurs du väljer uppmanas du att skapa en inställning. Välj Lägg till diagnostikinställning.

   

   Om det finns befintliga inställningar på resursen visas en lista över inställningar som redan har konfigurerats. Välj Lägg till diagnostikinställning för att lägga till en ny inställning. Eller välj Redigera inställning för att redigera en befintlig inställning. Varje inställning får inte ha mer än en av varje måltyper.

   

3. Ge inställningen ett namn om den inte redan har en.

   

4. Loggar och mått som ska dirigeras: För loggar väljer du antingen en kategorigrupp eller markerar de enskilda kryssrutorna för varje kategori av data som du vill skicka till de mål som anges senare. Listan över kategorier varierar för varje Azure-tjänst. Välj AllMetrics om du också vill lagra mått i Azure Monitor-loggar.

5. Målinformation: Markera kryssrutan för varje mål. Alternativen visas så att du kan lägga till mer information.

   

   1. Skicka till Log Analytics-arbetsytan: Välj din prenumeration och den Log Analytics-arbetsyta där du vill skicka data. Om du inte har någon arbetsyta måste du skapa en innan du fortsätter.

   2. Arkivera till ett lagringskonto: Välj din prenumeration och det lagringskonto där du vill lagra data.

      

      Dricks

      Använd livscykelpolicyn för Azure Storage för att hantera hur lång tid loggarna behålls. Kvarhållningsprincipen som anges i inställningarna för diagnostikinställning är nu inaktuell.

   3. Strömma till en händelsehubb: Ange följande villkor:

      • Prenumeration: Den prenumeration som händelsehubben ingår i.
      • Namnområde för händelsehubb: Om du inte har något måste du skapa ett.
      • Händelsehubbnamn (valfritt): Namnet som alla data ska skickas till. Om du inte anger något namn skapas en händelsehubb för varje loggkategori. Om du skickar till flera kategorier kanske du vill ange ett namn för att begränsa antalet skapade händelsehubbar. Mer information finns i kvoter och gränser för Azure Event Hubs.
      • Namn på händelsehubbprincip (även valfritt): En princip definierar de behörigheter som strömningsmekanismen har. Mer information finns i Event Hubs-funktioner.

   4. Skicka till partnerlösning: Du måste först installera Azure Native ISV Services i din prenumeration. Konfigurationsalternativen varierar beroende på partner. Mer information finns i Översikt över Azure Native ISV Services.

6. Om tjänsten stöder både resursspecifikt och Azure-diagnostikläge kan du välja måltabellen när du väljer Log Analytics-arbetsyta som mål. Du bör vanligtvis välja Resursspecifik eftersom tabellstrukturen ger mer flexibilitet och effektivare frågor.

   

7. Välj Spara.

Efter en liten stund visas den nya inställningen i listan med inställningar för den här resursen. Loggar strömmas till de angivna destinationerna när nya händelsedata genereras. Det kan ta upp till 15 minuter mellan när en händelse genereras och när den visas på en Log Analytics-arbetsyta.

PowerShell

Använd cmdleten New-AzDiagnosticSetting för att skapa en diagnostikinställning med Azure PowerShell. I dokumentationen för den här cmdleten finns beskrivningar av dess parametrar.

Viktigt!

Du kan inte använda den här metoden för en aktivitetslogg. Använd i stället Skapa diagnostikinställning i Azure Monitor med hjälp av en Azure Resource Manager-mall för att skapa en Resource Manager-mall och distribuera den med PowerShell.

I följande exempel skapar PowerShell-cmdleten en diagnostikinställning för alla loggar eller för granskningsloggar och mått för ett nyckelvalv med hjälp av Log Analytics-arbetsytan.

$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

CLI

Använd kommandot az monitor diagnostic-settings create för att skapa en diagnostikinställning med Azure CLI. I dokumentationen för det här kommandot finns beskrivningar av dess parametrar.

Viktigt!

Du kan inte använda den här metoden för en aktivitetslogg. Använd i stället Skapa diagnostikinställning i Azure Monitor med hjälp av en Resource Manager-mall för att skapa en Resource Manager-mall och distribuera den med Azure CLI.

Följande exempelkommando skapar en diagnostikinställning med hjälp av alla tre mål. Syntaxen skiljer sig något beroende på klienten.

Om du vill ange resursspecifikt läge om tjänsten stöder det lägger du till parametern export-to-resource-specific med värdet true.'

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

Resource Manager

Följande JSON-mall är ett exempel på hur du skapar en diagnostikinställning för att skicka alla granskningsloggar till en log analytics-arbetsyta. Tänk på att apiVersion kan ändras beroende på resursen i omfånget.

Mallfil

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

Parameterfil

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

Information om hur du skapar eller uppdaterar diagnostikinställningar med hjälp av Rest-API:et för Azure Monitor finns i Diagnostikinställningar.

Azure Policy

Mer information om hur du använder Azure Policy för att skapa diagnostikinställningar i stor skala finns i Skapa diagnostikinställningar i stor skala med hjälp av Azure Policy.

Felsökning

Här följer några felsökningstips.

Måttkategori stöds inte

När du distribuerar en diagnostikinställning får du ett felmeddelande som liknar "Måttkategorin "xxxx" stöds inte. Du kan få det här felet även om din tidigare distribution lyckades.

Problemet uppstår när du använder en Resource Manager-mall, REST API, CLI eller Azure PowerShell. Diagnostikinställningar som skapas via Azure-portalen påverkas inte eftersom endast de kategorinamn som stöds visas.

Problemet uppstår på grund av en nyligen genomförd ändring i det underliggande API:et. Andra måttkategorier än AllMetrics stöds inte och har aldrig varit undantagna för några få specifika Azure-tjänster. Tidigare ignorerades andra kategorinamn när en diagnostikinställning distribuerades. Azure Monitor-serverdelen omdirigerade dessa kategorier till AllMetrics. Från och med februari 2021 uppdaterades serverdelen för att specifikt bekräfta att den angivna måttkategorin är korrekt. Den här ändringen kan leda till att vissa distributioner misslyckas.

Om du får det här felet uppdaterar du distributionerna för att ersätta eventuella måttkategorinamn med AllMetrics för att åtgärda problemet. Om distributionen tidigare lade till flera kategorier behåller du bara en med AllMetrics-referensen. Om problemet kvarstår kontaktar du Azure-supporten via Azure-portalen.

Inställningen försvinner på grund av icke-ASCII-tecken i resourceID

Diagnostikinställningar stöder inte resurs-ID:t med icke-ASCII-tecken. Tänk till exempel på termen "Preproducción". Eftersom du inte kan byta namn på resurser i Azure är det enda alternativet att skapa en ny resurs utan icke-ASCII-tecken. Om tecknen finns i en resursgrupp kan du flytta resurserna under den till en ny. Annars måste du återskapa resursen.

Möjlighet till duplicerade eller borttagna data

Alla ansträngningar görs för att säkerställa att alla loggdata skickas korrekt till dina mål, men det går inte att garantera 100 % dataöverföring av loggar mellan slutpunkter. Återförsök och andra mekanismer finns på plats för att lösa dessa problem och försöka se till att loggdata kommer till slutpunkten.

Nästa steg

• Granska hur du arbetar med diagnostikinställningar i Azure Monitor
• Migrera lagringskvarhållning för diagnostikinställningar till livscykelhantering i Azure Storage
• Läs mer om Azure-plattformsloggar