Trois SLO créés à la main, c’est gérable. Quatre-vingts services, chacun avec un SLO de disponibilité, c’est du toil : des clics répétés, des cibles qui divergent et des SLO oubliés à chaque nouveau service. Une configuration SLO Dynatrace Terraform transforme ce travail manuel en une liste versionnée et relue en merge request.
Objectif de ce tutoriel : générer un SLO de disponibilité par service à partir d’un seul fichier de configuration, avec le provider Terraform Dynatrace et une boucle for_each, puis vérifier le résultat. Le contenu s’appuie sur les SLO classiques (Settings 2.0), disponibles sur Dynatrace Managed et Dynatrace SaaS. Une section signale l’option des nouveaux SLO Grail en SaaS.
Avant d’automatiser, assurez-vous que vos indicateurs ont du sens : voir choisir ses SLI.
Le principe
- Un fichier
services.yamlliste les services et leur cible. - Terraform lit ce fichier avec
yamldecodeet crée une ressource SLO par entrée. - Ajouter un service = ajouter trois lignes et passer une revue de code. Supprimer une ligne supprime le SLO.
Prérequis
- Terraform 1.5 ou plus récent.
- Le provider
dynatrace-oss/dynatrace(registre Terraform). - Un token d’API avec les scopes que la ressource
dynatrace_slo_v2exige :slo.read,slo.write,settings.readetsettings.write. Vérifiez la liste dans la documentation du provider. - Des services avec un tag commun, par exemple
service:checkout, posé par vos règles de tagging (voir management zones et tagging).
SLO Dynatrace Terraform : la génération pas à pas
Étape 1 — Configurer le provider
terraform {
required_providers {
dynatrace = {
source = "dynatrace-oss/dynatrace"
}
}
}
provider "dynatrace" {}
Le provider lit l’URL et le token dans l’environnement. Ne les écrivez jamais dans le code :
# SaaS
export DYNATRACE_ENV_URL="https://<env-id>.live.dynatrace.com"
# Managed
export DYNATRACE_ENV_URL="https://<votre-domaine>/e/<env-id>"
export DYNATRACE_API_TOKEN="dt0c01.XXXX"
Épinglez une version du provider (version = "~> 1.x" avec la version testée) pour éviter un changement de schéma imprévu.
Étape 2 — Décrire les services dans un fichier
# services.yaml
checkout:
tag: "service:checkout"
target: 99.9
warning: 99.95
cart:
tag: "service:cart"
target: 99.5
warning: 99.7
search:
tag: "service:search"
target: 99.5
warning: 99.7
Ce fichier devient le catalogue de vos objectifs. Le product owner peut le relire sans connaître Terraform.
Étape 3 — Écrire la ressource avec for_each
locals {
services = yamldecode(file("${path.module}/services.yaml"))
}
resource "dynatrace_slo_v2" "availability" {
for_each = local.services
name = "Disponibilité ${each.key}"
enabled = true
custom_description = "Requêtes serveur sans erreur / requêtes. Géré par Terraform."
evaluation_type = "AGGREGATE"
evaluation_window = "-30d"
filter = "type(\"SERVICE\"),tag(\"${each.value.tag}\")"
metric_name = "availability_${replace(each.key, "-", "_")}"
metric_expression = "(100)*(builtin:service.errors.server.successCount:splitBy())/(builtin:service.requestCount.server:splitBy())"
target_success = each.value.target
target_warning = each.value.warning
error_budget_burn_rate {
burn_rate_visualization_enabled = true
fast_burn_threshold = 14.4
}
}
Lignes critiques :
for_each = local.services: une instance par clé du YAML, adressée par son nom (dynatrace_slo_v2.availability["checkout"]). Contrairement àcount, retirer un service ne décale pas les autres.filter: le sélecteur d’entités restreint le SLO aux services portant le tag. Les guillemets internes sont échappés.metric_name: doit être unique ; il sert à exposer le SLO comme métrique.fast_burn_threshold: aligné sur l’alerte rapide décrite dans alertes burn rate SLO.
Les noms d’attributs dépendent de la version du provider. Le plus sûr : créez un SLO à la main, exportez-le avec l’outil d’export du provider, puis comparez avec votre code.
Étape 4 — Planifier et appliquer
terraform init
terraform plan -out slo.plan
terraform apply slo.plan
Le plan doit annoncer exactement une création par service du YAML. Relisez-le en merge request avant l’apply, idéalement depuis un pipeline CI.
Et les nouveaux SLO Grail en SaaS ?
En SaaS, les SLO de l’application Service-Level Objectives (basés sur DQL) sont gérés par une autre ressource du provider, distincte de dynatrace_slo_v2. Son nom et ses attributs ont évolué entre versions : consultez la documentation du provider avant de l’utiliser. Le motif for_each reste identique ; seule la définition du SLI change, avec une requête DQL comme celles de créer un SLO OpenTelemetry.
Étape 5 — Ajouter un SLO de latence au même catalogue
Le même motif s’étend à un second type de SLI. Ajoutez un champ optionnel latency_ms dans le YAML, puis filtrez la map pour ne créer le SLO de latence que sur les services qui le déclarent :
locals {
latency_services = {
for name, svc in local.services : name => svc
if try(svc.latency_ms, null) != null
}
}
Une seconde ressource dynatrace_slo_v2 avec for_each = local.latency_services reprend alors la structure de l’étape 3, avec une expression de métrique de latence adaptée à votre version (vérifiez les métriques de temps de réponse disponibles dans la documentation). Le catalogue reste unique : un service, une entrée, tous ses objectifs.
Comment vérifier que ça fonctionne
terraform state listaffiche une ressource par service :dynatrace_slo_v2.availability["cart"], etc.- Un second
terraform planannonce « No changes ». Sinon, un attribut est normalisé par l’API : alignez votre code sur la valeur renvoyée. - Dans l’écran Service-level objectives, chaque SLO affiche un statut et un error budget, et non « no data ». Un « no data » signale presque toujours un tag absent ou mal écrit dans
filter.
Bonnes pratiques
- Stockez l’état Terraform dans un backend distant avec verrouillage, jamais sur un poste.
- Interdisez la modification manuelle des SLO gérés : la mention « Géré par Terraform » dans la description aide l’équipe.
- Exécutez
terraform planchaque nuit en CI pour détecter les dérives. - Gardez les cibles dans le YAML, pas dans le HCL : la discussion porte sur les objectifs, pas sur le code.
- Pour le reste de l’automatisation, voir automatiser avec l’API du cluster.
Questions fréquentes
Peut-on importer des SLO déjà créés à la main ?
Oui, avec un bloc import (Terraform 1.5+) ou terraform import, en utilisant l’identifiant du réglage. Ajoutez d’abord l’entrée dans le YAML pour que l’adresse existe.
Comment générer la liste des services automatiquement ?
Le provider propose une source de données d’entités qui liste les services. C’est pratique, mais un SLO par service sans revue humaine produit vite des SLO sans propriétaire. Préférez un YAML relu.
Ce code fonctionne-t-il en Managed hors ligne ?
Oui si la machine qui exécute Terraform atteint l’API du cluster et dispose du provider dans un miroir local.
Conclusion
Un fichier YAML, une ressource et une boucle for_each suffisent pour donner un SLO à chaque service, avec revue de code et historique. Le toil disparaît, et chaque nouveau service arrive avec son objectif dès le premier jour.
Prochaine étape conseillée : brancher ce dépôt sur votre pipeline CI, avec un plan automatique sur chaque merge request et un apply manuel après validation. Commencez par trois services pilotes, vérifiez que les SLO affichent des données réelles, puis ouvrez le catalogue aux autres équipes.
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.