Votre équipe a un besoin que aucun écran standard ne couvre : une vue qui croise vos équipes, vos services et une requête DQL maison. La décision d’exploitation est simple à poser : continuer avec un tableau de bord et des captures collées dans un wiki, ou construire une petite application qui vit dans votre environnement. Le Dynatrace App Toolkit est l’outil en ligne de commande qui rend la seconde option abordable. Cet article le prend à l’envers de la documentation : d’abord ce qu’il faut décider avant de coder, puis la boucle minimale pour obtenir une app qui tourne.
Le contenu vaut pour Dynatrace SaaS uniquement (adresses en apps.dynatrace.com) ; Managed n’est pas traité. span.observer n’a pas déployé d’app pour écrire ce texte : les commandes et options viennent de la documentation développeur et du billet de l’éditeur, citées plus bas, et aucune sortie n’est inventée.
Le billet de l’éditeur présente l’App Toolkit 1.0 comme une chaîne d’outils unique : créer, développer et déployer, ajouter des fonctions d’app et mettre à jour les paquets depuis le même binaire, dt-app. Retenez cette idée, elle structure tout le reste.
Dynatrace App Toolkit : faut-il vraiment une app ?
Avant d’ouvrir un terminal, posez trois questions à l’équipe. Elles évitent de maintenir du code pour rien.
- Un dashboard suffit-il ? Si la vue se résume à des tuiles DQL, restez sur un dashboard : zéro code, zéro cycle de déploiement.
- Qui maintient l’app ? Une app a une version, des dépendances et un propriétaire. Nommez-le avant la première ligne de code, comme pour n’importe quel service.
- Quelles données lira-t-elle ? Les
scopesde l’app sont déclarés dans sa configuration : moins vous en demandez, plus la revue de sécurité sera courte.
Si la réponse penche vers l’app (interface sur mesure, navigation, logique de présentation), passez à la mise en route. Pour la partie requêtes de vos futures pages, l’article sur les techniques DQL avancées sert de base.
Prérequis à vérifier avant de lancer la commande
La page de l’App Toolkit liste des exigences précises. Les voici, telles que lues dans la documentation :
- Node.js 24 installé en local (
node --versionpour contrôler) ; - l’adresse de votre environnement, de la forme
https://{identifiant}.apps.dynatrace.com/, copiable depuis la barre d’adresse du navigateur ; - un accès réseau à
dt-cdn.net,registry.npmjs.org, votre environnement etgithub.com(pour les modèles) ; - des ports libres : 3000 à 3005 pour le serveur de développement, 30000 pour l’exécution locale des fonctions d’app, 5343 pour l’authentification SSO (le toolkit essaie le port suivant s’il est occupé).
Sur un poste d’entreprise, la ligne réseau est celle qui échoue en premier : demandez l’ouverture des quatre hôtes avant de perdre une heure sur une erreur d’installation.
Créer l’app : la boucle minimale
La documentation « First app in 5 minutes » propose ce parcours. Les étapes sont dans l’ordre où je les exécuterais.
- Dans le terminal de votre éditeur, lancez
npx dt-app@latest create. - Donnez un nom à l’app, par exemple
my-first-app, puis saisissez l’adresse de l’environnement (la commande peut la préremplir si vous êtes déjà connecté). - Entrez dans le dossier :
cd my-first-app. - Démarrez le serveur local :
npx dt-app dev. L’app s’ouvre dans le navigateur. - Ouvrez
ui/app/pages/Home.tsx, changez le texte de l’élémentHeadingen « My first app » et enregistrez : le navigateur se met à jour seul.

Cette capture est un assemblage de commandes issues de la documentation, pas une session enregistrée. Notez le détail du navigateur : la documentation indique que Chrome 142 ou plus récent demande l’autorisation de se connecter aux appareils du réseau local ; si la page reste blanche, regardez d’abord cette invite.
Ce que le billet de l’éditeur met en avant, c’est la vitesse de la boucle. Il annonce une reconstruction qui passe d’environ 2,7 secondes à 0,05 seconde grâce à la détection des changements (seuls les composants modifiés sont reconstruits et vérifiés), et une vérification de types incrémentale qui ne reprend que les fichiers modifiés et leurs dépendances. Ces chiffres sont ceux de l’éditeur ; span.observer ne les a pas mesurés.
Lire le dossier créé et la configuration
La version 1.x du toolkit sépare l’interface des fonctions d’app. Le workspace décrit dans la documentation ressemble à ceci :

Le fichier à connaître est app.config.json (ou app.config.ts). Au niveau supérieur, environmentUrl est obligatoire. Sous app, la documentation exige id (en minuscules, espace de noms séparé par des points), name, version, description et scopes.

L’exemple ci-dessus est construit à partir des champs documentés, avec des valeurs fictives : l’identifiant d’environnement abc12345 n’existe pas et vos scopes dépendent de ce que l’app lira. Le champ version mérite une règle d’équipe : incrémentez-le à chaque déploiement, c’est votre repère de retour arrière.
Déployer sans surprise : dry-run, puis déploiement
Le serveur de développement ne partage rien. Pour que vos collègues voient l’app, il faut la déployer. La commande npx dt-app deploy construit puis déploie dans l’environnement configuré. Deux options utiles, d’après la documentation :
--dry-runcrée une archive.zipdistribuable dansout/sans déployer : c’est le contrôle à faire avant une première mise en production ;--skip-buildréutilise une construction existante, pratique quand un pipeline a déjà construit l’app.
Pour retirer l’app, dt-app uninstall existe aussi, avec son propre --dry-run. Ce que la documentation consultée ne détaille pas : le déroulé exact de l’authentification interactive et ce qui s’affiche dans l’environnement après le déploiement. Je ne le décris donc pas ; suivez le guide « deploy your app » du site développeur.
Automatiser : la partie qui compte pour l’astreinte
Le billet insiste sur un point utile aux équipes SRE : toutes les commandes peuvent tourner dans des scripts ou des pipelines, avec arguments et options en ligne de commande au lieu de questions interactives. La documentation donne les leviers : l’option --non-interactive, et des variables d’environnement. DT_APP_PLATFORM_TOKEN saute le flux d’authentification par défaut ; DT_APP_OAUTH_CLIENT_ID et DT_APP_OAUTH_CLIENT_SECRET automatisent la récupération du jeton SSO, ce qui sert en intégration continue. Ces secrets ne doivent jamais entrer dans le dépôt : placez-les dans le coffre de votre outil de CI.
Deux autres commandes de maintenance : dt-app update met à jour les paquets, et dt-app migration execute accompagne le passage d’une version à l’autre (options --from et --to). Planifiez une mise à jour par trimestre plutôt qu’en urgence. Si vous gérez déjà votre plateforme en code, la logique rejoint celle de Terraform pour les alertes et dashboards : l’app devient un artefact versionné comme les autres. Et pour comprendre comment les données de vos pages sont identifiées, voyez l’article sur l’identifiant d’entité.
Bonnes pratiques
- Un propriétaire nommé et un dépôt par app, avec revue de code comme pour tout service.
- Des
scopesminimaux, relus à chaque nouvelle page. - Un
deploy --dry-runavant toute mise en production, et laversionincrémentée. - Des secrets de CI hors du dépôt ; l’option
DT_APP_DISABLE_TELEMETRY=1existe si votre politique interdit la télémétrie du toolkit. - Commencer par une page simple qui lit une seule requête DQL, puis étendre.
Questions fréquentes
Quelle version de Node.js faut-il pour le Dynatrace App Toolkit ?
La documentation indique Node.js 24. Contrôlez-la avec node --version avant de lancer npx dt-app@latest create.
Le toolkit fonctionne-t-il avec Dynatrace Managed ?
Les sources consultées parlent d’environnements en apps.dynatrace.com, donc SaaS. Rien n’a été vérifié pour Managed : cet article ne l’affirme pas.
Peut-on lancer les commandes en CI sans interaction ?
Oui, selon la documentation : l’option --non-interactive et les variables DT_APP_OAUTH_CLIENT_ID et DT_APP_OAUTH_CLIENT_SECRET sont prévues pour ce cas. Testez d’abord avec --dry-run.
Conclusion
Construire une app Dynatrace est une décision de maintenance avant d’être une décision technique. Si la réponse est oui, la boucle create, dev, deploy --dry-run, deploy tient en cinq commandes. Pour le détail officiel, lisez le billet de l’éditeur sur l’App Toolkit 1.0 et la documentation développeur.
span.observer est un blog indépendant de la communauté, non affilié à Dynatrace LLC. Les marques citées appartiennent à leurs propriétaires. Les outils évoluent vite : vérifiez les commandes et options dans la documentation officielle.