Caricare metriche in Monitoraggio di Azure

  • Articolo

Periodicamente, è possibile esportare le metriche di monitoraggio e caricarle in Azure. L'esportazione e il caricamento dei dati creano e aggiornano anche il controller dei dati, l'istanza gestita di SQL e le risorse del server PostgreSQL in Azure.

Con i servizi dati di Azure Arc è possibile caricare facoltativamente le metriche in Monitoraggio di Azure in modo da poter aggregare e analizzare le metriche, generare avvisi, inviare notifiche o attivare azioni automatizzate.

L'invio dei dati a Monitoraggio di Azure consente anche di archiviare i dati delle metriche fuori sede e su larga scala, consentendo l'archiviazione a lungo termine dei dati per l'analisi avanzata.

Se si dispone di più siti con servizi dati di Azure Arc, è possibile usare Monitoraggio di Azure come posizione centrale per raccogliere tutti i log e le metriche nei siti.

Caricare le metriche per il controller dei dati di Azure Arc in modalità diretta

Nella modalità di connessione diretta, il caricamento delle metriche può essere configurato solo in modalità automatica. Questo caricamento automatico delle metriche può essere configurato durante la distribuzione del controller dei dati di Azure Arc o dopo la distribuzione. L'identità gestita dall'estensione dei servizi dati di Azure Arc viene usata per il caricamento delle metriche. All'identità gestita deve essere assegnato il ruolo Autore delle metriche di monitoraggio.

Nota

Se il caricamento automatico delle metriche è stato disabilitato durante la distribuzione del controller dei dati di Azure Arc, è prima necessario recuperare l'identità gestita dell'estensione del controller dei dati di Azure Arc e concedere il ruolo Autore delle metriche di monitoraggio prima di abilitare il caricamento automatico. Seguire questa procedura per recuperare l'identità gestita e concedere i ruoli necessari.

Gli esempi in questo articolo usano parentesi angolari < ... > per identificare i valori che è necessario sostituire prima di eseguire lo script. Sostituire le parentesi quadre e i valori all'interno delle parentesi quadre.

(1) Recuperare l'identità gestita dell'estensione del controller dei dati di Azure Arc

$Env:MSI_OBJECT_ID = (az k8s-extension show --resource-group <resource group>  --cluster-name <connectedclustername> --cluster-type connectedClusters --name <name of extension> | convertFrom-json).identity.principalId
#Example
$Env:MSI_OBJECT_ID = (az k8s-extension show --resource-group myresourcegroup  --cluster-name myconnectedcluster --cluster-type connectedClusters --name ads-extension | convertFrom-json).identity.principalId

(2) Assegnare un ruolo all'identità gestita

Per assegnare il ruolo Autore delle metriche di monitoraggio, eseguire il comando seguente:

az role assignment create --assignee $Env:MSI_OBJECT_ID --role 'Monitoring Metrics Publisher' --scope "/subscriptions/$SUBSCRIPTION_ID/resourceGroups/$RESOURCE_GROUP_NAME"

Il caricamento automatico delle metriche può essere abilitato come segue:

az arcdata dc update --name <name of datacontroller> --resource-group <resource group> --auto-upload-metrics true
#Example
az arcdata dc update --name arcdc --resource-group <myresourcegroup> --auto-upload-metrics true

Per disabilitare il caricamento automatico delle metriche in Monitoraggio di Azure, eseguire il comando seguente:

az arcdata dc update --name <name of datacontroller> --resource-group <resource group> --auto-upload-metrics false
#Example
az arcdata dc update --name arcdc --resource-group <myresourcegroup> --auto-upload-metrics false

Caricare le metriche per il controller dei dati di Azure Arc in modalità indiretta

Nella modalità di connessione indiretta, l'entità servizio viene usata per caricare le metriche.

Prerequisiti

Prima di procedere, assicurarsi di aver creato l'entità servizio richiesta e di assegnarla a un ruolo appropriato. Per informazioni dettagliate, vedere:

Impostare le variabili di ambiente e confermare

Impostare l'URL dell'autorità SPN in una variabile di ambiente:

$Env:SPN_AUTHORITY='https://login.microsoftonline.com'

Verificare che tutte le variabili di ambiente necessarie siano impostate se si vuole:

$Env:SPN_TENANT_ID
$Env:SPN_CLIENT_ID
$Env:SPN_CLIENT_SECRET
$Env:SPN_AUTHORITY

Caricare metriche in Monitoraggio di Azure

Per caricare le metriche per il servizio Istanza gestita di SQL abilitato da Azure Arc e PostgreSQL abilitato per Azure Arc, eseguire i comandi dell'interfaccia della riga di comando seguenti:

  1. Esportare tutte le metriche nel file specificato:

Nota

L'esportazione di informazioni di utilizzo/fatturazione, metriche e log usando il comando az arcdata dc export al momento richiede di ignorare la verifica SSL. Verrà richiesto di ignorare la verifica SSL oppure impostare la variabile di ambiente AZDATA_VERIFY_SSL=no per evitare la richiesta. Attualmente non è possibile configurare un certificato SSL per l'API di esportazione del controller dei dati.

az arcdata dc export --type metrics --path metrics.json --k8s-namespace arc

  1. Caricare metriche in Monitoraggio di Azure:

    az arcdata dc upload --path metrics.json

    Nota

    Attendere almeno 30 minuti dopo la creazione delle istanze di dati abilitate per Azure Arc per il primo caricamento.

    Assicurarsi di eseguire il comando upload per le metriche subito dopo il comando export, poiché Monitoraggio di Azure accetta solo le metriche relative agli ultimi 30 minuti. Altre informazioni.

Se durante l'esportazione vengono visualizzati errori di recupero delle metriche, verificare se la raccolta dati è impostata su true eseguendo il comando seguente:

az arcdata dc config show  --k8s-namespace arc --use-k8s

Esaminare la sezione "security"

 "security": {
      "allowDumps": true,
      "allowNodeMetricsCollection": true,
      "allowPodMetricsCollection": true,
    },

Verificare se le proprietà allowNodeMetricsCollection e allowPodMetricsCollection sono impostate su true.

Visualizzare le metriche nel portale

Dopo aver caricato le metriche, è possibile visualizzarle dal portale di Azure.

Nota

Si noti che l'elaborazione dei dati caricati può richiedere alcuni minuti prima di poter visualizzare le metriche nel portale.

Per visualizzare le metriche, passare al portale di Azure. Cercare quindi l'istanza di database in base al nome nella barra di ricerca:

È possibile visualizzare l'utilizzo della CPU nella pagina Informazioni generali o, se si vogliono metriche più dettagliate, è possibile fare clic sulle metriche nel pannello di spostamento a sinistra

Scegliere SQL Server o Postgres come spazio dei nomi delle metriche.

Selezionare la metrica da visualizzare (è anche possibile selezionare più metriche).

Modificare la frequenza impostandola sugli ultimi 30 minuti.

Nota

È possibile caricare solo le metriche relative agli ultimi 30 minuti. Monitoraggio di Azure rifiuta le metriche precedenti a 30 minuti.

Automazione dei caricamenti (facoltativo)

Per caricare metriche e log in base a una pianificazione, è possibile creare uno script ed eseguirlo in un timer ogni pochi minuti. Di seguito è riportato un esempio di automazione dei caricamenti usando uno script della shell Linux.

Nell'editor di testo/codice preferito aggiungere lo script seguente al file e salvarlo come file di script eseguibile, ad esempio .sh (Linux/Mac), .cmd, .bat o .ps1.

az arcdata dc export --type metrics --path metrics.json --force  --k8s-namespace arc
az arcdata dc upload --path metrics.json

Rendere eseguibile il file di script

chmod +x myuploadscript.sh

Eseguire lo script ogni 20 minuti:

watch -n 1200 ./myuploadscript.sh

È anche possibile usare un'utilità di pianificazione dei processi come Cron o Utilità di pianificazione di Windows o un agente di orchestrazione come Ansible, Puppet o Chef.

Indicazioni generali su utilizzo e metriche di esportazione e caricamento

Le operazioni di creazione, lettura, aggiornamento ed eliminazione (CRUD) nei servizi dati abilitati per Azure Arc vengono registrate a scopo di fatturazione e monitoraggio. Esistono servizi in background che monitorano queste operazioni CRUD e calcolano il consumo in modo appropriato. Il calcolo effettivo dell'utilizzo o del consumo avviene su base pianificata e viene eseguito in background.

Caricare l'utilizzo una sola volta al giorno. Quando le informazioni sull'utilizzo vengono esportate e caricate più volte nello stesso periodo di 24 ore, solo l'inventario delle risorse viene aggiornato nel portale di Azure, ma non l'utilizzo delle risorse.

Per il caricamento delle metriche, Monitoraggio di Azure accetta solo gli ultimi 30 minuti di dati (Altre informazioni). Il materiale sussidiario per caricare le metriche consiste nel caricare le metriche immediatamente dopo la creazione del file di esportazione in modo da poter visualizzare l'intero set di dati nel portale di Azure. Ad esempio, se le metriche sono state esportate alle 14:00 ed è stato eseguito il comando di caricamento alle 14:50. Poiché Monitoraggio di Azure accetta solo i dati per gli ultimi 30 minuti, è possibile che nel portale non vengano visualizzati dati.

Contenuto correlato

Caricare i log in Monitoraggio di Azure

Caricare dati di utilizzo, metriche e log in Monitoraggio di Azure

Caricare i dati di fatturazione in Azure e visualizzarli nel portale di Azure

Visualizzare la risorsa del controller dei dati di Azure Arc nel portale di Azure