Autenticazione legacy per Informazioni dettagliate contenitore

Per impostazione predefinita, Informazioni dettagliate contenitore prevede l'autenticazione tramite identità gestita, con un agente di monitoraggio che usa l'identità gestita del cluster per inviare dati a Monitoraggio di Azure. Ha sostituito l'autenticazione locale basata su certificati legacy ed è stato rimosso il requisito di aggiungere un ruolo Autore metriche di monitoraggio al cluster.

Questo articolo descrive come eseguire la migrazione all'autenticazione tramite identità gestita se è stata abilitata la funzionalità Informazioni dettagliate contenitore con il metodo di autenticazione legacy e anche come abilitare l'autenticazione legacy se è presente tale requisito.

Importante

Se si ha un cluster con autenticazione legacy e le chiavi dell'area di lavoro Log Analytics vengono ruotate, i dati di monitoraggio non verranno più inviati all'area di lavoro Log Analytics. È necessario disabilitare e quindi riabilitare il componente aggiuntivo Informazioni dettagliate contenitore per avviare nuovamente il flusso di dati di monitoraggio con le nuove chiavi ruotate dell'area di lavoro.  È consigliabile eseguire la migrazione all'autenticazione tramite identità gestita di Informazioni dettagliate contenitore, che non usa le chiavi dell'area di lavoro Log Analytics.

Eseguire la migrazione all'autenticazione tramite identità gestita

Se la funzionalità Informazioni dettagliate contenitore è stata abilitata prima che fosse disponibile l'autenticazione tramite identità gestita, è possibile usare i metodi seguenti per eseguire la migrazione dei cluster.

Azure portal

È possibile eseguire la migrazione all'autenticazione tramite identità gestita nel pannello Impostazioni di monitoraggio per il cluster del servizio Azure Kubernetes. Nella sezione Monitoraggio fare clic sulla scheda Informazioni dettagliate. Nella scheda Informazioni dettagliate fare clic sull'opzione Impostazioni di monitoraggio e selezionare la casella Usa identità gestita

Se l'opzione Usa identità gestita non viene visualizzata, significa che è in uso un cluster SPN. In tal caso, è necessario usare gli strumenti da riga di comando per eseguire la migrazione. Vedere altre schede per istruzioni e modelli di migrazione.

Interfaccia della riga di comando di Azure

Servizio Azure Kubernetes

Per i cluster del servizio Azure Kubernetes, è necessario prima di tutto disabilitare il monitoraggio e poi eseguire l'aggiornamento all'identità gestita. Per questa migrazione sono attualmente supportati solo il cloud pubblico di Azure, Microsoft Azure gestito dal cloud 21Vianet e il cloud di Azure per enti pubblici. Per i cluster con identità assegnata dall'utente, è supportato solo il cloud pubblico di Azure.

Nota

Interfaccia della riga di comando di Azure versione 2.49.0 o successiva.

1. Ottenere l'ID risorsa area di lavoro Log Analytics:

   az aks show -g <resource-group-name> -n <cluster-name> | grep -i "logAnalyticsWorkspaceResourceID"
   

2. Disabilitare il monitoraggio con il comando seguente:

   az aks disable-addons -a monitoring -g <resource-group-name> -n <cluster-name> 
   

3. Se il cluster usa un'entità servizio, aggiornarlo all'identità gestita dal sistema con il comando seguente:

   az aks update -g <resource-group-name> -n <cluster-name> --enable-managed-identity
   

4. Abilitare il componente aggiuntivo di monitoraggio con l'opzione di autenticazione tramite identità gestita usando l'ID risorsa area di lavoro Log Analytics ottenuto nel passaggio 1:

   az aks enable-addons -a monitoring -g <resource-group-name> -n <cluster-name> --workspace-resource-id <workspace-resource-id>
   

Kubernetes con abilitazione di Arc

Nota

L'autenticazione tramite identità gestita non è supportata per i cluster Kubernetes abilitati per Arc con ARO.

1. Recuperare l'area di lavoro Log Analytics configurata per l'estensione Informazioni dettagliate contenitore.

   az k8s-extension show --name azuremonitor-containers --cluster-name \<cluster-name\> --resource-group \<resource-group\> --cluster-type connectedClusters -n azuremonitor-containers 
   

2. Abilitare l'estensione Informazioni dettagliate contenitore con l'opzione di autenticazione tramite identità gestita usando l'area di lavoro restituita nel primo passaggio.

   az k8s-extension create --name azuremonitor-containers --cluster-name \<cluster-name\> --resource-group \<resource-group\> --cluster-type connectedClusters --extension-type Microsoft.AzureMonitor.Containers --configuration-settings amalogs.useAADAuth=true logAnalyticsWorkspaceResourceID=\<workspace-resource-id\> 
   

Abilitare l'autenticazione legacy

Se è necessaria l'autenticazione legacy, vedere Abilitare Informazioni dettagliate contenitore, che offre esempi di opzioni diverse per abilitare Informazioni dettagliate contenitore.

Passaggi successivi

Se si verificano problemi durante l'aggiornamento dell'agente, consultare la guida risoluzione dei problemi per assistenza.