Share via

Ottenere le metriche di Load Balancer con l'interfaccia della riga di comando di Monitoraggio di Azure

  • Articolo

Questo articolo illustra alcuni esempi per elencare le metriche di Load Balancer usando l'interfaccia della riga di comando di Monitoraggio di Azure.

La documentazione di riferimento completa e altri esempi per il recupero delle metriche tramite l'interfaccia della riga di comando di Monitoraggio di Azure sono disponibili in az monitor metrics reference.

Tabella dei nomi delle metriche tramite l'interfaccia della riga di comando

Quando si usa l'interfaccia della riga di comando, le metriche di Load Balancer possono usare un nome di metrica diverso per il valore del parametro della CLI. Quando si specifica il nome della metrica tramite il parametro --metric dimension, usare invece il nome della metrica dell'interfaccia della riga di comando. Ad esempio, la disponibilità del percorso dati della metrica viene usata specificando un parametro di --metric VipAvaialbility.

Ecco una tabella con le metriche comuni di Load Balancer, il nome della metrica dell'interfaccia della riga di comando e i valori di aggregazione consigliati per le query:

Metric Nome della metrica CLI Aggregazione consigliata
Disponibilità del percorso dati VipAvailability Media
Stato del probe di integrità DipAvailability Media
Conteggio SYN (sincronizzazione) SYNCount Media
Numero di connessioni SNAT SnatConnectionCount Sum
Porte SNAT allocate AllocatedSnatPorts Media
Porte SNAT usate UsedSnatPorts Media
Conteggio byte ByteCount Sum
Numero di pacchetti PacketCount Sum

Per le definizioni delle metriche e altri dettagli, vedere Informazioni di riferimento sul monitoraggio dei dati di bilanciamento del carico.

Esempi dell'interfaccia della riga di comando per le metriche di Load Balancer

Il comando az monitor metrics viene usato per visualizzare le metriche delle risorse di Azure. Per visualizzare le definizioni delle metriche disponibili per un Load Balancer Standard, eseguire il comando az monitor metrics list-definitions.

# Display available metric definitions for a Standard Load Balancer resource

az monitor metrics list-definitions --resource <resource_id>

Nota

Negli esempi seguenti, sostituire <resource_id> con l'ID risorsa univoco del proprio Load Balancer Standard.

Per recuperare le metriche di Load Balancer Standard per una risorsa, è possibile usare il comando az monitor metrics list. Ad esempio, usare l'opzione --metric DipAvailability per raccogliere la metrica Stato del probe di integrità da un Load Balancer Standard.


# List the Health Probe Status metric from a Standard Load Balancer

az monitor metrics list --resource <resource_id> --metric DipAvailability

Quando si esegue il comando sopra indicato, l'output per lo stato del probe di integrità sarà simile all'output seguente:

user@Azure:~$ az monitor metrics list --resource <resource_id> --metric DipAvailability
{
  "cost": 59,
  "interval": "0:01:00",
  "namespace": "Microsoft.Network/loadBalancers",
  "resourceregion": "eastus2",
  "timespan": "2022-06-30T15:22:39Z/2022-06-30T16:22:39Z",
  "value": [
    {
      "displayDescription": "Average Load Balancer health probe status per time duration",
      "errorCode": "Success",
      "errorMessage": null,
      "id": "/subscriptions/6a5f35e9-6951-499d-a36b-83c6c6eed44a/resourceGroups/myResourceGroup2/providers/Microsoft.Network/loadBalancers/myLoadBalancer/providers/Microsoft.Insights/metrics/DipAvailability",
      "name": {
        "localizedValue": "Health Probe Status",
        "value": "DipAvailability"
      },
      "resourceGroup": "myResourceGroup2",
      "timeseries": [],
      "type": "Microsoft.Insights/metrics",
      "unit": "Count"
    }
  ]
}
...

È possibile specificare il tipo di aggregazione per una metrica con il parametro –-aggregation. Per le aggregazioni consigliate, vedere Informazioni di riferimento sul monitoraggio dei dati di bilanciamento del carico (./monitor-load-balancer-reference.md).


# List the average Health Probe Status metric from a Standard Load Balancer

az monitor metrics list --resource <resource_id> --metric DipAvailability --aggregation Average

Per specificare l'intervallo per le metriche, usare il parametro --interval e specificare un valore nel formato ##h##m. L'intervallo predefinito è 1 m.


# List the average List the average Health Probe Status metric from a Standard Load Balancer in 5 minute intervals

az monitor metrics list --resource <resource_id> --metric DipAvailability --aggregation Average --interval 5m

Per impostazione predefinita, az monitor metrics list restituisce le metriche di aggregazione della risorsa relative all'ultima ora. È possibile eseguire query sui dati delle metriche in un periodo di tempo usando --start-time e --end-time con il formato di data (aaaa-mm-gg), ora (hh:mm:ss.xxxxx), fuso orario (+/-hh:mm). Per elencare lo stato medio aggregato del probe di integrità al giorno dal 5 maggio 2022 al 10 maggio 2022, usare il comando seguente:

# List average Health Probe Status metric aggregated per day from May 5, 2022 and May 10, 2022. 

az monitor metrics list --resource <resource_id> --metric DipAvailability --start-time 2022-05-01T00:00:00Z --end-time 2022-05-10T00:00:00Z --interval PT24H --aggregation Average

Nota

Le ore di inizio e di fine vengono rappresentate con un formato aaaa-mm-gg. Ad esempio, ogni giorno tra il 5 maggio 2022 e il 10 maggio 2022 verrebbe rappresentato come 2022-05-01 e 2022-05-10.

Per suddividere le metriche in una dimensione, ad esempio “BackendIPAddress”, specificare la dimensione nel flag --filter. Le dimensioni di una metrica sono coppie nome/valore contenenti dati aggiuntivi per descrivere il valore della metrica. Per altre informazioni sulle dimensioni supportate per ogni metrica, vedere Informazioni di riferimento sul monitoraggio dei dati di bilanciamento del carico.

# List average Health Probe Status metric and filter for all BackendIPAddress dimensions

az monitor metrics list --resource $res --metric DipAvailability --filter "BackendIPAddress eq '*'" --aggregation Average

È anche possibile indicare un valore di dimensione specifico.

# List average Health Probe Status metric and filter for the 10.1.0.4 BackendIPAddress dimension

az monitor metrics list --resource <resource_id> --metric DipAvailability --filter "BackendIPAddress eq '10.1.0.4'" --aggregation Average

Nei casi in cui è necessario filtrare per più valori di dimensione, specificare il valore --filter utilizzando and tra i valori.

# List average Health Probe Status metric and filter for all BackendIPAddress and BackendPort dimensions

az monitor metrics list --resource <resource_id> --metric DipAvailability --filter "BackendIPAddress eq '*' and BackendPort eq '*'" --aggregation Average

Passaggi successivi