Monaco ou Terraform : lequel choisir pour piloter la configuration de Dynatrace par le code ? La question revient dès qu’une équipe plateforme veut sortir des réglages manuels, versionner ses profils d’alerte et reproduire un environnement de préproduction à l’identique. Les deux outils savent le faire. Ils ne répondent pas aux mêmes contraintes.
Ce comparatif s’appuie sur la documentation officielle et les dépôts des deux projets. Il ne prétend rien mesurer : il aide à décider selon vos outils, votre organisation et vos objets à gérer. Pour la mise en œuvre, deux guides détaillent chaque outil : Monaco pas à pas et le provider Terraform.
Périmètre : la configuration d’un environnement Dynatrace. Les pages officielles consultées ne précisent pas toutes la compatibilité SaaS ou Managed de chaque objet ; le point est traité plus bas, avec ce qui est vérifié et ce qui ne l’est pas.
Monaco ou Terraform : ce que dit la documentation Dynatrace
La page « Configuration as Code » de Dynatrace présente les deux outils. Terraform, avec le provider Dynatrace, y est décrit comme l’outil de référence du secteur. Monaco est l’outil en ligne de commande de Dynatrace, qui fonctionne en mode autonome et décrit les configurations en JSON natif.
La recommandation de la page est nette. Terraform convient aux équipes qui le connaissent déjà, à celles qui gèrent plusieurs fournisseurs dans un même espace de travail et à celles qui veulent un état géré à l’extérieur et une configuration dynamique grâce aux expressions HCL. Monaco est l’option quand Terraform ne peut pas être utilisé. Retenez cette hiérarchie : elle vient de l’éditeur, pas de span.observer.
Les deux projets sont publiés sous licence Apache 2.0 (dépôts Dynatrace/dynatrace-configuration-as-code et dynatrace-oss/terraform-provider-dynatrace). Le README du provider indique qu’il est officiellement supporté par Dynatrace.
Le modèle de chaque outil
Monaco : manifeste, projets, YAML et modèles JSON
Monaco repose sur un manifeste de déploiement, qui dit quels projets partent vers quels environnements, et sur des projets qui regroupent les fichiers déployés vers la même cible. Chaque configuration comprend un fichier YAML (paramètres, dépendances, nom) et un modèle JSON qui contient la charge utile de l’API, avec des variables remplacées au déploiement. Le JSON est celui de l’API Dynatrace : si vous connaissez les schémas de l’API, vous lisez le modèle sans effort.
Terraform : HCL, état et plan
Avec Terraform, vous décrivez des ressources en HCL. Le provider dynatrace-oss/dynatrace crée des tableaux de bord, des workflows, des alertes personnalisées, et expose aussi des sources de données, comme l’identifiant d’entité d’un service détecté. Terraform conserve un état, calcule un plan puis l’applique. La documentation Dynatrace cite parmi les bénéfices la limitation des modifications manuelles en production, la synchronisation des environnements, la reconstruction après sinistre et les modules réutilisables.
Comparer Monaco et Terraform sur sept critères
| Critère | Monaco | Terraform (provider Dynatrace) |
|---|---|---|
| Rôle selon la documentation | Outil CLI de Dynatrace, JSON natif, mode autonome | Outil de référence du secteur, recommandé si vous l’utilisez déjà |
| Langage | YAML + modèles JSON | HCL |
| État | Pas d’état externe décrit dans la documentation consultée | État géré à l’extérieur (page Configuration as Code) |
| Validation avant déploiement | deploy --dry-run : structure des fichiers, sans connexion à Dynatrace |
terraform plan : différences calculées avec l’état et l’environnement |
| Partir de l’existant | monaco download |
Export par l’exécutable du provider, un fichier .tf par objet |
| Autres fournisseurs | Non | Oui, dans le même espace de travail |
| Authentification | Jeton, jeton de plateforme ou client OAuth, fournis par noms de variables | Variables DYNATRACE_ENV_URL, DYNATRACE_API_TOKEN, OAuth, jeton de plateforme |
Le --dry-run de Monaco mérite une précision : la documentation indique qu’il ne se connecte pas à Dynatrace, si bien qu’une erreur HTTP 400 peut encore survenir au vrai déploiement. Un terraform plan, lui, interroge l’environnement et détecte la dérive.
Étapes pratiques : tester les deux sur un même objet
Le meilleur arbitrage reste un essai. Prenez un objet simple, par exemple un profil d’alerte, et gérez-le avec chaque outil dans un environnement de test. Cela prend une demi-journée.
- Préparez un environnement de test et un jeton limité aux objets visés. Les scopes dépendent de l’objet : la page du provider liste
settings.read,settings.write,ReadConfig,WriteConfiget d’autres pour le jeton d’accès. - Côté Terraform : déclarez le provider, exportez les variables, initialisez.

- Côté Monaco : téléchargez l’existant, validez à blanc, déployez, puis supprimez avec un fichier
delete.yaml.

- Changez une valeur dans le code et mesurez l’effort : relecture du diff, temps de validation, clarté de l’erreur en cas d’échec.
- Modifiez la même valeur à la main dans l’interface, puis relancez l’outil. Observez comment chacun réagit à la dérive.
Comment vérifier que ça fonctionne
Après un déploiement, ouvrez l’objet dans l’interface Dynatrace : sa valeur doit correspondre au dépôt. Relancez ensuite la même commande : un second terraform plan doit annoncer « No changes », et un second monaco deploy ne doit pas échouer ni dupliquer l’objet. Si vous gérez une même configuration avec les deux outils, vous vous exposez à des conflits : un objet, un seul outil.
SaaS, Managed et objets de plateforme
Le README du provider donne deux formes d’URL : https://########.live.dynatrace.com pour SaaS et https://<dynatrace-host>/e/<id> pour Managed. Les ressources fondées sur OAuth ou sur la plateforme (workflows, documents, SLO récents, buckets) visent l’environnement SaaS ; la page précise aussi que certaines ressources, comme dynatrace_json_dashboard, n’acceptent que les jetons d’API. Pour Monaco, la page des commandes signale que l’option --token concerne uniquement le Dynatrace classique ; les pages consultées ne détaillent pas la prise en charge de Managed objet par objet. Vérifiez donc chaque type dans la documentation de votre version avant de vous engager. Le choix de la plateforme est abordé dans Managed ou SaaS.
Bonnes pratiques
- Un seul outil par objet. Deux outils qui écrivent le même profil se disputent la valeur à chaque exécution.
- Exportez avant d’écrire.
monaco downloadou l’export du provider donne le bon format de départ. - Secrets hors du dépôt. Les deux outils lisent les jetons dans des variables d’environnement.
- Relisez comme du code. Une merge request par changement d’alerte réduit le MTTR : le
git logdit ce qui a changé. - Standardisez. Des modules Terraform ou des projets Monaco par service évitent que chaque équipe réinvente son alerting. L’exemple des SLO avec Terraform montre l’approche.
Questions fréquentes
Faut-il choisir Monaco ou Terraform pour Dynatrace ?
Selon la documentation Dynatrace, Terraform est recommandé si votre équipe le maîtrise, gère plusieurs fournisseurs ou veut un état externe. Monaco est l’option quand Terraform ne peut pas être utilisé.
Peut-on utiliser les deux outils ensemble ?
Techniquement oui, sur des objets différents. Évitez de gérer le même objet par les deux : le dernier déploiement écrase l’autre. Séparez les périmètres par type d’objet ou par équipe.
Comment migrer d’un outil à l’autre ?
Exportez l’existant avec l’outil cible (monaco download ou l’export du provider), comparez avec l’environnement, puis retirez l’ancien outil de la chaîne pour ces objets. Testez d’abord sur un environnement non productif.
Conclusion
Si Terraform est déjà dans votre chaîne, le provider Dynatrace s’y intègre et la documentation le recommande. Sinon, Monaco offre un modèle plus proche de l’API (JSON natif). Dans les deux cas, la valeur vient du processus : code, revue, déploiement automatisé. Faites l’essai sur un objet avant de généraliser, et gardez l’ensemble sous un seul outil par objet. Pour la partie télémétrie, le Collector OpenTelemetry se configure aussi comme du code.
span.observer est un blog indépendant, non affilié à Dynatrace LLC. Dynatrace est une marque de son propriétaire. Sources : Configuration as Code, commandes Monaco et provider Terraform.