Module 6 du parcours métriques Dynatrace Managed : les métriques cloud Managed, de vSphere à AWS, Azure, OpenStack et Cloud Foundry, puis les métriques apportées par les extensions et intégrations technologiques, en 22 fiches.
Parcours : Formation aux métriques Dynatrace Managed · Module 6/7 · Type : référence · Plateforme : Dynatrace Managed (métriques classiques)
Dans ce module :
- un tableau récapitulatif des 22 clés
- une fiche par métrique, avec cas d’usage et piège
- les conditions de collecte : intégration vCenter, AWS, Azure, extensions
Une VM lente n’a pas toujours un problème dans la VM. Le CPU ready, le swap de l’hyperviseur ou la latence d’une banque de données partagée sont invisibles depuis l’OS invité. Ces métriques donnent le point de vue de la couche du dessous, celle qui explique les incidents où « rien n’a changé » côté application.
Le contenu vaut pour Dynatrace Managed et les métriques classiques builtin:. Ces métriques n’apparaissent que si l’intégration correspondante est configurée : connexion vCenter, compte AWS ou souscription Azure, extension activée. Sur Dynatrace SaaS avec Grail, une partie existe sous des clés dt.cloud.* ; d’autres, comme la disponibilité des hôtes ESXi, n’y sont pas reprises.
Pour l’ingestion de CloudWatch, voyez aussi l’article sur AWS CloudWatch ; pour écrire votre propre extension, l’exemple PostgreSQL.
Les métriques cloud Managed en un tableau
Clés, unités et agrégations reprises de la liste officielle des métriques intégrées. La portée suit la section de la documentation ; les dimensions exactes figurent dans le descripteur.
| Clé | Unité | Agrégations | Portée | Ce qu’elle mesure |
|---|---|---|---|---|
builtin:cloud.vmware.hypervisor.availability |
Percent (%) | avg | VMware (hôte ESXi) | Disponibilité de l’hôte ESXi |
builtin:cloud.vmware.hypervisor.cpu.usage |
Percent (%) | avg, max, min | VMware (hôte ESXi) | CPU de l’hôte ESXi |
builtin:cloud.vmware.hypervisor.mem.consumed |
Kibibyte | avg, max, min | VMware (hôte ESXi) | Mémoire consommée sur l’hôte ESXi |
builtin:cloud.vmware.hypervisor.mem.swapIn |
Kibibyte/second | avg, max, min | VMware (hôte ESXi) | Débit de swap-in de l’hôte |
builtin:cloud.vmware.hypervisor.hostdisk.readLatency |
Millisecond | avg, max, min | VMware (disque hôte) | Latence de lecture disque de l’hôte |
builtin:cloud.vmware.hypervisor.hostdisk.writeLatency |
Millisecond | avg, max, min | VMware (disque hôte) | Latence d’écriture disque de l’hôte |
builtin:cloud.vmware.hypervisor.nic.packetsRxDropped |
Count | value | VMware (carte réseau) | Paquets reçus abandonnés |
builtin:cloud.vmware.hypervisor.vms.count |
Count | avg, max, min | VMware (hôte ESXi) | Nombre de VM par hôte |
builtin:cloud.vmware.vm.cpu.readyPerc |
Percent (%) | avg, max, min | VMware (VM) | CPU ready de la VM |
builtin:cloud.vmware.vm.cpu.usagePerc |
Percent (%) | avg, max, min | VMware (VM) | CPU de la VM vu par l’hyperviseur |
builtin:cloud.vmware.vm.cpu.swapWait |
Millisecond | value | VMware (VM) | Attente de swap de la VM |
builtin:cloud.vmware.vm.mem.swapIn |
Kibibyte/second | avg, max, min | VMware (VM) | Débit de swap-in de la VM |
builtin:cloud.vmware.vm.disk.usage |
kB/s | avg, max, min | VMware (VM) | Débit disque de la VM |
builtin:cloud.aws.az.running |
Count | avg, max, min | AWS (zone de disponibilité) | Instances EC2 en marche par zone |
builtin:cloud.azure.region.vms.running |
Count | avg, max, min | Azure (région) | VM actives par région Azure |
builtin:cloud.azure.vmScaleSet.vms.stopped |
Count | avg, max, min | Azure (scale set) | VM arrêtées dans un scale set |
builtin:cloud.openstack.vm.cpu.usage |
Percent (%) | avg, max, min | OpenStack (VM) | CPU des VM OpenStack |
builtin:cloud.cloudfoundry.http.responses5xx |
Count | value | Cloud Foundry | Réponses 5xx du routeur Cloud Foundry |
builtin:tech.customDevice.count |
Count | value | Extensions (équipements) | Nombre d’équipements personnalisés |
builtin:tech.nginx.upstream.unhealthy |
Count | avg, max, min | Technologie NGINX Plus | Serveurs amont NGINX Plus en échec |
builtin:tech.kafka.pg.kafka.server.ReplicaManager.UnderReplicatedPartitions.Value |
Count | avg, count, max, min, sum | Technologie Kafka | Partitions sous-répliquées (broker) |
builtin:tech.rabbitmq.cluster_messages_ready |
Count | avg, count, max, min, sum | Technologie RabbitMQ | Messages prêts dans le cluster |
{{img:143-metriques-cloud-managed-1.png|Extrait de la documentation Dynatrace Managed : clés builtin:cloud.vmware de l’hôte ESXi et des VM avec leur nom et leur unité}}
Comment lire une fiche
Même ordre que dans les autres modules : la mesure, un cas d’usage, un piège, un selector. Les selectors ne font appel à aucune dimension non documentée : ils trient et limitent, et vous ajoutez un splitBy une fois les dimensions lues dans le descripteur. Les métriques de comptage à agrégation value sont données sans transformation d’agrégation.
VMware : hôtes ESXi
builtin:cloud.vmware.hypervisor.availability
Disponibilité de l’hôte ESXi vue par l’intégration vCenter. Cas d’usage : un SLO d’infrastructure par cluster vSphere, ou l’explication d’une vague de VM indisponibles. Piège : la documentation SaaS classe cette clé parmi les métriques VMware non reprises sur Grail ; elle reste propre aux métriques classiques.
builtin:cloud.vmware.hypervisor.availability:avg
builtin:cloud.vmware.hypervisor.cpu.usage
Utilisation CPU de l’hyperviseur, toutes VM confondues. Cas d’usage : savoir si une VM lente souffre d’un hôte physique saturé ; à lire avec le CPU ready des VM. Piège : un hôte à 60 % peut déjà pénaliser des VM très larges en vCPU ; le chiffre global ne suffit pas.
builtin:cloud.vmware.hypervisor.cpu.usage:sort(value(max,descending)):limit(10)
builtin:cloud.vmware.hypervisor.mem.consumed
Mémoire physique de l’hôte consommée par les VM et l’hyperviseur. Cas d’usage : vérifier la marge avant d’ajouter des VM ou de mettre un hôte en maintenance (ses VM migrent vers les autres). Piège : l’unité est le kibioctet ; un graphique sans conversion paraît mille fois trop grand.
builtin:cloud.vmware.hypervisor.mem.consumed:sort(value(max,descending)):limit(10)
builtin:cloud.vmware.hypervisor.mem.swapIn
Débit auquel l’hôte relit en mémoire des pages précédemment échangées sur disque. Cas d’usage : un swap-in soutenu signale une surallocation mémoire qui ralentit toutes les VM de l’hôte. Piège : un swap-in ponctuel après un pic passé n’est pas une urgence ; c’est la durée qui compte.
builtin:cloud.vmware.hypervisor.mem.swapIn:max
builtin:cloud.vmware.hypervisor.hostdisk.readLatency
Latence des lectures sur les disques et banques de données vus par l’hôte. Cas d’usage : départager une lenteur de base de données entre requête mal écrite et stockage partagé dégradé. Piège : un seuil fixe se calibre sur votre baie de stockage ; aucun chiffre universel ne vaut pour tous les supports.
builtin:cloud.vmware.hypervisor.hostdisk.readLatency:sort(value(max,descending)):limit(10)
builtin:cloud.vmware.hypervisor.hostdisk.writeLatency
Pendant de la précédente pour les écritures. Cas d’usage : les journaux de transactions et les files de messages sont sensibles à l’écriture ; une hausse explique souvent des validations lentes. Piège : les caches d’écriture de la baie masquent les problèmes jusqu’à leur saturation, puis la latence grimpe d’un coup.
builtin:cloud.vmware.hypervisor.hostdisk.writeLatency:sort(value(max,descending)):limit(10)
builtin:cloud.vmware.hypervisor.nic.packetsRxDropped
Paquets reçus puis abandonnés par les cartes réseau physiques de l’hôte. Cas d’usage : des retransmissions élevées côté processus (module 5) trouvent parfois leur cause ici. Piège : c’est un compteur ; lisez-le comme un nombre d’événements par intervalle, pas comme un niveau.
builtin:cloud.vmware.hypervisor.nic.packetsRxDropped
builtin:cloud.vmware.hypervisor.vms.count
Nombre de machines virtuelles hébergées par l’hôte. Cas d’usage : vérifier l’équilibrage d’un cluster après une opération DRS ou une maintenance. Piège : le nombre ne dit rien de la taille des VM ; croisez avec CPU et mémoire de l’hôte.
builtin:cloud.vmware.hypervisor.vms.count:max
VMware : machines virtuelles
builtin:cloud.vmware.vm.cpu.readyPerc
Part du temps pendant laquelle la VM était prête à s’exécuter sans obtenir de CPU physique. C’est la mesure la plus directe de la contention. Cas d’usage : une application lente dont le CPU invité semble normal ; un ready élevé montre qu’elle attend l’hyperviseur. Piège : l’OS invité ne voit pas ce temps ; seule l’intégration VMware l’expose.
builtin:cloud.vmware.vm.cpu.readyPerc:sort(value(max,descending)):limit(10)
builtin:cloud.vmware.vm.cpu.usagePerc
Utilisation CPU de la VM mesurée côté vSphere. Cas d’usage : repérer les VM surdimensionnées, presque oisives, à réduire pour libérer l’hôte. Piège : la valeur peut différer de builtin:host.cpu.usage mesuré par OneAgent dans l’invité ; ce sont deux points de vue.
builtin:cloud.vmware.vm.cpu.usagePerc:sort(value(avg,ascending)):limit(20)
builtin:cloud.vmware.vm.cpu.swapWait
Temps passé par la VM à attendre des pages échangées par l’hyperviseur. Cas d’usage : confirme qu’une surallocation mémoire de l’hôte touche bien cette VM. Piège : toute valeur durable est anormale sur une VM de production ; ne la noyez pas dans une moyenne quotidienne.
builtin:cloud.vmware.vm.cpu.swapWait
builtin:cloud.vmware.vm.mem.swapIn
Débit de swap-in au niveau de la VM. Cas d’usage : identifier quelles VM paient la surallocation signalée par builtin:cloud.vmware.hypervisor.mem.swapIn. Piège : il s’agit du swap de l’hyperviseur, distinct du swap de l’OS invité vu par OneAgent.
builtin:cloud.vmware.vm.mem.swapIn:sort(value(max,descending)):limit(10)
builtin:cloud.vmware.vm.disk.usage
Débit d’entrées-sorties disque de la VM. Cas d’usage : trouver la VM « voisine bruyante » qui sature une banque de données partagée au moment où la latence de l’hôte grimpe. Piège : l’unité affichée est le kB/s ; vérifiez-la dans le descripteur avant toute conversion.
builtin:cloud.vmware.vm.disk.usage:sort(value(max,descending)):limit(10)
Cloud public et privé : AWS, Azure, OpenStack, Cloud Foundry
builtin:cloud.aws.az.running
Nombre d’instances EC2 en marche par zone de disponibilité, issu de l’intégration AWS. Cas d’usage : vérifier qu’un groupe d’autoscaling reste réparti entre zones, condition de la résilience. Piège : c’est la seule clé AWS de la liste builtin: ; les métriques CloudWatch de services AWS relèvent de l’intégration cloud et ont leurs propres clés, à lire dans le navigateur de métriques.
builtin:cloud.aws.az.running:max
builtin:cloud.azure.region.vms.running
Nombre de VM actives dans une région Azure. Cas d’usage : suivre un plan de reprise qui bascule des charges d’une région à l’autre. Piège : seules les souscriptions configurées dans l’intégration Azure sont comptées.
builtin:cloud.azure.region.vms.running:max
builtin:cloud.azure.vmScaleSet.vms.stopped
Nombre de VM arrêtées dans un groupe de machines virtuelles identiques (scale set). Cas d’usage : une valeur qui reste non nulle hors fenêtre de maintenance indique des instances qui ne redémarrent pas. Piège : à lire avec builtin:cloud.azure.vmScaleSet.vms.running pour avoir la proportion.
builtin:cloud.azure.vmScaleSet.vms.stopped:max
builtin:cloud.openstack.vm.cpu.usage
Utilisation CPU des VM d’un cloud privé OpenStack, vue par l’intégration. Cas d’usage : repérer les instances saturées dans un projet sans agent dans l’invité. Piège : si OneAgent tourne aussi dans la VM, préférez ses métriques d’hôte, plus riches.
builtin:cloud.openstack.vm.cpu.usage:sort(value(max,descending)):limit(10)
builtin:cloud.cloudfoundry.http.responses5xx
Nombre de réponses 5xx, signe selon la documentation d’applications qui plantent à répétition ou répondent mal. Cas d’usage : un indicateur de santé de la plateforme, à rapprocher des déploiements. Piège : c’est un compteur brut ; rapportez-le à builtin:cloud.cloudfoundry.http.totalRequests pour obtenir un taux.
builtin:cloud.cloudfoundry.http.responses5xx
Extensions et technologies intégrées
builtin:tech.customDevice.count
Nombre d’équipements personnalisés (custom devices) créés par les extensions et intégrations : équipements réseau, appliances, systèmes tiers. Cas d’usage : vérifier après une mise à jour d’extension que tous les équipements attendus remontent encore. Piège : une baisse silencieuse est souvent un problème d’authentification de l’extension, pas une panne de l’équipement.
builtin:tech.customDevice.count
builtin:tech.nginx.upstream.unhealthy
Nombre de serveurs amont déclarés en échec par NGINX Plus. Cas d’usage : savoir qu’un répartiteur sert le trafic avec un pool amputé, avant que les temps de réponse ne s’en ressentent. Piège : la métrique concerne NGINX Plus et suppose la surveillance correspondante activée ; NGINX open source n’expose pas ces compteurs.
builtin:tech.nginx.upstream.unhealthy:max
builtin:tech.kafka.pg.kafka.server.ReplicaManager.UnderReplicatedPartitions.Value
Nombre de partitions dont toutes les répliques ne sont pas synchronisées sur le broker. Cas d’usage : la métrique Kafka la plus surveillée ; une valeur non nulle durable signifie qu’une panne de broker supplémentaire pourrait perdre des données. Piège : elle monte brièvement lors d’un redémarrage planifié ; alertez sur la durée.
builtin:tech.kafka.pg.kafka.server.ReplicaManager.UnderReplicatedPartitions.Value:max
builtin:tech.rabbitmq.cluster_messages_ready
Nombre de messages prêts à être livrés et en attente de consommateurs, à l’échelle du cluster RabbitMQ. Cas d’usage : une file qui ne cesse de croître signale des consommateurs trop lents ou arrêtés. Piège : un stock stable et élevé peut être voulu (traitement par lots) ; comparez à la tendance habituelle.
builtin:tech.rabbitmq.cluster_messages_ready:max
Comment vérifier que ça fonctionne
- Dans les réglages de l’environnement, vérifiez que l’intégration est connectée (vCenter, AWS, Azure) ou que l’extension est active, sans erreur d’authentification.
- Lancez la requête de liste filtrée par préfixe pour voir les clés réellement disponibles chez vous :
curl -s -H "Authorization: Api-Token $DT_TOKEN" \
"https://managed.example.com/e/ENV-ID/api/v2/metrics?metricSelector=builtin:cloud.vmware.*&fields=unit,aggregationTypes"
- Collez ensuite un selector d’une fiche dans le Data Explorer (mode Code). Une série vide alors que la clé est listée signifie en général que l’entité surveillée n’existe pas dans la période choisie.
Bonnes pratiques
- Combinez les couches : CPU ready (VMware) +
builtin:host.cpu.usage(OneAgent) évite de conclure trop vite à un problème applicatif. - Surveillez la collecte elle-même : une intégration qui perd ses droits fait disparaître des séries sans alerte ; un suivi de
builtin:tech.customDevice.countle révèle. - Réduisez le bruit en alertant sur la durée, comme expliqué dans l’article sur le bruit des alertes Davis.
Questions fréquentes
Faut-il un ActiveGate pour les métriques VMware en Managed ?
Oui : la surveillance vCenter passe par un ActiveGate d’environnement qui interroge l’API vSphere. Vérifiez les versions prises en charge dans la documentation de votre version de Managed.
Pourquoi si peu de clés AWS builtin ?
La liste builtin: ne contient que quelques compteurs d’inventaire. Les métriques de services AWS proviennent de l’intégration CloudWatch et se découvrent dans le navigateur de métriques de l’environnement.
Les métriques d’extension sont-elles aussi des builtin ?
Certaines technologies intégrées (Kafka, RabbitMQ, NGINX Plus) publient des clés builtin:tech.*. Les extensions que vous installez publient leurs propres clés, définies dans leur manifeste.
De l’hôte à la VM et au cloud, vous avez désormais une clé vérifiée pour chaque question courante d’exploitation. Le dernier module montre comment interroger ces clés avec le metric selector et l’API, puis en faire des alertes.
← Module 5 : processus et conteneurs · Sommaire du parcours · Module 7 : requêter et alerter →
span.observer est un blog indépendant de la communauté, non affilié à Dynatrace LLC. Ce module est une sélection commentée : la référence reste la documentation officielle de votre version de Dynatrace Managed, où chaque clé, unité et agrégation doit être vérifiée.