Dynatrace App Toolkit : créer sa première app pas à pas

Dynatrace App Toolkit : prérequis, création avec dt-app, serveur local et déploiement. Décidez, démarrez et automatisez votre première app.
Dynatrace App Toolkit : créer sa première app pas à pas

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 scopes de 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 --version pour 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 et github.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.

  1. Dans le terminal de votre éditeur, lancez npx dt-app@latest create.
  2. 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é).
  3. Entrez dans le dossier : cd my-first-app.
  4. Démarrez le serveur local : npx dt-app dev. L’app s’ouvre dans le navigateur.
  5. Ouvrez ui/app/pages/Home.tsx, changez le texte de l’élément Heading en « My first app » et enregistrez : le navigateur se met à jour seul.
Terminal listant les commandes dt-app : node --version, create, cd, dev, deploy --dry-run puis deploy

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 :

Arborescence d'un workspace App Toolkit 1.x : dossier ui avec main.tsx et tsconfig.json, dossier documents, fichier app.config.json et dossier .dt-app/logs

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.

Exemple de fichier app.config.json avec environmentUrl, puis app contenant id, name, version, description et scopes vides

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-run crée une archive .zip distribuable dans out/ sans déployer : c’est le contrôle à faire avant une première mise en production ;
  • --skip-build ré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 scopes minimaux, relus à chaque nouvelle page.
  • Un deploy --dry-run avant toute mise en production, et la version incrémentée.
  • Des secrets de CI hors du dépôt ; l’option DT_APP_DISABLE_TELEMETRY=1 existe 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.

Total
0
Shares
Laisser un commentaire

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

Previous Post
Ownership Dynatrace : router chaque alerte vers la bonne équipe

Ownership Dynatrace : router chaque alerte vers la bonne équipe

Related Posts