Parcours : Dynatrace SaaS · Module 2/8 — déployer OneAgent et Dynatrace Operator · Durée : ~60 min · Niveau : Débutant
Objectifs :
- Comprendre ce que collecte OneAgent et les modes de supervision disponibles.
- Installer OneAgent sur un hôte Linux de test et vérifier son arrivée dans l’environnement.
- Déployer Dynatrace Operator sur Kubernetes avec une ressource DynaKube.
- Savoir diagnostiquer les échecs de déploiement les plus courants.
Prérequis : module 1, une machine Linux de test avec droits root, un cluster Kubernetes de test et kubectl, Helm recommandé.
Un environnement Dynatrace sans données ne montre rien. Ce module explique comment déployer OneAgent et Dynatrace Operator, les deux moyens principaux de collecte automatique : OneAgent pour les hôtes classiques, l’Operator pour les clusters Kubernetes. Il s’inscrit dans le parcours de formation Dynatrace SaaS et prépare les modules d’analyse qui suivent.
L’objectif n’est pas de couvrir toutes les options d’installation, très nombreuses, mais de réussir un premier déploiement propre et de comprendre ce qui se passe.
Que fait OneAgent ?
OneAgent est un agent installé une seule fois par hôte. Il découvre automatiquement les processus, injecte une instrumentation dans les technologies prises en charge (Java, .NET, Node.js, PHP, Go, serveurs web…) et remonte vers l’environnement des métriques, des traces distribuées, des logs et la topologie. Il n’est pas nécessaire de modifier le code de l’application pour obtenir les traces des technologies supportées.
OneAgent peut fonctionner selon plusieurs niveaux de supervision. Les noms exacts varient selon les versions, mais l’idée reste la même :
| Niveau | Ce qui est collecté | Cas d’usage |
|---|---|---|
| Full-stack | Infrastructure, processus, traces applicatives, logs | Serveurs d’applications à superviser en profondeur |
| Infrastructure | Hôte, processus, réseau, sans instrumentation applicative | Bases de données, serveurs d’infrastructure |
| Découverte | Inventaire et métriques de base | Couverture large à faible coût |
Le niveau a un impact direct sur la consommation de licence : choisissez-le hôte par hôte, en fonction de la valeur attendue.
Le rôle de l’ActiveGate
OneAgent peut envoyer ses données directement à l’environnement SaaS. Un ActiveGate devient utile quand les hôtes n’ont pas d’accès Internet direct (il sert alors de relais), ou pour certaines intégrations qui interrogent des API distantes. Sur Kubernetes, l’Operator déploie lui-même un ActiveGate, notamment pour superviser l’API du cluster.
Comment déployer OneAgent sur un hôte Linux ?
Le déploiement se lance depuis l’environnement : cherchez l’assistant de déploiement de OneAgent (via la recherche « Deploy OneAgent » ou l’application d’infrastructure). Il génère une commande de téléchargement contenant l’adresse de l’environnement et un jeton d’installation. Copiez-la telle quelle : ne fabriquez pas l’URL à la main.
L’installation elle-même ressemble à ceci, une fois l’installeur téléchargé :
sudo /bin/sh Dynatrace-OneAgent-Linux-<version>.sh --set-host-group=formation-saas
Le paramètre --set-host-group rattache l’hôte à un groupe d’hôtes, pratique pour appliquer des réglages communs et filtrer plus tard. Après l’installation, les processus déjà en cours ne sont pas instrumentés : redémarrez les applications pour qu’elles soient tracées.
Pour vérifier l’état local de l’agent, l’outil en ligne de commande oneagentctl est installé avec OneAgent :
sudo /opt/dynatrace/oneagent/agent/tools/oneagentctl --get-host-group
Si vous avez déjà installé OneAgent dans un contexte Managed, la logique est proche ; l’article Déployer OneAgent sur Linux en Managed détaille les options silencieuses. Seule la cible change : ici, l’environnement SaaS.
Déployer OneAgent et Dynatrace Operator sur Kubernetes
Sur Kubernetes, on n’installe pas OneAgent nœud par nœud. On déploie Dynatrace Operator, un opérateur Kubernetes qui lit une ressource personnalisée appelée DynaKube et crée lui-même les composants nécessaires : OneAgent, ActiveGate, injection dans les pods.
Choisir un mode de déploiement
- Cloud-native full-stack : supervision de l’infrastructure des nœuds et injection de l’instrumentation dans les pods applicatifs. C’est le mode le plus complet et le plus courant.
- Application monitoring : injection dans les pods sans supervision de l’hôte, utile quand vous n’avez pas la main sur les nœuds.
- Host monitoring : supervision des nœuds uniquement.
Les étapes
Le plus simple est de suivre l’assistant de l’application Kubernetes, qui génère les jetons et un fichier dynakube.yaml adapté. Deux jetons sont en général nécessaires : un pour l’Operator, un pour l’ingestion de données. L’installation de l’Operator avec Helm prend la forme suivante :
helm install dynatrace-operator oci://public.ecr.aws/dynatrace/dynatrace-operator \
--create-namespace --namespace dynatrace --atomic
Avec Helm 4.0 ou plus, remplacez --atomic par --rollback-on-failure.
Puis on applique la ressource DynaKube générée. Sa structure générale ressemble à cet extrait simplifié (la version d’API et les champs exacts dépendent de la version de l’Operator : reprenez ceux du fichier généré) :
apiVersion: dynatrace.com/<version>
kind: DynaKube
metadata:
name: formation
namespace: dynatrace
spec:
apiUrl: https://<environnement>/api
oneAgent:
cloudNativeFullStack: {}
activeGate:
capabilities:
- routing
kubernetesMonitoring: # Operator 1.11.0+
registration: {}
kubectl apply -f dynakube.yaml
kubectl get dynakube -n dynatrace
kubectl get pods -n dynatrace
Comme pour un hôte, les pods applicatifs déjà démarrés doivent être redémarrés pour recevoir l’injection.
Quels sont les pièges les plus fréquents ?
- Applications non instrumentées : elles n’ont pas été redémarrées après l’installation.
- Agent qui ne se connecte pas : un proxy ou un pare-feu bloque la sortie vers l’environnement ; un ActiveGate relais ou un réglage de proxy est nécessaire.
- DynaKube en erreur : jeton invalide, permissions de jeton insuffisantes ou URL d’API incorrecte. Lisez l’état de la ressource et les logs du pod de l’Operator.
- Coût inattendu : full-stack activé partout par défaut. Décidez du mode avant de déployer à grande échelle.
Pour aller au-delà des bases sur Kubernetes, l’article requêtes CPU effectives des pods Kubernetes montre ce qu’on peut tirer des données collectées par l’Operator.
Exercice pratique
Étape 1 — Installer OneAgent sur la machine Linux
Depuis l’assistant de déploiement, téléchargez l’installeur Linux et exécutez-le avec le groupe d’hôtes formation-saas. Démarrez ensuite une petite application (par exemple un serveur web) ou redémarrez celle qui tourne.
Résultat attendu : après quelques minutes, l’hôte apparaît dans l’application d’infrastructure, avec ses processus.
Étape 2 — Vérifier les données dans Grail
Dans un notebook, exécutez :
fetch dt.entity.host
| fields entity.name, id
Résultat attendu : votre hôte apparaît dans la liste.
Étape 3 — Déployer l’Operator
Sur le cluster de test, suivez l’assistant de l’application Kubernetes en mode cloud-native full-stack, installez l’Operator puis appliquez le DynaKube. Vérifiez que les pods du namespace dynatrace passent à l’état Running.
Résultat attendu : le cluster apparaît dans l’application Kubernetes, avec ses nœuds et ses namespaces.
Étape 4 — Observer un workload
Déployez une application de démonstration dans un namespace dédié et redémarrez-la si elle existait déjà. Cherchez son service dans l’application Services.
Résultat attendu : le service est détecté et affiche des requêtes et des temps de réponse.
Quiz
- Pourquoi faut-il redémarrer une application après l’installation de OneAgent ? A) Pour activer la licence B) Pour que l’instrumentation soit injectée dans le processus C) Pour vider le cache DNS D) Ce n’est jamais nécessaire
- Quelle ressource personnalisée configure Dynatrace Operator ? A) OneAgentConfig B) DynaKube C) HostGroup D) ActiveGateSet
- Quel mode Kubernetes combine supervision des nœuds et injection dans les pods ? A) Host monitoring B) Application monitoring C) Cloud-native full-stack D) Découverte
- Dans quel cas un ActiveGate est-il utile pour des hôtes classiques ? A) Toujours, OneAgent ne peut pas envoyer seul B) Quand les hôtes n’ont pas d’accès direct à l’environnement C) Pour installer DQL D) Pour remplacer OneAgent
Corrigé
- B. L’instrumentation est chargée au démarrage du processus ; un processus déjà lancé n’est pas tracé.
- B. L’Operator lit la ressource DynaKube et crée les composants qu’elle décrit.
- C. Le mode cloud-native full-stack supervise les nœuds et injecte l’instrumentation dans les pods.
- B. OneAgent peut envoyer directement ; l’ActiveGate sert de relais quand le réseau l’impose.
Pour aller plus loin
- Requêtes CPU effectives des pods Kubernetes
- Connecter Dynatrace Operator à un cluster Managed, pour comparer les deux contextes
- OpenTelemetry de bout en bout, quand l’instrumentation automatique ne suffit pas
- Documentation officielle : docs.dynatrace.com, sections OneAgent et Kubernetes
← Module 1 : La plateforme Dynatrace SaaS, Grail et concepts clés · Sommaire du parcours · Module 3 : Les fondamentaux de DQL →
Questions fréquentes
Peut-on installer OneAgent sur les nœuds Kubernetes sans l’Operator ?
C’est techniquement possible dans certains cas, mais l’Operator est la méthode recommandée : il gère les mises à jour, l’injection dans les pods et l’ActiveGate de façon déclarative.
Combien de temps faut-il pour voir les premières données ?
Quelques minutes en général après le démarrage de l’agent. Si rien n’apparaît au bout d’un quart d’heure, vérifiez la connectivité réseau et l’état de l’agent avec oneagentctl ou l’état du DynaKube.
Faut-il un jeton différent pour chaque cluster ?
Ce n’est pas obligatoire, mais c’est une bonne pratique : des jetons distincts limitent l’impact d’une fuite et facilitent leur rotation.
Votre environnement reçoit désormais des données d’un hôte et d’un cluster. Place à l’apprentissage du langage qui permet de les interroger.
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.
3 comments