Partager via

Obtenir des métriques Load Balancer avec Azure Monitor CLI

  • Article

Dans cet article, vous allez découvrir quelques exemples pour répertorier les métriques Load Balancer à l’aide d’Azure Monitor CLI.

La documentation de référence complète et d’autres exemples permettant de récupérer des métriques à l’aide d’Azure Monitor CLI sont disponibles dans la référence des métriques az monitor.

Tableau des noms de métriques via l’interface CLI

Lorsque vous utilisez l’interface CLI, les métriques Load Balancer peuvent utiliser un nom de métrique différent pour la valeur du paramètre CLI. Lorsque vous spécifiez le nom de métrique via le paramètre --metric dimension, utilisez plutôt le nom de métrique CLI. Par exemple, la disponibilité du chemin de données de métrique est utilisée en spécifiant un paramètre de --metric VipAvaialbility.

Voici une table des métriques Load Balancer courantes, le nom de la métrique CLI et une recommandation des valeurs d’agrégation pour les requêtes :

Mesure Nom de la métrique CLI Agrégation recommandée
Disponibilité du chemin d’accès aux données VipAvailability Average
État de la sonde d’intégrité DipAvailability Average
Nombre de SYN (synchroniser) SYNCount Average
Nombre de connexions SNAT SnatConnectionCount SUM
Ports SNAT alloués AllocatedSnatPorts Moyenne
Ports SNAT utilisés UsedSnatPorts Average
Nombre d’octets ByteCount SUM
Nombre de paquets PacketCount Sum

Pour plus d’informations sur les définitions de métriques, reportez-vous à la référence des données de l’équilibreur de charge de surveillance.

Exemples CLI pour les métriques Load Balancer

La commande az monitor metrics est utilisée pour afficher les métriques de ressources Azure. Pour afficher les définitions de métriques disponibles pour Standard Load Balancer, vous exécutez la commande az monitor metrics list-definitions.

# Display available metric definitions for a Standard Load Balancer resource

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

Notes

Dans tous les exemples suivants, remplacez <resource_id> par l’ID de ressource unique de votre Standard Load Balancer.

Pour récupérer les métriques Standard Load Balancer d’une ressource, vous pouvez utiliser la commande az monitor metrics list. Par exemple, utilisez l’option --metric DipAvailability pour collecter la métrique État de la sonde d’intégrité à partir d’un Standard Load Balancer.


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

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

Lorsque vous exécutez la commande ci-dessus, la sortie de l’État de sonde d’intégrité est similaire à la sortie suivante :

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/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/myResourceGroup/providers/Microsoft.Network/loadBalancers/myLoadBalancer/providers/Microsoft.Insights/metrics/DipAvailability",
      "name": {
        "localizedValue": "Health Probe Status",
        "value": "DipAvailability"
      },
      "resourceGroup": "myResourceGroup",
      "timeseries": [],
      "type": "Microsoft.Insights/metrics",
      "unit": "Count"
    }
  ]
}
...

Vous pouvez spécifier le type d’agrégation d’une métrique avec le paramètre –-aggregation. Pour obtenir des agrégations recommandées, consultez La référence des données de l’équilibreur de charge de surveillance](./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

Pour spécifier l’intervalle aux métriques, utilisez le paramètre --interval et spécifiez une valeur au format ##h##m. L’intervalle par défaut est de 1 minute.


# 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

Par défaut, az monitor metrics list renvoie les métriques d’agrégation de la ressource à partir de la dernière heure. Vous pouvez interroger des données de métrique sur une période à l’aide de --start-time et --end-time avec le format de date (aaaa-mm-dd) heure (hh:mm:ss.xxxxx) fuseau horaire (+/-hh:mm). Pour répertorier l’État moyen de la sonde d’intégrité agrégé par jour à partir du 5 mai 2022 et du 10 mai 2022, utilisez la commande suivante :

# 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

Notes

Les heures de début et de fin sont représentées à l’aide d’un format aaaa-mm-dd. Par exemple, tous les jours entre le 5 mai 2022 et le 10 mai 2022 seraient représentés comme 2022-05-01 et 2022-05-10.

Pour fractionner des métriques sur une dimension, comme « BackendIPAddress », spécifiez la dimension dans l’indicateur --filter. Les dimensions d’une métrique sont des paires nom-valeur qui incluent des données supplémentaires pour décrire la valeur de la métrique. Pour en savoir plus sur les dimensions prises en charge pour chaque métrique, consultez Informations de référence sur les données de supervision de l’équilibreur de charge.

# 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

Vous pouvez également spécifier une valeur de dimension spécifique.

# 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

Dans les cas où vous devez filtrer sur plusieurs valeurs de dimension, spécifiez la valeur --filter en utilisant and entre les valeurs.

# 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

Étapes suivantes