dtwiz Dynatrace : installer et superviser un hôte en ligne de commande

dtwiz Dynatrace : installer la collecte et superviser un hôte en ligne de commande, avec QuickStart renouvelé et hôtes OpenTelemetry en GA.
dtwiz Dynatrace : installer et superviser un hôte en ligne de commande

dtwiz Dynatrace : c’est le nom d’un outil en ligne de commande, publié sur GitHub dans l’organisation dynatrace-oss, qui analyse une machine puis installe la méthode de collecte Dynatrace qui lui convient. La version 1.347 de Dynatrace SaaS (déploiement commencé le 16 septembre 2026) le met en avant dans trois nouveautés : un parcours QuickStart renouvelé, l’ajout de la supervision d’hôte pendant l’installation du collecteur OpenTelemetry, et la disponibilité générale des hôtes OpenTelemetry dans Infrastructure & Operations.

Pour une équipe SRE, l’intérêt est simple : réduire le temps entre « une machine sans supervision » et « les premières métriques d’hôte dans l’outil ». Moins de pas manuels, c’est moins de toil et moins de machines oubliées. Cet article décrit ce que disent les notes de version et le dépôt, lus le 27 octobre 2026, et donne les commandes telles qu’elles figurent dans le README.

Précision d’honnêteté : span.observer est un blog indépendant et n’a ni installé ni lancé dtwiz pour écrire ces lignes. Les captures sont soit des extraits du README rendus à partir de son texte, soit une image du README du dépôt (licence Apache 2.0), soit une page de la documentation officielle. Le périmètre est Dynatrace SaaS : rien de tout cela ne concerne Dynatrace Managed.

dtwiz Dynatrace : ce que dit le dépôt

  • Nature : un outil écrit en Go, appelé « Dynatrace Ingest CLI » dans le README. Il détecte la plateforme, les conteneurs, Kubernetes, les agents déjà présents, le cloud et les services, puis recommande une méthode.
  • Licence : le fichier LICENSE est le texte de l’Apache License 2.0.
  • Maturité : le README parle de « early development » et demande d’ouvrir une issue GitHub en cas de bogue. Je n’ai pas pu lire de numéro de version publié ; l’état du dépôt change vite.
  • Télémétrie vers votre tenant : à chaque commande, dtwiz envoie un évènement CUSTOM_INFO à votre environnement. Ces évènements comptent dans le quota d’ingestion d’évènements, avertit le README.

Les commandes principales listées dans le README : dtwiz setup (parcours interactif analyse, recommandation, installation), dtwiz analyze, dtwiz recommend, dtwiz install (oneagent, kubernetes, otel, otel-collector, otel-java, otel-node, otel-python, demo, aws, aws-lambda, azure, gcp ; docker est marqué expérimental), dtwiz uninstall, dtwiz update, dtwiz watch et dtwiz status.

Ce qui change dans Dynatrace SaaS 1.347

La page « What’s new in Dynatrace SaaS 1.347 » (déploiement du 16 septembre 2026, mise à jour le 6 octobre 2026) contient quatre éléments liés à notre sujet. Ils n’ont pas de date individuelle ; les formulations ci-dessous sont les miennes.

  1. QuickStart : un parcours guidé dtwiz mis à jour, avec les assistants d’intégration manuels regroupés sous « Manual install » et la possibilité d’instrumenter l’application de démonstration Schnitzel via dtwiz setup.
  2. Dynatrace Assist dans QuickStart : explication des résultats par l’IA et recherche dans la topologie pour les services.
  3. Supervision d’hôte avec dtwiz : pendant l’installation du collecteur OpenTelemetry, dtwiz prépare l’extension OpenTelemetry nécessaire et les routes dynamiques OpenPipeline. Selon la note, les métriques d’hôte apparaissent dans Infrastructure & Operations en quelques minutes ; l’accès se fait depuis QuickStart, sous « Add more data ».
  4. Hôtes OpenTelemetry en disponibilité générale : ils figurent dans le menu Compute d’Infrastructure & Operations, au même niveau que OneAgent. Le concept de Datacenter est retiré de l’application ; les Primary Tags servent désormais au regroupement des hôtes.

Le récapitulatif général de la documentation (entrée du 22 septembre 2026) ne contient qu’une ligne de titre qui cite dtwiz : il ne donne aucun détail supplémentaire.

Page de la documentation Dynatrace sur QuickStart : en haut, des tuiles Auto Discovery, OpenTelemetry, Kubernetes, AWS, Azure, GCP, Windows et Linux, au centre le bouton Add data, en bas les sections Access data et Popular integrations
Source : docs.dynatrace.com

Installer dtwiz et superviser un hôte : pas à pas

Prérequis

Le README demande deux variables d’environnement : DT_ENVIRONMENT (l’URL de votre environnement) et DT_PLATFORM_TOKEN (un jeton de plateforme, préfixe dt0s16.). Il recommande de générer ce jeton depuis l’application QuickStart de votre tenant, chemin testé qui crée les portées nécessaires. Si vous le créez à la main, le README fournit une liste de portées (acquisition de données, extensions, fleet management, OpenPipeline, Settings, Storage…) qu’il décrit comme une base pratique, pas toujours entièrement nécessaire. Un jeton Classic (dt0c01.) n’est utilisé que si vous passez explicitement --access-token.

Étape 1 — Installer et lancer

Commandes du README pour Linux et macOS (bash ou zsh) :

export DT_ENVIRONMENT="https://<your-tenant-domain>"
export DT_PLATFORM_TOKEN="dt0s16.XXXX..."
source <(curl -sSL https://raw.githubusercontent.com/dynatrace-oss/dtwiz/main/scripts/install.sh)
dtwiz setup

La première ligne exporte l’adresse du tenant, la deuxième le jeton, la troisième télécharge et exécute le script d’installation dans le shell courant (source rend dtwiz disponible sans ouvrir un autre terminal), la quatrième lance le parcours interactif. Lisez le script avant de l’exécuter : c’est une règle valable pour tout curl | source. Sous Windows, le README donne la variante PowerShell avec install.ps1.

Terminal montrant les commandes du démarrage rapide du README de dtwiz : deux export de variables d'environnement, le téléchargement du script install.sh, puis dtwiz setup

Étape 2 — Analyser, recommander, installer

Si vous préférez décomposer, le README décrit le même enchaînement en commandes séparées :

dtwiz analyze
dtwiz recommend
dtwiz install kubernetes
dtwiz status

Pour un hôte, la cible est dtwiz install oneagent (OneAgent sur cette machine) ou dtwiz install otel-collector (le collecteur OpenTelemetry de Dynatrace seul). La note 1.347 relie l’onboarding d’hôte à l’installation du collecteur OpenTelemetry ; le nom exact de la sous-commande qui déclenche cette préparation n’est pas indiqué par la note, donc vérifiez le comportement dans l’assistant de dtwiz setup. Deux options utiles : --yes (ou -y) saute les confirmations, et --json sur analyze et recommend produit une sortie structurée pour un script.

Étape 3 — Suivre l’arrivée des données

dtwiz watch surveille en direct les données qui arrivent dans Dynatrace (services, journaux, traces…). L’image du README ci-dessous provient d’une démonstration de l’application Schnitzel instrumentée par dtwiz : elle liste les services, les relations, les logs et les requêtes détectés.

Capture d'écran du README de dtwiz : la commande dtwiz watch affiche 4 services Schnitzel, des journaux et des requêtes détectés dans Dynatrace, avec un lien Open Dynatrace QuickStart

Comment vérifier que ça fonctionne

  1. Dans le terminal, dtwiz status affiche l’état de la connexion et du système ; dtwiz watch montre les données reçues.
  2. Dans Dynatrace, ouvrez Infrastructure & Operations, menu Compute : l’hôte doit y apparaître au bout de quelques minutes d’après la note 1.347.
  3. Interrogez l’auto-surveillance de dtwiz dans Notebooks ou Dashboards. Requête donnée par le README :
fetch events
| filter event.type == "CUSTOM_INFO" and startsWith(event.name, "dtwiz")
| fields timestamp, event.name, step, command, subcommand, error, version, os
| sort timestamp desc
| limit 100

Le champ step prend les valeurs invoked, install, completed, failed ou cancelled, et error une catégorie comme auth_error ou dependency_missing, ce qui aide à diagnostiquer un échec sans relire tout le terminal.

Requête DQL du README de dtwiz : fetch events, filtre sur CUSTOM_INFO et les noms commençant par dtwiz, champs timestamp, event.name, step, command, subcommand, error, version et os, tri décroissant, limite à 100

OneAgent ou OpenTelemetry pour un hôte ?

Avec la disponibilité générale, les deux méthodes ont leur place dans le même écran. OneAgent reste décrit par la documentation d’installation de OneAgent sur Linux (côté Managed dans notre article) et dtwiz sait aussi l’installer. L’option OpenTelemetry convient si vous standardisez déjà vos collecteurs ; pour les concepts, voir OpenTelemetry de bout en bout avec Dynatrace et le collecteur OpenTelemetry pour Dynatrace.

Pour replacer l’outil dans une démarche complète, suivez le parcours de formation Dynatrace SaaS.

Limites et points à surveiller

  • Projet en développement actif : relisez le README avant chaque usage, la liste de commandes évolue.
  • Le jeton de plateforme donne de larges portées : réservez-le à un compte dédié, ne le collez jamais dans une capture ou un journal.
  • Chaque commande génère un évènement dans votre tenant : prévoyez-le dans votre budget d’ingestion si vous automatisez.
  • Les notes de version ne disent pas quels systèmes d’exploitation couvre la préparation d’hôte OpenTelemetry ; consultez la documentation de votre version.

Bonnes pratiques

  • Testez d’abord sur une machine jetable avant un parc entier.
  • Utilisez dtwiz analyze --json pour documenter l’existant avant d’installer.
  • Gardez --yes pour les scripts relus, pas pour la première exécution.
  • Après l’installation, vérifiez les hôtes dans Infrastructure & Operations plutôt que de vous fier au seul terminal.

Questions fréquentes

dtwiz est-il un produit supporté par Dynatrace ?

Le dépôt est dans l’organisation dynatrace-oss et se présente comme en développement précoce, avec les problèmes à signaler sur GitHub. La page QuickStart de la documentation le mentionne et renvoie vers ce dépôt. Pour l’engagement de support, consultez votre contrat.

dtwiz fonctionne-t-il avec Dynatrace Managed ?

Les sources lues décrivent un tenant SaaS (URL d’environnement, jeton de plateforme, QuickStart, Infrastructure & Operations). Rien n’y indique un usage avec Managed.

Que signifie « hôtes OpenTelemetry en disponibilité générale » ?

Selon la note 1.347, la supervision d’hôte par OpenTelemetry est disponible en version générale et visible dans le menu Compute d’Infrastructure & Operations, comme OneAgent. Les Primary Tags remplacent le concept de Datacenter pour regrouper les hôtes.

Conclusion

dtwiz raccourcit le chemin entre une machine nue et des données dans Dynatrace, et la version 1.347 le relie à QuickStart et aux hôtes OpenTelemetry. Gardez l’esprit SRE : vérifiez l’hôte dans l’application, limitez les droits du jeton et lisez les scripts avant de les lancer. Sources : notes de version SaaS 1.347, dépôt dynatrace-oss/dtwiz (README, LICENSE) et guide QuickStart, lus le 27 octobre 2026.

span.observer est un blog indépendant de la communauté, non affilié à Dynatrace LLC. Dynatrace est une marque de Dynatrace LLC. Les fonctionnalités SaaS évoluent vite : vérifiez leur disponibilité dans votre environnement et dans la documentation officielle.

Total
0
Shares
Laisser un commentaire

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

Previous Post
Dynatrace Assist agentique : ce qu'il fait, ce qu'il ne fait pas

Dynatrace Assist agentique : ce qu’il fait, ce qu’il ne fait pas

Next Post
Rachat Arize Dynatrace finalisé : ce que ça change pour l'observabilité de l'IA

Rachat Arize Dynatrace finalisé : ce que ça change pour l’observabilité de l’IA

Related Posts