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 Portal, 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 Portal antingen från Azure Monitor-menyn eller från menyn för resursen.

1. Var du konfigurerar diagnostikinställningar i Azure Portal 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.

      

      Tips/Råd

      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 = 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

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, Azure CLI eller Azure PowerShell. Diagnostikinställningar som skapas via Azure Portal påverkas inte eftersom endast de kategorinamn som stöds visas.

Andra måttkategorier än AllMetrics stöds inte förutom ett begränsat antal Azure-tjänster. Tidigare ignorerades andra kategorinamn när du distribuerade en diagnostikinställning och omdirigerade dem till AllMetrics. Från och med februari 2021 verifieras den angivna måttkategorin. Den här ändringen gjorde att vissa distributioner misslyckades.

Åtgärda problemet genom att uppdatera dina distributioner för att ta bort eventuella andra måttkategorinamn än AllMetrics. Om distributionen lägger till flera kategorier använder du bara en AllMetrics kategori. Om problemet kvarstår kontaktar du Azure Support via Azure Portal.

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

Diagnostikinställningar stöder inte resourceID med icke-ASCII-tecken (till exempel Preproduccón). Eftersom du inte kan byta namn på resurser i Azure måste du skapa en ny resurs utan icke-ASCII-tecken. Om tecknen finns i en resursgrupp kan du flytta resurserna till en ny grupp.

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.

Inaktiva resurser

När en resurs är inaktiv och exporterar nollvärdesmått backar exportmekanismen för diagnostikinställningar inkrementellt för att undvika onödiga kostnader för att exportera och lagra nollvärden. Säkerhetskopieringen kan leda till en fördröjning i exporten av nästa värde som inte är noll.

När en resurs är inaktiv i en timme backar exportmekanismen till 15 minuter. Det innebär att det finns en potentiell svarstid på upp till 15 minuter för att nästa icke-nollvärde ska exporteras. Den maximala backoff-tiden på två timmar uppnås efter sju dagars inaktivitet. När resursen börjar exportera icke-nollvärden återgår exportmekanismen till den ursprungliga exportfördröjningen på tre minuter.

Det här beteendet gäller endast exporterade mått och påverkar inte måttbaserade aviseringar eller autoskalning.

Varför visas dubbletttelemetri i Application Insights när jag har aktiverat diagnostikinställningar?

När du aktiverar diagnostikinställningar för att exportera Application Insights-data som är baserade på arbetsytor till valfri Log Analytics-arbetsyta, inklusive samma som redan lagrar Application Insights-data, returnerar frågor dubbletter av resultaten. Den här dupliceringen sker eftersom både standardpipelinen och diagnostikinställningarna skickar samma data till arbetsytan.

För att undvika duplicerad telemetri ska du inte konfigurera diagnostikinställningar för att skicka data till samma arbetsyta. Om du behöver exportera data till en annan arbetsyta använder du en datainsamlingsregel (DCR) med en transformering och en anpassad tabell. Den här konfigurationen filtrerar data före inmatning och förhindrar dubbletter av poster i dina frågor.

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 Monitor-datakällor och datainsamlingsmetoder