Share via

Abrufen von Load Balancer-Metriken mit der Azure Monitor-CLI

  • Artikel

Dieser Artikel enthält einige Beispiele für das Auflisten von Load Balancer-Metriken mithilfe der Azure Monitor-CLI.

Die vollständige Referenzdokumentation sowie weitere Beispiele für das Abrufen von Metriken mithilfe der Azure Monitor-CLI finden Sie in der Referenz zu az monitor metrics.

Tabelle der Metriknamen bei Verwendung der CLI

Bei Einsatz der CLI werden für die Load Balancer-Metriken möglicherweise andere Metriknamen für den CLI-Parameterwert verwendet. Wenn Sie einen Metriknamen über den Parameter --metric dimension angeben, verwenden Sie den CLI-Metriknamen. Für die Metrik für die Verfügbarkeit eines Datenpfads müsste beispielsweise der Parameter --metric VipAvaialbility angegeben werden.

Hier finden Sie eine Tabelle der gängigen Load Balancer-Metriken, der entsprechenden CLI-Metriknamen und der empfohlenen Aggregationswerte für Abfragen:

Metrik CLI-Metrikname Empfohlene Aggregation
Datenpfadverfügbarkeit VipAvailability Average
Integritätsteststatus DipAvailability Average
SYN-Anzahl (Synchronisierung) SYNCount Average
Anzahl von SNAT-Verbindungen SnatConnectionCount SUM
Zugeordnete SNAT-Ports AllocatedSnatPorts Average
Verwendete SNAT-Ports UsedSnatPorts Average
Byteanzahl ByteCount SUM
Paketzahl PacketCount Sum

Metrikdefinitionen und weitere Details finden Sie in der Referenz zu den Überwachungsdaten von Load Balancer.

CLI-Beispiele für Load Balancer-Metriken

Der Befehl az monitor metrics wird zum Anzeigen der Metrikdaten von Azure-Ressourcen verwendet. Um die für Load Balancer Standard verfügbaren Metrikdefinitionen anzuzeigen, führen Sie den Befehl az monitor metrics list-definitions aus.

# Display available metric definitions for a Standard Load Balancer resource

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

Hinweis

Ersetzen Sie in allen folgenden Beispielen <resource_id> durch die eindeutige Ressourcen-ID Ihrer Load Balancer Standard-Instanz.

Um die Load Balancer Standard-Metriken für eine Ressource abzurufen, können Sie den Befehl az monitor metrics list verwenden. Verwenden Sie beispielsweise die Option --metric DipAvailability, um die Metrik für den Status von Integritätstests aus einer Load Balancer Standard-Instanz zu erfassen.


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

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

Wenn Sie den oben stehenden Befehl ausführen, sieht die Ausgabe für den Status von Integritätstests etwa wie folgt aus:

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"
    }
  ]
}
...

Sie können den Aggregationstyp für eine Metrik mit dem Parameter –-aggregation angeben. Informationen zu empfohlenen Aggregationen finden Sie in der Referenz zu Überwachungsdaten von Load Balancer](./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

Zum Festlegen des Intervalls für die Metriken verwenden Sie den Parameter --interval und geben einen Wert im Format „##h##m“ an. Das Standardintervall lautet „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

Standardmäßig gibt „az monitor metrics list “die aggregierten Metriken der letzten Stunde für eine Ressource zurück. Sie können Metriken mithilfe von --start-time und --end-time für einen bestimmten Zeitraum abfragen. Verwenden Sie dafür das Datumsformat „yyyy-mm-dd“, das Uhrzeitformat „hh:mm:ss.xxxxx“ und das Zeitzonenformat „+/-hh:mm“. Um den durchschnittlichen, pro Tag aggregrierten Integritätsteststatus vom 1. Mai 2022 bis 10. Mai 2022 aufzulisten, verwenden Sie den folgenden Befehl:

# 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

Hinweis

Die Start- und Endzeiten werden im Format „yyyy-mm-dd“ dargestellt. Beispielsweise würde jeder Tag zwischen dem 1. Mai 2022 und dem 10. Mai 2022 als 2022-05-01 und 2022-05-10 dargestellt.

Um Metriken in einer Dimension aufzuteilen – z. B. „BackendIPAddress“ –, geben Sie die Dimension im Flag --filter an. Die Dimensionen einer Metrik sind Name-Wert-Paare, die weitere Daten zum Beschreiben des Metrikwerts enthalten. Informationen dazu, welche Dimensionen für jede Metrik unterstützt werden, finden Sie in der Referenz zu den Überwachungsdaten von Load Balancer.

# 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

Sie können auch einen bestimmten Dimensionswert angeben.

# 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

Geben Sie in Fällen, in denen Sie nach mehreren Dimensionswerten filtern müssen, den Wert --filter mit and zwischen den Werten an.

# 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

Nächste Schritte