Aktivera övervakning för AKS-kluster

Förutsättningar

• Hanterad identitetsautentisering är standard i CLI version 2.49.0 eller senare.
• Aks-preview-tillägget måste avinstalleras från AKS-kluster med hjälp av kommandot az extension remove --name aks-preview.

Prometheus mätvärden

Använd -enable-azure-monitor-metrics alternativet med az aks create eller az aks update beroende på om du skapar ett nytt kluster eller uppdaterar ett befintligt kluster för att installera tilläggsprogrammet för metrik som skrapar Prometheus-metrik. Då används konfigurationen som beskrivs i standardkonfigurationen för Prometheus-mått i Azure Monitor. För att ändra den här konfigurationen, se Anpassa insamling av Prometheus-metrik i Azure Monitor-hanterad tjänst för Prometheus .

Se följande exempel.

### Use default Azure Monitor workspace
az aks create/update --enable-azure-monitor-metrics --name <cluster-name> --resource-group <cluster-resource-group>

### Use existing Azure Monitor workspace
az aks create/update --enable-azure-monitor-metrics --name <cluster-name> --resource-group <cluster-resource-group> --azure-monitor-workspace-resource-id <workspace-name-resource-id>

### Use an existing Azure Monitor workspace and link with an existing Grafana workspace
az aks create/update --enable-azure-monitor-metrics --name <cluster-name> --resource-group <cluster-resource-group> --azure-monitor-workspace-resource-id <azure-monitor-workspace-name-resource-id> --grafana-resource-id  <grafana-workspace-name-resource-id>

### Use optional parameters
az aks create/update --enable-azure-monitor-metrics --name <cluster-name> --resource-group <cluster-resource-group> --ksm-metric-labels-allow-list "namespaces=[k8s-label-1,k8s-label-n]" --ksm-metric-annotations-allow-list "pods=[k8s-annotation-1,k8s-annotation-n]"

Exempel

az aks create/update --enable-azure-monitor-metrics --name "my-cluster" --resource-group "my-resource-group" --azure-monitor-workspace-resource-id "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/my-resource-group/providers/microsoft.monitor/accounts/my-workspace"

Valfria parametrar

Vart och ett av kommandona ovan tillåter följande valfria parametrar. Parameternamnet är olika för varje, men deras användning är densamma.

Containerloggar

Använd --addon monitoring-alternativet med az aks create för ett nytt kluster eller az aks enable-addon för att uppdatera ett befintligt kluster för att aktivera insamlingen av containerloggar. Se nedan för att ändra loggsamlingsinställningarna.

Se följande exempel.

### Use default Log Analytics workspace
az aks enable-addons --addon monitoring --name <cluster-name> --resource-group <cluster-resource-group-name>

### Use existing Log Analytics workspace
az aks enable-addons --addon monitoring --name <cluster-name> --resource-group <cluster-resource-group-name> --workspace-resource-id <workspace-resource-id>

### Use custom log configuration file
az aks enable-addons --addon monitoring --name <cluster-name> --resource-group <cluster-resource-group-name> --workspace-resource-id <workspace-resource-id> --data-collection-settings dataCollectionSettings.json

### Use legacy authentication
az aks enable-addons --addon monitoring --name <cluster-name> --resource-group <cluster-resource-group-name> --workspace-resource-id <workspace-resource-id> --enable-msi-auth-for-monitoring false

Exempel

az aks enable-addons --addon monitoring --name "my-cluster" --resource-group "my-resource-group" --workspace-resource-id "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/my-resource-group/providers/Microsoft.OperationalInsights/workspaces/my-workspace"

Loggkonfigurationsfil

Om du vill anpassa loggsamlingsinställningarna för klustret kan du ange konfigurationen som en JSON-fil med följande format. Om du inte anger någon konfigurationsfil används standardinställningarna i tabellen nedan.

{
  "interval": "1m",
  "namespaceFilteringMode": "Include",
  "namespaces": ["kube-system"],
  "enableContainerLogV2": true, 
  "streams": ["Microsoft-Perf", "Microsoft-ContainerLogV2"]
}

Var och en av inställningarna i konfigurationen beskrivs i följande tabell.

Förutsättningar

• Azure Monitor-arbetsytan och Azure Managed Grafana-instansen måste redan ha skapats.
• Mallen måste distribueras i samma resursgrupp som Azure Managed Grafana-instansen.
• Om Azure Managed Grafana-instansen finns i en annan prenumeration än Azure Monitor-arbetsyteprenumerationen registrerar du Azure Monitor-arbetsyteprenumerationen Microsoft.Dashboard hos resursprovidern med hjälp av vägledningen hos Registrera resursprovider.
• Användare med User Access Administrator-rollen i AKS-klustrets prenumeration kan aktivera Monitoring Reader-rollen direkt genom att implementera mallen.

Prometheus mätvärden

Hämta nödvändiga värden för Grafana-resurs

Om Azure Managed Grafana-instansen redan är länkad till en Azure Monitor-arbetsyta måste du inkludera den här listan i mallen, annars skrivs den över. På sidan Översikt för Azure Managed Grafana-instansen i Azure Portal väljer du JSON-vyn och kopierar värdet azureMonitorWorkspaceIntegrations som ser ut ungefär som exemplet nedan. Om den inte finns har instansen inte länkats till någon Azure Monitor-arbetsyta.

"properties": {
    "grafanaIntegrations": {
        "azureMonitorWorkspaceIntegrations": [
            {
                "azureMonitorWorkspaceResourceId": "full_resource_id_1"
            },
            {
                "azureMonitorWorkspaceResourceId": "full_resource_id_2"
            }
        ]
    }
}

Ladda ned och redigera mall- och parameterfil

1. Ladda ned nödvändiga filer.

   Biceps

   • Mallfil: https://aka.ms/azureprometheus-enable-bicep-template
   • Parameterfil: https://aka.ms/azureprometheus-enable-bicep-template-parameters
   • DCRA-modul: https://aka.ms/nested_azuremonitormetrics_dcra_clusterResourceId
   • Profilmodul: https://aka.ms/nested_azuremonitormetrics_profile_clusterResourceId
   • Azure Managed Grafana-rolltilldelningsmodul: https://aka.ms/nested_grafana_amw_role_assignment

   JSON

   • Mallfil: https://aka.ms/azureprometheus-enable-arm-template
   • Parameterfil: https://aka.ms/azureprometheus-enable-arm-template-parameters

2. Redigera följande värden i parameterfilen. Samma uppsättning värden används för både ARM- och Bicep-mallarna. Hämta resurs-ID:t för resurserna från JSON-vyn för deras översiktssida .

   Parameter	Värde
   azureMonitorWorkspaceResourceId	Resurs-ID för Azure Monitor-arbetsytan. Hämta från JSON-vyn på sidan Översikt för Azure Monitor-arbetsytan.
   azureMonitorWorkspaceLocation	Plats för Azure Monitor-arbetsytan. Hämta från JSON-vyn på sidan Översikt för Azure Monitor-arbetsytan.
   clusterResourceId	Resurs-ID för AKS-klustret. Hämta från JSON-vyn på sidan Översikt för klustret.
   clusterLocation	Platsen för AKS-klustret. Hämta från JSON-vyn på sidan Översikt för klustret.
   metricLabelsAllowlist	Kommaavgränsad lista över Kubernetes etikett-nycklar som ska användas i resursens etikettmetrik.
   metricAnnotationsAllowList	Kommaavgränsad lista med fler Kubernetes-etikettnycklar som ska användas i resursens annoteringsmetrik.
   grafanaResourceId	Resurs-ID för den hanterade Grafana-instansen. Hämta från JSON-vyn på sidan Översikt för Grafana-instansen.
   grafanaLocation	Plats för den hanterade Grafana-instansen. Hämta från JSON-vyn på sidan Översikt för Grafana-instansen.
   grafanaSku	SKU för den hanterade Grafana-instansen. Hämta från JSON-vyn på sidan Översikt för Grafana-instansen. Använd sku.name.

3. Öppna mallfilen och uppdatera grafanaIntegrations egenskapen i slutet av filen med de värden som du hämtade från Grafana-instansen. Detta ser ut ungefär som i följande exempel. I de här exemplen full_resource_id_1 fanns och full_resource_id_2 redan i Azure Managed Grafana-resursen JSON. Den sista azureMonitorWorkspaceResourceId posten finns redan i mallen och används för att länka till resurs-ID:t för Azure Monitor-arbetsytan som anges i parameterfilen.

   Biceps

       resource grafanaResourceId_8 'Microsoft.Dashboard/grafana@2022-08-01' = {
           name: split(grafanaResourceId, '/')[8]
           sku: {
               name: grafanaSku
           }
           identity: {
               type: 'SystemAssigned'
           }
           location: grafanaLocation
           properties: {
               grafanaIntegrations: {
                   azureMonitorWorkspaceIntegrations: [
                       {
                           azureMonitorWorkspaceResourceId: 'full_resource_id_1'
                       }
                       {
                           azureMonitorWorkspaceResourceId: 'full_resource_id_2'
                       }
                       {
                           azureMonitorWorkspaceResourceId: azureMonitorWorkspaceResourceId
                       }
                   ]
               }
           }
       }
   

   JSON

   {
       "type": "Microsoft.Dashboard/grafana",
       "apiVersion": "2022-08-01",
       "name": "[split(parameters('grafanaResourceId'),'/')[8]]",
       "sku": {
           "name": "[parameters('grafanaSku')]"
       },
       "location": "[parameters('grafanaLocation')]",
       "properties": {
           "grafanaIntegrations": {
           "azureMonitorWorkspaceIntegrations": [
               {
                   "azureMonitorWorkspaceResourceId": "full_resource_id_1"
               },
               {
                   "azureMonitorWorkspaceResourceId": "full_resource_id_2"
               },
               {
                   "azureMonitorWorkspaceResourceId": "[parameters('azureMonitorWorkspaceResourceId')]"
               }
           ]
           }
       }
   }
   

4. Distribuera mallen med parameterfilen med valfri giltig metod för att distribuera Resource Manager-mallar. Exempel på olika metoder finns i Distribuera exempelmallarna.

Containerloggar

Förutsättningar

• Mallen måste distribueras i samma resursgrupp som klustret.

Ladda ned och installera mall

1. Ladda ned och redigera mall och parameterfil.

   Biceps

   • Mallfil (Syslog): https://aka.ms/enable-monitoring-msi-syslog-bicep-template
   • Parameterfil (Syslog): https://aka.ms/enable-monitoring-msi-syslog-bicep-parameters
   • Mallfil (ingen Syslog): https://aka.ms/enable-monitoring-msi-bicep-template
   • Parameterfil (ingen Syslog): https://aka.ms/enable-monitoring-msi-bicep-parameters

   ARM

   • Mallfil: https://aka.ms/aks-enable-monitoring-msi-onboarding-template-file
   • Parameterfil: https://aka.ms/aks-enable-monitoring-msi-onboarding-template-parameter-file

2. Redigera följande värden i parameterfilen. Samma uppsättning värden används för både ARM- och Bicep-mallarna. Hämta resurs-ID:t för resurserna från JSON-vyn för deras översiktssida .

   Parameter	Beskrivning
   aksResourceId	Resurs-ID för klustret.
   aksResourceLocation	Klustrets placering.
   workspaceResourceId	Resurs-ID för Log Analytics-arbetsytan.
   resourceTagValues	Taggvärden som angetts för den befintliga DCR-regeln (Container Insights Extension Data Collection Rule) för klustret och namnet på DCR. Namnet kommer att vara MSCI-<clusterName>-<clusterRegion> och den här resursen skapas i en resursgrupp för AKS-kluster. Vid första initieringen kan du ange godtyckliga taggvärden.
   enableRetinaNetworkFlowLogs	Flagga för att ange om du vill aktivera Retina-nätverksflödesloggar.
   enableContainerLogV2	Boolesk flagga för att aktivera ContainerLogV2-schema. Om värdet är true skickas stdout-/stderr-loggarna till tabellen ContainerLogV2 . Annars skickas containerloggarna till tabellen ContainerLog , om inget annat anges i ConfigMap. När du anger enskilda strömmar måste du inkludera motsvarande tabell för ContainerLog eller ContainerLogV2.
   enableSyslog	Anger om Syslog-samlingen ska vara aktiverad.
   syslogLevels	Om Syslog-samlingen är aktiverad anger du de loggnivåer som ska samlas in.
   dataCollectionInterval	Avgör hur ofta agenten samlar in data. Giltiga värden är 1–30 m i 1m intervall Standardvärdet är 1 m. Om värdet ligger utanför det tillåtna intervallet är det som standard 1 m.
   namespaceFilteringModeForDataCollection	Inkludera: Samlar endast in data från värdena i fältet namnområden . Exkludera: Samlar in data från alla namnområden förutom värdena i fältet namnområden . Av: Ignorerar val av namnområde och samlar in data på alla namnområden.
   namespacesForDataCollection	Matris med kommaavgränsade Kubernetes-namnområden för att samla in inventerings- och perf-data baserat på namnområdetFilteringMode. Till exempel samlar namnrymder = ["kube-system", "default"] med inställningen Inkludera endast dessa två namnområden. Med inställningen Exkludera samlar agenten in data från alla andra namnområden förutom kube-system och standard. Med en Av-inställning samlar agenten in data från alla namnområden, inklusive kube-system och standard. Ogiltiga och okända namnområden ignoreras.
   streams	En matris med tabellströmmar. Se Stream-värden för en lista över giltiga strömmar och deras motsvarande tabeller.
   useAzureMonitorPrivateLinkScope	Anger om du vill använda en privat länk för klusteranslutningen till Azure Monitor.
   azureMonitorPrivateLinkScopeResourceId	Vid användning av privat länk, resurs-ID för den privata länkomfattningen.

3. Distribuera mallen med parameterfilen med valfri giltig metod för att distribuera Resource Manager-mallar. Exempel på olika metoder finns i Distribuera exempelmallarna.

Förutsättningar

• Azure Monitor-arbetsytan och Azure Managed Grafana-arbetsytan måste redan ha skapats.
• Mallen måste distribueras i samma resursgrupp som Azure Managed Grafana-arbetsytan.
• Användare med rollen Administratör för användaråtkomst i aks-klustrets prenumeration kan aktivera rollen Övervakningsläsare direkt genom att distribuera mallen.
• Om Azure Managed Grafana-instansen finns i en annan prenumeration än Azure Monitor Workspaces-prenumerationen registrerar du Azure Monitor Workspace-prenumerationen Microsoft.Dashboard hos resursprovidern genom att följa den här dokumentationen.

Hämta nödvändiga värden för Grafana-resurs

Om Azure Managed Grafana-instansen redan är länkad till en Azure Monitor-arbetsyta måste du inkludera den här listan i mallen, annars skrivs den över. På sidan Översikt för Azure Managed Grafana-instansen i Azure Portal väljer du JSON-vyn och kopierar värdet azureMonitorWorkspaceIntegrations som ser ut ungefär som exemplet nedan. Om den inte finns har instansen inte länkats till någon Azure Monitor-arbetsyta.

"properties": {
    "grafanaIntegrations": {
        "azureMonitorWorkspaceIntegrations": [
            {
                "azureMonitorWorkspaceResourceId": "full_resource_id_1"
            },
            {
                "azureMonitorWorkspaceResourceId": "full_resource_id_2"
            }
        ]
    }
}

azure_monitor_workspace_integrations Uppdatera blocket i main.tf med listan över grafana-integreringar.

  azure_monitor_workspace_integrations {
    resource_id  = var.monitor_workspace_id[var.monitor_workspace_id1, var.monitor_workspace_id2]
  }

Ladda ned och redigera mallar

Nytt AKS-kluster

1. Ladda ned alla filer under AddonTerraformTemplate.
2. Redigera variablerna i variables.tf fil med rätt parametervärden.
3. Kör terraform init -upgrade för att initiera Terraform-distributionen.
4. Kör terraform plan -out main.tfplan för att initiera Terraform-distributionen.
5. Kör terraform apply main.tfplan för att tillämpa körningsplanen på din molninfrastruktur.

Obs! Skicka variablerna för nycklarna annotations_allowed och labels_allowed i main.tf endast när dessa värden finns. Det här är valfria block.

Containerloggar

Nytt AKS-kluster

1. Ladda ned Terraform-mallfilen beroende på om du vill aktivera Syslog-samlingen.

   • Syslog: https://aka.ms/enable-monitoring-msi-syslog-terraform
   • Ingen Syslog: https://aka.ms/enable-monitoring-msi-terraform

2. Justera resursen azurerm_kubernetes_cluster i main.tf baserat på dina klusterinställningar.

3. Uppdatera parametrar i variables.tf för att ersätta värden i "<>"

   Parameter	Beskrivning
   aks_resource_group_name	Använd värdena på sidan AKS-översikt för resursgruppen.
   resource_group_location	Använd värdena på sidan AKS-översikt för resursgruppen.
   cluster_name	Definiera det klusternamn som du vill skapa.
   workspace_resource_id	Använd resurs-ID:t för din Log Analytics-arbetsyta.
   workspace_region	Använd platsen för din Log Analytics-arbetsyta.
   resource_tag_values	Matcha de befintliga taggvärden som angetts för den befintliga DCR-regeln (Container Insights Extension Data Collection Rule) för klustret och namnet på DCR. Namnet matchar MSCI-<clusterName>-<clusterRegion> och den här resursen skapas i samma resursgrupp som AKS-klustren. Vid första onboarding kan du ange valfria taggvärden.
   enabledContainerLogV2	Ange det här parametervärdet till true för att använda den standardrekommenderade ContainerLogV2.
   Parametrar för kostnadsoptimering	Se parametrar för datainsamling
   streams	Strömningar för datainsamling. Se Stream-värden.
   use_azure_monitor_private_link_scope	Flagga för att ange om Azure Monitor Private Link-omfång ska konfigureras.
   azure_monitor_private_link_scope_resource_id	Azure-resurs-ID för Azure Monitor Private Link-omfånget.

4. Kör terraform init -upgrade för att initiera Terraform-distributionen.

5. Kör terraform plan -out main.tfplan för att initiera Terraform-distributionen.

6. Kör terraform apply main.tfplan för att tillämpa körningsplanen på din molninfrastruktur.

Befintligt AKS-kluster

1. Importera den befintliga klusterresursen först med kommandot : terraform import azurerm_kubernetes_cluster.k8s <aksResourceId>
2. Lägg till oms_agent-tilläggsprofilen i den befintliga azurerm_kubernetes_cluster resursen.

   oms_agent {
       log_analytics_workspace_id = var.workspace_resource_id
       msi_auth_for_monitoring_enabled = true
     }
   

3. Kopiera DCR- och DCRA-resurserna från Terraform-mallarna
4. Kör terraform plan -out main.tfplan och se till att ändringen lägger till egenskapen oms_agent. Obs! Om den definierade resursen azurerm_kubernetes_cluster är annorlunda under terraform-planen förstörs och återskapas det befintliga klustret.
5. Kör terraform apply main.tfplan för att tillämpa körningsplanen på din molninfrastruktur.

Du kan aktivera Prometheus-mått och containerloggar när du skapar ett nytt AKS-kluster eller i ett befintligt kluster i Azure-portalen. I båda fallen är konfigurationsupplevelsen densamma.

Nytt AKS-kluster

När du skapar ett nytt AKS-kluster i Azure-portalen konfigurerar du övervakning på fliken Övervakning .

Befintligt kluster

Gå till klustret i Azure Portal. I tjänstmenyn väljer du Övervaka och sedan Övervaka inställningar.

Konfigurationsalternativ

Konfigurationsalternativen är desamma för både nya och befintliga kluster. Den enda skillnaden är att du kan behöva välja Avancerade inställningar för att visa alla alternativ för ett befintligt kluster.

3. Prometheus-mått, Grafana- och containerloggar och händelser har valts åt dig. Om du har en befintlig Azure Monitor-arbetsyta, Grafana-arbetsyta och Log Analytics-arbetsyta väljs de åt dig.
4. Välj Avancerade inställningar om du vill välja alternativa arbetsytor eller skapa nya. Med inställningen Loggningsprofiler och klassiska profiler kan du ändra standardinformationen för samlingen för att minska dina övervakningskostnader. Mer information finns i Aktivera inställningar för kostnadsoptimering i Containerinsikter .
5. Välj Konfigurera.

För containerloggar måste du välja en loggningsprofil som definierar vilka loggar som ska samlas in och med vilken frekvens. De tillgängliga profilerna visas i följande tabell.

Om du vill anpassa inställningarna klickar du på Redigera samlingsinställningar. Var och en av dessa inställningar beskrivs i följande tabell.

Med alternativet Insamlade data kan du välja de tabeller som är ifyllda för klustret. Tabellerna grupperas efter de vanligaste scenarierna.

Prometheus mätvärden

1. Ladda ned Azure Policy-mall- och parameterfiler.

   • Mallfil: https://aka.ms/AddonPolicyMetricsProfile
   • Parameterfil: https://aka.ms/AddonPolicyMetricsProfile.parameters

2. Skapa principdefinitionen med följande CLI-kommando:

   az policy definition create --name "Prometheus Metrics addon" --display-name "Prometheus Metrics addon" --mode Indexed --metadata version=1.0.0 category=Kubernetes --rules AddonPolicyMetricsProfile.rules.json --params AddonPolicyMetricsProfile.parameters.json

3. När du har skapat principdefinitionen går du till Azure Portal och väljer Princip och sedan Definitioner. Välj den principdefinition som du skapade.

4. Välj Tilldela och fyll i informationen på fliken Parametrar . Välj Granska + skapa.

5. Om du vill tillämpa principen på ett befintligt kluster skapar du en åtgärdsuppgift för klusterresursen från Principtilldelning.

När principen har tilldelats till prenumerationen, när du skapar ett nytt kluster utan Prometheus aktiverat, körs och distribueras principen för att aktivera Prometheus-övervakning.

Azure Portal

1. På fliken Definitioner på menyn Princip i Azure Portal skapar du en principdefinition med följande information.

   • Definitionsplats: Azure-prenumeration där principdefinitionen ska lagras.
   • Namn: AKS-Monitoring-Addon
   • Beskrivning: Anpassad Azure-princip för att aktivera övervakningstillägget i Azure Kubernetes-kluster.
   • Kategori: Välj Använd befintlig och sedan Kubernetes i listrutan.
   • Principregel: Ersätt det befintliga JSON-exemplet med innehållet i https://aka.ms/aks-enable-monitoring-custom-policy.

2. Välj den nya policydefinitionen AKS Monitoring Addon.

3. Välj Tilldela och ange ett omfång för var principen ska tilldelas.

4. Välj Nästa och ange resurs-ID för Log Analytics-arbetsytan.

5. Skapa en reparationsaktivitet om du vill tillämpa principen på befintliga AKS-kluster i det valda omfånget.

6. Välj Granska + skapa för att skapa policytilldelningen.

Azure CLI (kommandoradsgränssnittet för Azure)

1. Ladda ned Azure Policy-mall- och parameterfiler.

   • Mallfil: https://aka.ms/enable-monitoring-msi-azure-policy-template
   • Parameterfil: https://aka.ms/enable-monitoring-msi-azure-policy-parameters

2. Skapa principdefinitionen med följande CLI-kommando:

   az policy definition create --name "AKS-Monitoring-Addon-MSI" --display-name "AKS-Monitoring-Addon-MSI" --mode Indexed --metadata version=1.0.0 category=Kubernetes --rules azure-policy.rules.json --params azure-policy.parameters.json
   

3. Skapa principdefinitionen med följande CLI-kommando:

   az policy assignment create --name aks-monitoring-addon --policy "AKS-Monitoring-Addon-MSI" --assign-identity --identity-scope /subscriptions/<subscriptionId> --role Contributor --scope /subscriptions/<subscriptionId> --location <location> -p "{ \"workspaceResourceId\": { \"value\": \"/subscriptions/<subscriptionId>/resourcegroups/<resourceGroupName>/providers/microsoft.operationalinsights/workspaces/<workspaceName>\" }, \"resourceTagValues\": { \"value\": {} }, \"workspaceRegion\": { \"value\": \"<location>\" }}"
   

När principen har tilldelats till prenumerationen, när du skapar ett nytt kluster utan containerinsikter aktiverade, körs och distribueras principen för att aktivera övervakning av containerinsikter.

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.

I följande exempel skapas en diagnostikinställning som skickar alla Kubernetes-kategorier till en Log Analytics-arbetsyta. Detta inkluderar resursspecifikt läge för att skicka loggarna till specifika tabeller som anges i Resursloggar som stöds för Microsoft.ContainerService/fleets.

az monitor diagnostic-settings create \
--name 'Collect control plane logs' \
--resource  /subscriptions/<subscription ID>/resourceGroups/<resource group name>/providers/Microsoft.ContainerService/managedClusters/<cluster-name> \
--workspace /subscriptions/<subscription ID>/resourcegroups/<resource group name>/providers/microsoft.operationalinsights/workspaces/<log analytics workspace name> \
--logs '[{"category": "karpenter-events","enabled": true},{"category": "kube-audit","enabled": true},
{"category": "kube-apiserver","enabled": true},{"category": "kube-audit-admin","enabled": true},{"category": "kube-controller-manager","enabled": true},{"category": "kube-scheduler","enabled": true},{"category": "cluster-autoscaler","enabled": true},{"category": "cloud-controller-manager","enabled": true},{"category": "guard","enabled": true},{"category": "csi-azuredisk-controller","enabled": true},{"category": "csi-azurefile-controller","enabled": true},{"category": "csi-snapshot-controller","enabled": true},{"category": "fleet-member-agent","enabled": true},{"category": "fleet-member-net-controller-manager","enabled": true},{"category": "fleet-mcs-controller-manager","enabled": true}]'
--metrics '[{"category": "AllMetrics","enabled": true}]' \
--export-to-resource-specific true

Här följer exempelmalls- och parameterfiler för att skapa en diagnostikinställning för kontrollplansloggar. Ändra mallarna för att samla in olika kategorier eller för att skicka loggarna till ett annat mål.

Biceps

param clusterName string
param workspaceId string
param settingName string

resource cluster 'Microsoft.ContainerService/managedClusters@2021-05-01-preview' existing = {
  name: clusterName
}

resource setting 'Microsoft.Insights/diagnosticSettings@2021-05-01-preview' = {
  name: settingName
  scope: cluster
  properties: {
    workspaceId: workspaceId
    logs: [
      {
        category: 'kube-apiserver'
        enabled: true
      }
      {
        category: 'kube-audit'
        enabled: true
      }
      {
        category: 'kube-audit-admin'
        enabled: true
      }
      {
        category: 'kube-controller-manager'
        enabled: true
      }
      {
        category: 'kube-scheduler'
              }
      {
        category: 'cluster-autoscaler'
        enabled: true
      }
      {
        category: 'guard'
        enabled: true
      }
    ]
  }
}

JSON

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "clusterName": {
            "type": "String"
        },
        "workspaceId": {
            "type": "String"
        },
        "settingName": {
            "type": "String"
        }
    },
    "resources": [
        {
            "type": "Microsoft.Insights/diagnosticSettings",
            "apiVersion": "2021-05-01-preview",
            "scope": "[format('Microsoft.ContainerService/managedClusters/{0}', parameters('clusterName'))]",
            "name": "[parameters('settingName')]",
            "properties": {
                "workspaceId": "[parameters('workspaceId')]",
                "logs": [
                    {
                        "category": "kube-apiserver",
                        "enabled": true
                    },
                    {
                        "category": "kube-audit",
                        "enabled": true
                    },
                    {
                        "category": "kube-audit-admin",
                        "enabled": true
                    },
                    {
                        "category": "kube-controller-manager",
                        "enabled": true
                    },
                    {
                        "category": "kube-scheduler",
                        "enabled": false
                    },
                    {
                        "category": "cluster-autoscaler",
                        "enabled": true
                    },
                    {
                        "category": "guard",
                        "enabled": true
                    }
                ]
            }
        }
    ]
}

Parameterfil

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

Använd följande mall för att skapa en diagnostikinställning för kontrollplansloggar. Ändra mallen för att samla in olika kategorier eller skicka loggarna till ett annat mål.

  features {}
}

variable "setting_name" {
  type        = string
  description = "Name for the diagnostic setting."
}

variable "workspace_id" {
  type        = string
  description = "Resource ID of the Log Analytics workspace."
}

variable "cluster_id" {
  type        = string
  description = "Resource ID of the AKS cluster to attach diagnostics to."
}

resource "azurerm_monitor_diagnostic_setting" "aks" {
  name                       = var.setting_name
  target_resource_id         = var.cluster_id
  log_analytics_workspace_id = var.workspace_id

  log {
    category = "kube-apiserver"
    enabled  = true
  }

  log {
    category = "kube-audit"
    enabled  = true
  }

  log {
    category = "kube-audit-admin"
    enabled  = true
  }

  log {
    category = "kube-controller-manager"
    enabled  = true
  }

  log {
    category = "kube-scheduler"
    enabled  = false
  }

  log {
    category = "cluster-autoscaler"
    enabled  = true
  }

  log {
    category = "guard"
    enabled  = true
  }
}

Välj Diagnostikinställningar i avsnittet Övervakning på menyn för klustret. Välj sedan + Lägg till diagnostikinställning.

Välj Skicka till Log Analytics-arbetsyta och välj samma arbetsyta där du skickar containerloggarna. Välj sedan de olika kategorier som du vill samla in. Ge diagnostikinställningsnamnet ett beskrivande namn, till exempel Samla in kontrollplansloggar.

Verifiera driftsättningen

Inom några minuter efter aktivering av övervakning bör du kunna använda följande metoder för att kontrollera att övervakningsfunktionerna är aktiverade.

• Klustret bör flyttas från vyn Oövervakade kluster till vyn Övervakade kluster i containerinsikter för flera kluster.
• Övervakningsvyn för klustret bör börja fyllas i med data och inte längre ge ett alternativ för att aktivera övervakning. Detta inkluderar flikarna Noder, arbetsbelastningar och containrar .

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 inbyggda Azure-principer .