Module 2 — Déployer OneAgent et Dynatrace Operator sur hôtes et Kubernetes

Déployer OneAgent sur Linux et Dynatrace Operator sur Kubernetes avec DynaKube : modes de supervision, étapes, pièges courants, exercice et quiz.
Module 2 — Déployer OneAgent et Dynatrace Operator sur hôtes et Kubernetes

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

  1. 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
  2. Quelle ressource personnalisée configure Dynatrace Operator ? A) OneAgentConfig B) DynaKube C) HostGroup D) ActiveGateSet
  3. 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
  4. 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é

  1. B. L’instrumentation est chargée au démarrage du processus ; un processus déjà lancé n’est pas tracé.
  2. B. L’Operator lit la ressource DynaKube et crée les composants qu’elle décrit.
  3. C. Le mode cloud-native full-stack supervise les nœuds et injecte l’instrumentation dans les pods.
  4. B. OneAgent peut envoyer directement ; l’ActiveGate sert de relais quand le réseau l’impose.

Pour aller plus loin

← 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.

Total
0
Shares
3 comments
Laisser un commentaire

Votre adresse e-mail ne sera pas publiée. Les champs obligatoires sont indiqués avec *

Previous Post
Module 1 — Plateforme Grail : Dynatrace SaaS, ses apps et ses concepts clés

Module 1 — Plateforme Grail : Dynatrace SaaS, ses apps et ses concepts clés

Next Post
Module 3 — Les fondamentaux de DQL : fetch, filter, summarize et timeseries

Module 3 — DQL : fondamentaux de fetch, filter, des agrégations et de timeseries

Related Posts