Module 3 du parcours Dynatrace Managed — OneAgent, ActiveGate : installer l’agent sur un hôte et choisir le bon type d’ActiveGate Dynatrace.
Parcours : Dynatrace Managed · Module 3/8 · Durée : ~45 min · Niveau : Débutant
Objectifs :
- Installer OneAgent sur un hôte Linux et vérifier sa connexion
- Choisir le mode de surveillance et le groupe d’hôtes
- Comprendre quand un ActiveGate est nécessaire et lequel choisir
- Connaître les options pour Windows et Kubernetes
Prérequis : module 2 ; un cluster ou un environnement de recette ; une VM Linux à surveiller.
Un cluster sans agents ne montre rien. Ce module vous apprend à déployer OneAgent et ActiveGate dans un environnement Dynatrace Managed : installation de l’agent sur un hôte, réglages à décider dès le départ, puis rôle des ActiveGates et choix entre leurs deux variantes propres à Managed.
OneAgent, ActiveGate : commencer par l’agent sur Linux
Dans l’environnement, l’écran de déploiement de OneAgent génère pour vous la commande de téléchargement et le jeton nécessaire. Sur le fond, la commande ressemble à ceci :
wget -O Dynatrace-OneAgent-Linux.sh \
"https://{votre-domaine}/e/{id-environnement}/api/v1/deployment/installer/agent/unix/default/latest?arch=x86" \
--header="Authorization: Api-Token {jeton}"
sudo /bin/sh Dynatrace-OneAgent-Linux.sh \
--set-monitoring-mode=fullstack \
--set-host-group=recette-commandes
Trois points d’attention :
- Le jeton donne le droit de télécharger l’installateur. Utilisez celui que génère l’écran de déploiement, ne le stockez pas en clair dans un dépôt et notez sa date d’expiration.
- Le mode de surveillance : full-stack active la surveillance approfondie des processus (traces, services) ; un mode limité à l’infrastructure existe pour les hôtes où seules les métriques système vous intéressent. Ce choix a un impact sur la consommation de licence.
- Le groupe d’hôtes (
--set-host-group) regroupe des hôtes qui jouent le même rôle. Il influence la façon dont Dynatrace regroupe les processus et sert de base aux règles de tags du module 6. Décidez d’une convention de nommage avant de déployer à grande échelle.
Vérifier que l’agent fonctionne
Une fois installé, OneAgent tourne comme un service système. L’outil oneagentctl permet de lire et modifier sa configuration après coup :
systemctl status oneagent
sudo /opt/dynatrace/oneagent/agent/tools/oneagentctl --get-server
sudo /opt/dynatrace/oneagent/agent/tools/oneagentctl --get-host-group
Dans l’interface, l’hôte apparaît en quelques minutes dans la liste des hôtes. Les processus démarrés avant l’installation sont visibles mais pas instrumentés : redémarrez-les (serveur d’applications, serveur web) pour voir apparaître leurs services et leurs traces. C’est l’erreur de débutant la plus fréquente.
Le détail des options, des cas proxy et des déploiements à grande échelle est traité dans Déployer OneAgent sur Linux dans un environnement Managed.
Windows et Kubernetes
Sur Windows Server, l’installateur s’utilise en mode graphique ou silencieux avec des paramètres équivalents ; voir Installer OneAgent sur Windows Server en mode silencieux. Sur Kubernetes et OpenShift, on ne l’installe pas nœud par nœud : Dynatrace Operator et une ressource DynaKube pointant vers https://{votre-domaine}/e/{id-environnement}/api se chargent du déploiement, comme l’explique Kubernetes et OpenShift : connecter Dynatrace Operator à un cluster Managed.
Qu’est-ce qu’un ActiveGate et quand en a-t-on besoin ?
Un ActiveGate est un composant Java installé sur une machine dédiée, qui sert d’intermédiaire entre des sources de données et le cluster. Il écoute par défaut sur le port 9999. On en a besoin dans plusieurs situations :
- les OneAgent sont dans un réseau qui ne peut pas joindre directement le cluster (DMZ, autre site) : l’ActiveGate concentre et relaie leur trafic ;
- on veut surveiller des ressources sans agent : plateformes cloud, extensions à distance, équipements interrogés par API ;
- on veut exécuter des tests synthétiques depuis un emplacement privé ;
- on veut limiter le nombre de flux qui traversent un pare-feu.
Environment ActiveGate ou Cluster ActiveGate ?
Managed distingue deux types d’ActiveGate :
| Environment ActiveGate | Cluster ActiveGate | |
|---|---|---|
| Rattachement | Un environnement précis | Le cluster entier |
| Usages typiques | Routage des agents d’un réseau, extensions, surveillance cloud | Accès depuis l’extérieur (agents hors réseau, données RUM venues d’internet), emplacements Synthetic privés |
| Installé depuis | L’interface de l’environnement | La Cluster Management Console |
En pratique : commencez par un Environment ActiveGate pour vos besoins internes, et réservez le Cluster ActiveGate aux flux qui viennent de l’extérieur du réseau du cluster. La liste exacte des fonctions de chaque type évolue avec les versions ; l’article ActiveGate en Managed : Environment ActiveGate ou Cluster ActiveGate ? détaille les critères.
Les network zones
Quand plusieurs ActiveGates existent sur plusieurs sites, l’option --set-network-zone de OneAgent indique à l’agent quelle zone réseau privilégier. Les agents d’un datacenter passent ainsi par les ActiveGates de ce datacenter. Inutile pour un premier test, utile dès que l’infrastructure est répartie.
ActiveGate Dynatrace : exigences, ports, groupes et logs
Avant d’installer un ActiveGate Dynatrace en Managed, qu’il s’agisse d’un Environment ou d’un Cluster ActiveGate, vérifiez ces points de la documentation Managed :
- Exigences matérielles (ActiveGate de routage et de supervision sous Linux) : une machine dédiée, 2 Go de RAM (4 Go recommandés), un processeur double cœur et 4 Go d’espace disque libre pour l’installation, la configuration et les logs. Les ActiveGates Synthetic et ceux qui portent le module zRemote demandent davantage et ont leurs propres pages d’exigences.
- Systèmes et versions : la liste des distributions Linux prises en charge (Amazon Linux, Oracle Linux, Red Hat Enterprise Linux, etc.) et de leurs versions évolue ; consultez-la avant chaque installation.
- Ports : un Environment ActiveGate comme un Cluster ActiveGate reçoit les connexions sur le port 9999 ; l’ActiveGate intégré au cluster Managed les reçoit sur le port 443. Le 9999 est la valeur par défaut du paramètre
port-sslde la section[com.compuware.apm.webserver]. - Groupes : un ActiveGate appartient à un seul groupe,
defaultsinon. On l’assigne à l’installation avec--set-group=mon-groupe, ou ensuite avecagctl group set mon-groupe(ActiveGate 1.333+) ou la clégroupde la section[collector]decustom.properties, puis un redémarrage. Un ActiveGate qui exécute une extension distante doit appartenir à un groupe. - Configuration et logs : les réglages personnalisés vont dans
custom.properties, qui prime surconfig.propertieset est conservé lors des mises à jour ; sous Linux, les logs sont dans/var/log/dynatrace/gateway(1,2 Go prévus).
Exercice pratique
Étape 1 — Installer OneAgent
Depuis l’écran de déploiement de votre environnement de recette, copiez la commande Linux, ajoutez un groupe d’hôtes de votre choix et exécutez-la sur une VM. Résultat attendu : le service oneagent actif et l’hôte visible dans la liste des hôtes avec son groupe.
Étape 2 — Instrumenter une application
Installez un serveur web simple (nginx ou Apache) ou démarrez une application Java de démonstration, puis redémarrez-la. Générez du trafic avec curl en boucle. Résultat attendu : un service web apparaît, avec des requêtes et des temps de réponse.
Étape 3 — Lire la configuration
Utilisez oneagentctl --get-server et --get-host-group. Résultat attendu : l’adresse du cluster ou de l’ActiveGate utilisé, et le groupe défini à l’étape 1.
Étape 4 — Concevoir le placement des ActiveGates
Sur papier, dessinez votre réseau réel (sites, DMZ, accès internet) et placez les ActiveGates nécessaires en précisant leur type. Résultat attendu : un schéma justifiant chaque ActiveGate par un flux précis.
Quiz
- Pourquoi un service n’apparaît-il pas après l’installation de OneAgent ? a) Le jeton a expiré b) Le processus n’a pas été redémarré c) Il manque un ActiveGate d) Le mode full-stack est désactivé par défaut
- À quoi sert l’option –set-host-group ? a) Choisir le cluster b) Regrouper des hôtes de même rôle c) Définir la zone réseau d) Limiter la licence
- Quel ActiveGate choisir pour recevoir des données venant d’internet ? a) Environment ActiveGate b) Cluster ActiveGate c) Aucun d) Un OneAgent en mode infrastructure
- Comment déploie-t-on OneAgent sur Kubernetes ? a) Sur chaque nœud à la main b) Avec Dynatrace Operator et une ressource DynaKube c) Via la CMC d) Par un ActiveGate
Corrigé
- b) L’injection a lieu au démarrage du processus ; un processus antérieur à l’installation doit être redémarré.
- b) Le groupe d’hôtes rassemble des hôtes qui jouent le même rôle et sert aux règles de configuration.
- b) Le Cluster ActiveGate traite les flux externes au réseau du cluster.
- b) L’Operator gère le cycle de vie des agents à partir de la ressource DynaKube.
Pour aller plus loin
- Déployer OneAgent sur Linux dans un environnement Managed
- ActiveGate en Managed : Environment ou Cluster ?
- Connecter Dynatrace Operator à un cluster Managed
- Documentation officielle de Dynatrace Managed (OneAgent et ActiveGate)
← Module 2 : Architecture d’un cluster Managed et installation · Sommaire du parcours · Module 4 : Explorer les données →
Questions fréquentes
Faut-il un ActiveGate pour démarrer ?
Non. Si les hôtes joignent directement le cluster, OneAgent peut s’y connecter sans intermédiaire. L’ActiveGate devient nécessaire pour traverser des zones réseau, surveiller sans agent ou lancer des tests synthétiques privés.
OneAgent redémarre-t-il mes applications ?
Non. L’installation n’arrête aucun processus. C’est à vous de planifier le redémarrage des applications à instrumenter, idéalement dans une fenêtre de maintenance.
Peut-on changer le groupe d’hôtes après l’installation ?
Oui, avec oneagentctl, mais le changement peut modifier le regroupement des processus et donc l’historique des entités. Fixez la convention avant le déploiement massif.
Vos hôtes remontent maintenant des données. Le module 4 vous apprend à les parcourir : des hôtes aux services, jusqu’aux traces PurePath et aux problèmes ouverts par Davis.
span.observer est un blog indépendant de la communauté, non affilié à Dynatrace LLC. Ce parcours ne remplace pas les formations et certifications officielles de Dynatrace University. Vérifiez les fonctionnalités dans la documentation officielle de votre version.
1 comment