Visualizzare i log degli agenti in Azure Kubernetes Fleet Manager

Questo articolo spiega come visualizzare i log dell'agente Flotta dai cluster hub e membro in Gestione flotta Kubernetes di Azure. Se si dispone di una flotta con la modalità cluster hub abilitata, Azure Kubernetes Fleet Manager installa gli agenti Fleet sia nel cluster hub che nei cluster membro per facilitare le comunicazioni e orchestrare le operazioni nella flotta, a supporto dell'orchestrazione e del bilanciamento del carico di lavoro della Flotta. Questi agenti generano log che forniscono informazioni dettagliate su:

• Stato di integrità e connettività dell'agente
• Modifiche alla configurazione dell'orchestrazione del carico di lavoro e aggiornamenti delle operazioni
• Modifiche alla configurazione del bilanciamento del carico e aggiornamenti delle operazioni

È anche possibile recuperare questi log a scopo di monitoraggio, risoluzione dei problemi e/o controllo.

Configurare le impostazioni di diagnostica per le risorse pertinenti

I log dell'agente Fleet vengono implementati come log delle risorse in Monitoraggio di Azure, in particolare:

• I log dell'agente Flotta per il cluster hub di Flotta vengono implementati come parte dei log delle risorse per la risorsa di Flotta.
  • Sono installati due agenti nel cluster hub Fleet, noti anche come agenti hub Fleet, che includono:
    • fleet-hub-agent: l'agente Fleet che gestisce le appartenenze ai cluster e elabora le attività di orchestrazione del carico di lavoro sul lato cluster hub (ad esempio, pianificazione, implementazione delle modifiche).
    • fleet-hub-net-controller-manager: agente Flotta che elabora le attività di bilanciamento del carico sul lato del cluster hub.
• I log dell'agente Flotta per un cluster membro di Flotta sono implementati come parte dei log delle risorse per la risorsa del cluster del servizio Azure Kubernetes.
  • Vengono installati tre agenti in un cluster membro di Flotta, comunemente denominati agenti membro di Flotta, che includono:
    • fleet-member-agent: l'agente Flotta che registra il cluster membro nel cluster hub ed elabora le attività di orchestrazione del carico di lavoro sul lato del cluster membro (ad esempio applicazione di manifesti, rilevamento della deriva, acquisizione).
    • fleet-member-net-controller-manager: agente Flotta che elabora le attività di bilanciamento del carico sul lato del cluster membro.
    • fleet-mcs-controller-manager: l'agente Flotta che facilita i servizi multi-cluster.

I log delle risorse non vengono raccolti e archiviati fino a quando non si crea un'impostazione di diagnostica per indirizzarli a una o più posizioni. Monitoraggio di Azure supporta diverse posizioni che è possibile usare, ad esempio un account di archiviazione di Azure o un'area di lavoro Log Analytics; per un elenco delle località disponibili e delle relative limitazioni, vedere la pagina Destinazioni delle impostazioni di diagnostica di Monitoraggio di Azure .

Per raccogliere i log dell'agente Flotta, configurare un'impostazione diagnostica per la risorsa corrispondente. A seconda del caso d'uso della flotta, è possibile scegliere di raccogliere i log solo da uno o più agenti fleet specifici. L'approccio più semplice consiste nell'usare il portale di Azure; per altre istruzioni, vedere i passaggi. È anche possibile usare l'interfaccia della riga di comando di Azure, PowerShell, Azure Resource Manager, l'API REST o Criteri di Azure per configurare gli elementi; Per altre informazioni, vedere Creare un'impostazione di diagnostica.

Configurare le impostazioni di diagnostica sulla risorsa Fleet per i log dell'agente dell'hub Fleet

1. Accedi al portale di Azure.
2. Nella casella di ricerca immettere Kubernetes Fleet Manager e selezionare Kubernetes Fleet Manager nei risultati della ricerca.
3. Nell'elenco di tutte le risorse di Flotta, individuare la flotta da cui raccogliere i log dell'agente dell'hub di Flotta. Fare clic sul nome della flotta. Potrebbe essere necessario modificare le condizioni di filtro per individuare la risorsa Fleet desiderata.
4. Selezionare Impostazioni di diagnostica in Monitoraggio nel menu della risorsa.
5. Selezionare Aggiungi impostazione di diagnostica.
6. Immettere un nome per le impostazioni di diagnostica.
7. Per le categorie di log, assicurarsi che almeno una delle due categorie fleet-hub-agent e fleet-hub-net-controller-manager, sia selezionata. È anche possibile selezionare altre categorie di log in base alle esigenze.
8. Per i dettagli di destinazione, selezionare la destinazione preferita. Vengono visualizzate altre opzioni che richiedono informazioni aggiuntive sulla destinazione. Per altre informazioni, vedere Creare un'impostazione di diagnostica.
9. Seleziona Salva.

Dopo alcuni istanti, la nuova impostazione viene visualizzata nell'elenco delle impostazioni di diagnostica per questa risorsa. I log vengono trasmessi alle destinazioni specificate quando vengono generati nuovi dati. Potrebbe esserci un intervallo di tempo tra quando l'agente genera un log e quando esso viene visualizzato nella destinazione desiderata.

Configurare le impostazioni di diagnostica nella risorsa del cluster membro del servizio Azure Kubernetes per i log dell'agente membro di Flotta

1. Accedi al portale di Azure.
2. Nella casella di ricerca immettere Servizi Kubernetes e selezionare Servizi Kubernetes nei risultati della ricerca.
3. Nell'elenco di tutte le risorse del cluster AKS, individuare il cluster AKS che hai aggiunto alla tua Fleet come cluster membro e da cui desideri raccogliere i log dell'agente membro di Fleet. Fare clic sul nome del cluster AKS. Potrebbe essere necessario modificare le condizioni di filtro per individuare la risorsa cluster del servizio Azure Kubernetes desiderata.
4. Selezionare Impostazioni di diagnostica in Monitoraggio nel menu della risorsa.
5. Selezionare Aggiungi impostazione di diagnostica.
6. Immettere un nome per le impostazioni di diagnostica.
7. Per le categorie di log, assicurarsi che sia selezionata almeno una delle tre categorie, fleet-member-agent, fleet-member-net-controller-managere fleet-mcs-controller-manager. È anche possibile selezionare altre categorie di log in base alle esigenze.
8. Per i dettagli di destinazione, selezionare la destinazione preferita. Vengono visualizzate altre opzioni che richiedono altre informazioni di destinazione. Per altre informazioni, vedere Creare un'impostazione di diagnostica. Se intendi usare un'area di lavoro Log Analytics come destinazione, una risorsa del cluster AKS supporta sia la modalità Diagnostica di Azure sia la modalità specifica per la risorsa. Per le differenze tra le due modalità, vedere la spiegazione nella pagina Invia all'area di lavoro Log Analytics .
9. Seleziona Salva.

Dopo alcuni istanti, la nuova impostazione viene visualizzata nell'elenco delle impostazioni di diagnostica per questa risorsa. I log vengono trasmessi alle destinazioni specificate quando vengono generati nuovi dati. Potrebbe essere necessario un po' di tempo tra quando l'agente genera un log e quando viene visualizzato nella destinazione desiderata.

Visualizza i log dell'agente della flotta

Per visualizzare i log dell'agente Fleet nella destinazione preferita, vedere Inviare i log delle risorse di Azure alle aree di lavoro Log Analytics, a Hub eventi o ad Archiviazione di Azure.

Introduzione ai log dell'agente Flotta

I log dell'agente Flotta vengono scritti nel formato non strutturato klog; il formato è

[IWEF]yyyymmdd hh:mm:ss.uuuuuu threadid file:line msg kvs

Dove:

• [IWEF] corrisponde al livello log.
  • I rappresenta il info livello.
  • W rappresenta il warning livello.
  • E rappresenta il error livello.
  • F rappresenta il fatal livello.
• yyyymmdd è l'anno (yyyy), il mese (mm) e il giorno (dd) quando viene generato il log.
• hh:mm:ss.uuuuuu è il marcatempo (hh per le ore, mm per i minuti, ss per i secondi e uuuuuu per i microsecondi) quando viene emesso il log.
• threadid è l'ID thread (PID/TID) del processo/thread dell'agente Flotta.
• file:line è il nome del file e il numero di riga del codice sorgente che genera i log.
• msg è il messaggio di log.
• kvs è un elenco di coppie chiave-valore (ad esempio, work=123) che fornisce informazioni aggiuntive, come l'oggetto API che il messaggio di log include.

È possibile fare riferimento incrociato a un messaggio di log con il codice sorgente dell'agente Fleet per comprendere meglio il messaggio di log nel contesto. Per gli agenti Flotta fleet-hub-agent e fleet-member-agent, vedere Repository GitHub KubeFleet; per fleet-hub-net-controller-manager, fleet-member-net-controller-manager e fleet-mcs-controller-manager, vedere Repository GitHub della rete di Flotta di Azure.

Query Kusto utili

Ecco un elenco di query Kusto che potrebbero semplificare la ricerca nei log dell'agente Flotta in un'area di lavoro Log Analytics:

• Recupera le 1.000 voci di log più recenti da tutti gli agenti dell'hub di Flotta.

// Replace YOUR-RESOURCE-ID with the value of your Fleet resource.
// To view the ID, go to the Fleet resource page, and select JSON view on the overview page.
AzureDiagnostics
| where _ResourceId == YOUR-RESOURCE-ID
| where Category in ("fleet-hub-agent", "fleet-hub-net-controller-manager")
| order by TimeGenerated desc
| take 1000

• Recupera le 1.000 voci di log più recenti da tutti gli agenti membri di Flotta.

// Replace YOUR-RESOURCE-ID with the value of your AKS member cluster resource.
// To view the ID, go to the AKS cluster resource page, and select JSON view on the overview page.
AzureDiagnostics
| where _ResourceId == YOUR-RESOURCE-ID
| where Category in ("fleet-member-agent", "fleet-member-net-controller-manager", "fleet-mcs-controller-manager")
| order by TimeGenerated desc
| take 1000

• Recupera le 1.000 voci di log più recenti su come Flotta gestisce le appartenenze ai cluster sul lato del cluster hub.

// Replace YOUR-RESOURCE-ID with the value of your Fleet resource.
// To view the ID, go to the Fleet resource page, and select JSON view on the overview page.
AzureDiagnostics
| where _ResourceId == YOUR-RESOURCE-ID
| where Category == "fleet-hub-agent"
| where log_s contains "v1beta1/member_controller.go"
| order by TimeGenerated desc
| take 1000

• Recuperare le 1.000 voci di log più recenti sul modo in cui Fleet elabora gli ClusterResourcePlacement oggetti API.

// Replace YOUR-RESOURCE-ID with the value of your Fleet resource.
// To view the ID, go to the Fleet resource page, and select JSON view on the overview page.
AzureDiagnostics
| where _ResourceId == YOUR-RESOURCE-ID
| where Category == "fleet-hub-agent"
| where log_s contains "clusterresourceplacement/"
| order by TimeGenerated desc
| take 1000

• Recuperare le ultime 1.000 voci di log su come Fleet pianifica i carichi di lavoro.

// Replace YOUR-RESOURCE-ID with the value of your Fleet resource.
// To view the ID, go to the Fleet resource page, and select JSON view on the overview page.
AzureDiagnostics
| where _ResourceId == YOUR-RESOURCE-ID
| where Category == "fleet-hub-agent"
| where log_s contains "scheduler/" or log_s contains "framework/"
| order by TimeGenerated desc
| take 1000

• Recuperare le ultime 1.000 voci di log su come Fleet elabora gli aggiornamenti in sequenza.

// Replace YOUR-RESOURCE-ID with the value of your Fleet resource.
// To view the ID, go to the Fleet resource page, and select JSON view on the overview page.
AzureDiagnostics
| where _ResourceId == YOUR-RESOURCE-ID
| where Category == "fleet-hub-agent"
| where log_s contains "rollout/"
| order by TimeGenerated desc
| take 1000

• Recupera le 1.000 voci di log più recenti su come Flotta elabora gli aggiornamenti preparati.

// Replace YOUR-RESOURCE-ID with the value of your Fleet resource.
// To view the ID, go to the Fleet resource page, and select JSON view on the overview page.
AzureDiagnostics
| where _ResourceId == YOUR-RESOURCE-ID
| where Category == "fleet-hub-agent"
| where log_s contains "updaterun/"
| order by TimeGenerated desc
| take 1000

• Recuperare le 1.000 voci di log più recenti su come Fleet sincronizza i carichi di lavoro con i cluster membri.

// Replace YOUR-RESOURCE-ID with the value of your Fleet resource.
// To view the ID, go to the Fleet resource page, and select JSON view on the overview page.
AzureDiagnostics
| where _ResourceId == YOUR-RESOURCE-ID
| where Category == "fleet-hub-agent"
| where log_s contains "workgenerator/"
| order by TimeGenerated desc
| take 1000

• Recupera le 1.000 voci di log più recenti su come Flotta segnala le appartenenze ai cluster sul lato del cluster membro.

// Replace YOUR-RESOURCE-ID with the value of your AKS member cluster resource.
// To view the ID, go to the AKS cluster resource page, and select JSON view on the overview page.
AzureDiagnostics
| where _ResourceId == YOUR-RESOURCE-ID
| where Category == "fleet-member-agent"
| where log_s contains "v1beta1/member_controller.go"
| order by TimeGenerated desc
| take 1000

• Recupera le 1.000 voci di log più recenti su come Flotta applica i manifesti a un cluster membro specifico.

// Replace YOUR-RESOURCE-ID with the value of your AKS member cluster resource.
// To view the ID, go to the AKS cluster resource page, and select JSON view on the overview page.
AzureDiagnostics
| where _ResourceId == YOUR-RESOURCE-ID
| where Category == "fleet-member-agent"
| where log_s contains "workapplier/"
| order by TimeGenerated desc
| take 1000

• Recuperare le 1.000 voci di log più recenti su come Fleet gestisce le esportazioni/importazioni degli endpoint per le funzionalità di rete sul lato cluster hub.

// Replace YOUR-RESOURCE-ID with the value of your Fleet resource.
// To view the ID, go to the Fleet resource page, and select JSON view on the overview page.
AzureDiagnostics
| where _ResourceId == YOUR-RESOURCE-ID
| where Category == "fleet-hub-net-controller-manager"
| where log_s contains "endpointsliceexport/"
| order by TimeGenerated desc
| take 1000

• Recupera le 1.000 voci di log più recenti su come Flotta gestisce le esportazioni/importazioni del servizio per le funzionalità di rete sul lato del cluster hub.

// Replace YOUR-RESOURCE-ID with the value of your Fleet resource.
// To view the ID, go to the Fleet resource page, and select JSON view on the overview page.
AzureDiagnostics
| where _ResourceId == YOUR-RESOURCE-ID
| where Category == "fleet-hub-net-controller-manager"
| where log_s contains "serviceimport/" or log_s contains "internalserviceimport/" or log_s contains "internalserviceexport/"
| order by TimeGenerated desc
| take 1000

• Recuperare le ultime 1.000 voci di log su come Fleet gestisce le risorse relative ad Azure Traffic Manager per le funzionalità di rete.

// Replace YOUR-RESOURCE-ID with the value of your Fleet resource.
// To view the ID, go to the Fleet resource page, and select JSON view on the overview page.
AzureDiagnostics
| where _ResourceId == YOUR-RESOURCE-ID
| where Category == "fleet-hub-net-controller-manager"
| where log_s contains "trafficmanagerbackend/" or log_s contains "trafficmanagerprofile/"
| order by TimeGenerated desc
| take 1000

• Recupera le 1.000 voci di log più recenti su come Flotta gestisce le esportazioni/importazioni dell'endpoint per le funzionalità di rete sul lato del cluster membro.

// Replace YOUR-RESOURCE-ID with the value of your AKS member cluster resource.
// To view the ID, go to the AKS cluster resource page, and select JSON view on the overview page.
AzureDiagnostics
| where _ResourceId == YOUR-RESOURCE-ID
| where Category == "fleet-member-net-controller-manager"
| where log_s contains "endpointslice/" or log_s contains "endpointsliceexport/" or log_s contains "endpointsliceimport/"
| order by TimeGenerated desc
| take 1000

• Recupera le 1.000 voci di log più recenti su come Flotta gestisce le esportazioni/importazioni del servizio per le funzionalità di rete sul lato del cluster membro.

// Replace YOUR-RESOURCE-ID with the value of your AKS member cluster resource.
// To view the ID, go to the AKS cluster resource page, and select JSON view on the overview page.
AzureDiagnostics
| where _ResourceId == YOUR-RESOURCE-ID
| where Category == "fleet-member-net-controller-manager"
| where log_s contains "serviceexport/" or log_s contains "serviceimport/"
| order by TimeGenerated desc
| take 1000

• Recuperare le ultime 1.000 voci di log su come Fleet gestisce i servizi multi-cluster per le funzionalità di rete.

// Replace YOUR-RESOURCE-ID with the value of your AKS member cluster resource.
// To view the ID, go to the AKS cluster resource page, and select JSON view on the overview page.
AzureDiagnostics
| where _ResourceId == YOUR-RESOURCE-ID
| where Category == "fleet-mcs-controller-manager"
| where log_s contains "multiclusterservice/"
| order by TimeGenerated desc
| take 1000