Ottenere le metriche di utilizzo di una macchina virtuale usando l'API REST

Articolo
03/25/2024

Si applica a: ✔️ macchine virtuali di Linux ✔️ set di scalabilità flessibili

Questo esempio illustra come recuperare l'utilizzo della CPU per una macchina virtuale Linux usando l'API REST di Azure.

La documentazione di riferimento completa ed esempi per l'API REST sono disponibili nell'articolo Informazioni di riferimento su REST di Monitoraggio di Azure.

Compilare la richiesta

Usare la richiesta GET seguente per raccogliere la metrica Percentuale CPU da una macchina virtuale

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmname}/providers/microsoft.insights/metrics?api-version=2018-01-01&metricnames=Percentage%20CPU&timespan=2018-06-05T03:00:00Z/2018-06-07T03:00:00Z

Intestazioni delle richieste

Gli argomenti seguenti sono obbligatori:

Intestazione della richiesta	Descrizione
Content-Type (Tipo di contenuto):	Obbligatorio. Impostare su `application/json`.
Autorizzazione:	Obbligatorio. Impostare su un token di accesso`Bearer` valido.

Parametri URI

Nome	Descrizione
subscriptionId	ID sottoscrizione che identifica una sottoscrizione di Azure. Se sono disponibili più sottoscrizioni, vedere Uso di più sottoscrizioni.
resourceGroupName	Nome del gruppo di risorse di Azure associato alla risorsa. È possibile ottenere questo valore dall'API di Azure Resource Manager, dall'interfaccia della riga di comando o dal portale.
vmname	Nome della macchina virtuale di Azure.
metricnames	Elenco delimitato da virgole delle metriche di Load Balancer valide.
api-version	Versione dell'API da usare per la richiesta. Questo documento illustra la versione api-version `2018-01-01`, inclusa nell'URL precedente.
timespan	Stringa con il formato `startDateTime_ISO/endDateTime_ISO` che definisce l'intervallo di tempo delle metriche restituite. Questo parametro facoltativo è impostato per restituire, nell'esempio, i dati relativi a un singolo giorno.

Corpo della richiesta

Per questa operazione non è necessario alcun corpo della richiesta.

Gestire la risposta

Quando l'elenco dei valori delle metriche viene restituito correttamente, viene visualizzato il codice di stato 200. La documentazione di riferimento contiene un elenco completo dei codici di errore.

Esempio di risposta

{
    "cost": 0,
    "timespan": "2018-06-08T23:48:10Z/2018-06-09T00:48:10Z",
    "interval": "PT1M",
    "value": [
        {
            "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmname}/providers/microsoft.insights/metrics?api-version=2018-01-01&metricnames=Percentage%20CPU",
            "type": "Microsoft.Insights/metrics",
            "name": {
                "value": "Percentage CPU",
                "localizedValue": "Percentage CPU"
            },
            "unit": "Percent",
            "timeseries": [
                {
                    "metadatavalues": [],
                    "data": [
                        {
                            "timeStamp": "2018-06-08T23:48:00Z",
                            "average": 0.44
                        },
                        {
                            "timeStamp": "2018-06-08T23:49:00Z",
                            "average": 0.31
                        },
                        {
                            "timeStamp": "2018-06-08T23:50:00Z",
                            "average": 0.29
                        },
                        {
                            "timeStamp": "2018-06-08T23:51:00Z",
                            "average": 0.29
                        },
                        {
                            "timeStamp": "2018-06-08T23:52:00Z",
                            "average": 0.285
                        } ]
                } ]
        } ]
}