Deux cents hosts dans un environnement, dont cinquante serveurs de recette qui saturent leur disque chaque nuit et réveillent l’astreinte. Relever le seuil globalement masquerait les vrais problèmes de production ; le relever host par host est ingérable. C’est exactement le cas d’usage des host groups Dynatrace : un ensemble de hosts qui partagent la même configuration.
Un host group paraît anodin, un simple paramètre passé à l’installation de OneAgent. Pourtant il influence la détection des process groups et des services, les seuils d’anomalie, les mises à jour de OneAgent, le tagging et les management zones. Mal choisi, il se corrige difficilement : changer le host group d’un host recalcule les identifiants de ses process groups.
Ce guide explique à quoi servent les host groups, comment choisir un découpage qui tiendra dans le temps, puis comment les affecter (installation, oneagentctl, interface, Kubernetes) et vérifier le résultat. Il vaut pour Dynatrace Managed et Dynatrace SaaS : le mécanisme est le même, seules quelques vues diffèrent.
À quoi servent les host groups Dynatrace
Un host group est un ensemble de hosts configurable d’un bloc. Trois règles le définissent : chaque host appartient à au plus un host group, l’affectation est statique (portée par OneAgent sur le host), et elle ne change que par oneagentctl, la remote configuration management ou une réinstallation de OneAgent.
1. Des réglages par groupe
Les seuils d’anomaly detection d’infrastructure et la politique de mise à jour de OneAgent peuvent être définis au niveau du host group, en héritant du global ou en le surchargeant. Dans la Settings API, le schéma builtin:anomaly-detection.infrastructure-hosts accepte ainsi les scopes HOST, HOST_GROUP et environment. Pour les mises à jour, la Configuration API expose GET /api/config/v1/hostgroups/{id}/autoupdate (scope ReadConfig) : la configuration du groupe s’applique aux OneAgents dont le réglage est INHERITED.
2. Un découpage des process groups et des services
C’est l’effet le moins connu. Quand le même processus tourne dans deux host groups différents, Dynatrace crée un process group par host group. Les services sont donc, eux aussi, séparés par host group. Conséquence pratique : mettre la recette et la production dans deux host groups distincts sépare leurs process groups et leurs services, ce qui permet de les configurer et de les alerter différemment.
3. Une source de contexte pour les tags et les management zones
Le nom du host group est un attribut utilisable dans les règles de tagging automatique et dans les règles de management zones. Les metric events peuvent aussi filtrer les entités sur HOST_GROUP_NAME. Pour la mise en place des tags et zones, voir management zones et tagging.

Choisir un découpage qui tient dans le temps
Un host n’ayant qu’un seul host group, le découpage doit répondre à une seule question : quels hosts doivent partager la même configuration de supervision ? En pratique, la combinaison environnement + rôle fonctionne bien :
| Host group | Contenu | Réglage typique |
|---|---|---|
prod_paiement_web |
Frontaux de production du paiement | Seuils stricts, mises à jour planifiées |
prod_paiement_db |
Bases de production | Règles disque spécifiques |
rec_paiement |
Recette, tous rôles | Seuils relâchés, mise à jour automatique |
Ce qu’il ne faut pas encoder dans un host group : l’équipe propriétaire, le centre de coût ou tout attribut qui change souvent ou se cumule. Ces informations vont dans des tags ou des management zones, qui acceptent plusieurs valeurs et se modifient sans toucher aux hosts.
Contraintes de nommage : caractères alphanumériques, tirets, underscores et points uniquement ; pas de préfixe dt. ; 100 caractères au maximum. Fixez une convention avant le premier déploiement : renommer revient à changer de host group.
Définir les host groups Dynatrace pas à pas
Étape 1 — À l’installation de OneAgent
Passez le paramètre --set-host-group à l’installateur. Sur Linux :
sudo /bin/sh Dynatrace-OneAgent-Linux.sh --set-host-group=prod_paiement_web
Sur Windows, le même paramètre fonctionne avec l’installateur EXE, et le nom peut aussi être saisi dans l’interface d’installation. Le détail du téléchargement et des autres paramètres est dans installer OneAgent sur Linux.
Étape 2 — Après l’installation, avec oneagentctl
L’outil se trouve par défaut dans /opt/dynatrace/oneagent/agent/tools sur Linux et demande les droits root.

Changer de host group impose de redémarrer OneAgent et les services surveillés. --restart-service (OneAgent 1.189+) redémarre OneAgent ; prévoyez le redémarrage des applications dans une fenêtre de maintenance.
Étape 3 — Depuis l’interface, en masse
- Allez dans Deployment Status, onglet OneAgents.
- Cochez les hosts concernés, puis modify host group en bas de page et Run action.
- Choisissez Specify host group to be assigned (ou Remove current host group assignment), Next, relisez et Apply changes.
OneAgent redémarre automatiquement après application. C’est la remote configuration management : pratique pour corriger un lot de hosts sans session SSH.
Étape 4 — Sur Kubernetes, dans la DynaKube
Avec Dynatrace Operator, déclarez le host group dans la ressource DynaKube avec le champ hostGroup de .spec.oneAgent. La documentation le présente comme la méthode à privilégier, devant l’argument --set-host-group désormais obsolète ; si les deux sont présents, le champ l’emporte.
# Extrait d'une ressource DynaKube (le reste de la ressource est inchangé)
spec:
apiUrl: https://{votre-domaine}/e/{id-environnement}/api
oneAgent:
hostGroup: prod_k8s_workers # un host group par cluster et environnement
cloudNativeFullStack: {}
Partez de la DynaKube fournie pour votre version d’Operator et ajoutez seulement le champ hostGroup. Voir Dynatrace Operator sur Kubernetes.
Étape 5 — Régler le groupe
Dans Settings > Monitoring > Monitoring overview, sélectionnez le lien Host group d’un host pour ouvrir les réglages du groupe (anomaly detection, mises à jour de OneAgent). Pour les cinquante serveurs de recette du début : une règle disque dédiée au host group rec_paiement, et le global reste intact. Les autres leviers contre le bruit sont détaillés dans faux positifs Dynatrace Managed.
Le piège : changer de host group en production
Changer l’affectation recalcule les identifiants des process groups, ce qui affecte l’agrégation des données : les process groups et services du host repartent sous de nouvelles entités, et l’historique reste rattaché aux anciennes. Les dashboards, alertes, SLO ou règles qui ciblent un ID d’entité précis ne suivent pas. Avant tout changement en production :
- recensez les configurations qui référencent les process groups ou services concernés ;
- préférez des sélecteurs par tag ou management zone, qui suivent les nouvelles entités ;
- regroupez les changements dans une fenêtre de maintenance, puisque les applications doivent redémarrer.
Comment vérifier que ça fonctionne
- Sur le host :
./oneagentctl --get-host-grouprenvoie le nom attendu. - Dans l’interface : Hosts, sélectionnez le host, Properties and tags : la propriété Host group s’affiche (elle est absente si le host n’a pas de groupe). En SaaS, les host groups apparaissent aussi sur la page Hosts de l’application Infrastructure & Operations.
- Deployment Status > OneAgents, filtre Host group : la liste doit contenir tous les hosts prévus, et aucun autre.
- Après redémarrage des applications, vérifiez que les process groups apparaissent séparés par host group si un même logiciel tourne dans plusieurs groupes.
Bonnes pratiques
- Un host group = un ensemble de hosts qui partagent la même configuration (environnement + rôle).
- Convention de nommage fixée avant le premier déploiement, intégrée aux scripts d’installation et à la DynaKube.
- Propriétaire, équipe, coût : en tags et management zones, pas en host group.
- Aucun host sans host group en production : filtrez régulièrement Deployment Status.
- Changements de host group planifiés, avec inventaire des configurations par ID d’entité.
Questions fréquentes
Un host peut-il appartenir à plusieurs host groups ?
Non, un host appartient à au plus un host group. Pour des regroupements multiples (équipe, application, coût), utilisez des tags et des management zones.
Faut-il créer le host group dans l’interface avant de l’affecter ?
La documentation décrit l’affectation par le paramètre OneAgent (installation, oneagentctl, remote configuration) : le groupe apparaît avec les hosts qui le déclarent. Il n’y a pas d’étape de création distincte décrite.
Host group ou management zone pour séparer recette et production ?
Les deux, pour des raisons différentes. Le host group sépare les process groups et services et porte les réglages techniques ; la management zone filtre la vue, les droits et les alertes. Le host group peut alimenter la règle de la management zone.
Conclusion
Les host groups Dynatrace sont un choix d’architecture plus qu’un paramètre d’installation : ils découpent les process groups, portent les réglages par groupe et nourrissent tags et management zones. Définis tôt, sur le critère « même configuration », ils évitent des seuils globaux de compromis et des alertes inutiles ; changés tard, ils coûtent de l’historique.
Références : Organize your environment using host groups et OneAgent configuration via command-line interface (documentation Managed).
span.observer est un blog indépendant, non affilié à Dynatrace LLC. Dynatrace et OneAgent sont des marques de Dynatrace LLC. Les informations proviennent de la documentation publique ; vérifiez-les sur votre version avant toute modification en production.