Comment installer et configurer OneAgent Dynatrace sur Linux ?

La commande d’installation dépend de l’architecture choisie et de la compatibilité de l’OS. Une validation préalable évite d’installer un agent non supporté.

1. Connectez-vous à la machine via votre accès d’exploitation habituel. Relevez la distribution, la version du noyau et l’architecture.
2. Comparez ces informations aux technologies prises en charge par OneAgent. Vérifiez aussi l’espace disque disponible sous /opt et la politique de redémarrage.
3. Confirmez qui détient l’autorisation d’utiliser sudo : l’installation modifie des composants du système et ne doit pas être lancée sans accord.

cat /etc/os-release
uname -m
uname -r
df -h /opt

Un mode de supervision adapté évite les attentes irréalistes : la visibilité infrastructure n’est pas équivalente à l’instrumentation applicative Full-Stack.

1. Ouvrez Discovery & Coverage, puis Install > Install OneAgent. Choisissez Linux et l’architecture du serveur.
2. Comparez Full-Stack, Infrastructure et Discovery selon le périmètre et la licence. Choisissez le niveau nécessaire plutôt que l’option la plus large par défaut.
3. Si vous segmentez les hôtes, préparez host group, zone réseau et tags cohérents avec votre organisation de production.

Dynatrace associe l’installateur à votre environnement. Copier une commande trouvée sur Internet peut orienter les données vers une mauvaise destination.

1. Dans le panneau d’installation, utilisez Installer download token ou Generate token pour disposer d’un jeton au périmètre InstallerDownload.
2. Copiez uniquement la commande de téléchargement générée par votre propre environnement. Ne la collez pas dans un document public : elle peut contenir un secret.
3. Sur le serveur, vérifiez la résolution DNS et la connectivité TLS vers l’adresse autorisée. En présence d’un proxy, vérifiez son paramétrage réseau.

getent hosts <votre-domaine-dynatrace>
# Utilisez ensuite uniquement la commande de téléchargement
# affichée dans votre environnement Dynatrace.

Un téléchargement réussi ne prouve pas à lui seul l’intégrité du fichier. La vérification de signature fait partie du parcours officiel.

1. Dans la section Verify signature de la page OneAgent, copiez la commande fournie par Dynatrace après le téléchargement.
2. Exécutez exactement cette commande sur l’hôte cible puis contrôlez que l’opération réussit ; si elle échoue, arrêtez la procédure.
3. Contrôlez vos bibliothèques TLS et vos autorités de certification si le téléchargement ou la vérification échoue.

L’installation agit sur l’hôte : elle déploie les composants OneAgent et les services système associés.

1. Exécutez la commande d’installation fournie par votre console. Pour une machine Ubuntu avec sudo, la forme est indiquée ci-dessous ; le nom réel du fichier varie selon la version téléchargée.
2. Attendez la fin du script, lisez les messages finaux et relevez toute erreur relative à l’accès réseau ou aux privilèges.
3. Ne forcez pas l’installation en mode privilégié sans avoir examiné les exigences du noyau et la politique de sécurité.

sudo /bin/sh ./Dynatrace-OneAgent-Linux-<version>.sh
# Remplacez <version> par le NOM REEL du fichier téléchargé.

Le bon critère de succès n’est pas seulement la fin du script : la plateforme doit recevoir des signaux correspondant au mode de surveillance choisi.

1. Dans Dynatrace, ouvrez la vue des hôtes ou le statut du déploiement et recherchez le nom du serveur.
2. Contrôlez l’état de connexion, les métriques CPU/mémoire et la visibilité des processus selon le mode sélectionné.
3. Si vous attendez des traces applicatives Full-Stack, vérifiez la nécessité de redémarrer les services applicatifs dans une fenêtre de maintenance.

ls -ld /opt/dynatrace/oneagent
# Dans Dynatrace : vérifier l’hôte et la présence de métriques.