Migrer SLO Grail : passer des SLO classiques aux nouveaux SLO Dynatrace

Migrer SLO Grail sans perdre le fil : inventaire API, réécriture des SLI en DQL, double run de comparaison et bascule des alertes sur Dynatrace SaaS.
Migrer SLO Grail : passer des SLO classiques aux nouveaux SLO Dynatrace

Vos SLO classiques tournent depuis des années, mais leurs expressions de métriques deviennent difficiles à maintenir et l’équipe veut tout piloter en DQL. Migrer les SLO vers Grail ne se fait pas en un clic : chaque objectif doit être réécrit, comparé puis basculé sans perdre l’historique de l’error budget. Ce tutoriel explique comment migrer SLO Grail par SLO Grail, sans casser vos alertes.

Objectif : à la fin, vous aurez un inventaire de vos SLO classiques, leur équivalent DQL sur Grail, une période de double run qui prouve que les deux calculs concordent, et un plan de bascule des alertes. Le contenu concerne Dynatrace SaaS : les nouveaux SLO reposent sur Grail, qui n’existe pas en Dynatrace Managed. Sur Managed, vous restez sur les SLO classiques ; la section dédiée plus bas indique quoi préparer.

Si vous partez de zéro sur les indicateurs, lisez d’abord comment choisir ses SLI en DQL.

Le problème : deux moteurs de SLO qui divergent

Un SLO classique calcule son ratio à partir d’une expression de métriques (par exemple builtin:service.errors.total.successCount divisé par builtin:service.requestCount.total). Un SLO sur Grail calcule le sien à partir d’une requête DQL. Les deux moteurs n’agrègent pas forcément de la même façon : résolution, gestion des trous de données, périmètre des entités. Sans comparaison, vous risquez de basculer vers un SLO qui affiche 99,95 % là où l’ancien affichait 99,80 %, et de masquer une vraie consommation de budget.

Prérequis

  • Un environnement Dynatrace SaaS sur la plateforme Grail, avec l’application Service-Level Objectives (l’intitulé exact peut varier selon la version : vérifiez dans docs.dynatrace.com).
  • Un token d’API classique avec le scope de lecture des SLO (slo.read) pour l’inventaire.
  • Les permissions pour lire les métriques dans Grail et créer des SLO dans la nouvelle application.
  • curl et jq sur votre poste.

Étape 1 : inventorier les SLO classiques

L’API v2 des SLO classiques renvoie la liste paginée, avec la cible, la fenêtre et l’expression de métriques.

export DT_ENV="https://VOTRE-ENV.live.dynatrace.com"
export DT_TOKEN="dt0c01.XXXX"   # scope slo.read

curl -s "$DT_ENV/api/v2/slo?pageSize=200&evaluate=false" \
  -H "Authorization: Api-Token $DT_TOKEN" \
| jq -r '.slo[] | [.id, .name, .target, .timeframe, .metricExpression] | @tsv' \
> inventaire-slo.tsv

wc -l inventaire-slo.tsv

Les champs critiques : target (la cible, par exemple 99.9), timeframe (par exemple -30d) et metricExpression, la formule à traduire. Si la réponse contient un nextPageKey, relancez l’appel avec ce paramètre.

Étape 2 : trier avant de migrer

Ne migrez pas tout. Classez chaque ligne de l’inventaire en trois groupes :

  1. À migrer : SLO suivi, lié à une alerte ou à un tableau de bord.
  2. À fusionner : plusieurs SLO qui mesurent le même parcours avec des filtres légèrement différents.
  3. À supprimer : SLO orphelin que personne ne consulte. Chaque SLO conservé coûte de la maintenance : c’est du toil.

Étape 3 : migrer SLO Grail par SLO Grail en réécrivant le SLI en DQL

Prenons un SLO classique de taux de succès d’un service. Sur Grail, les métriques de service sont exposées sous des clés comme dt.service.request.count et dt.service.request.failure_count. La requête suivante calcule le SLI sur la même période :

timeseries {
    total    = sum(dt.service.request.count),
    failures = sum(dt.service.request.failure_count)
  },
  by: { dt.entity.service },
  filter: { in(dt.entity.service, "SERVICE-0123456789ABCDEF") }
| fieldsAdd sli = 100 * (total[] - failures[]) / total[]

Points à surveiller :

  • total[] - failures[] applique l’opération à chaque intervalle de la série : le SLI est donc une série temporelle, ce qu’attend un SLO personnalisé.
  • Le nom du champ de sortie compte. Les modèles de SLO personnalisés attendent un champ précis (souvent sli) : vérifiez la convention dans la documentation de l’application avant de valider.
  • Remplacez l’identifiant de service en dur par un filtre sur une étiquette ou une zone dès que plusieurs services sont concernés.

Créez ensuite le SLO dans l’application : collez la requête, reprenez exactement la même cible et la même fenêtre que le SLO classique. Changer la cible pendant la migration rendrait la comparaison inutilisable.

Étape 4 : le double run

Gardez les deux SLO actifs pendant au moins une fenêtre complète, idéalement deux. Chaque jour, comparez les valeurs. Côté classique, l’API renvoie l’évaluation :

curl -s "$DT_ENV/api/v2/slo/ID_DU_SLO?timeFrame=CURRENT" \
  -H "Authorization: Api-Token $DT_TOKEN" \
| jq '{name, evaluatedPercentage, errorBudget}'

Côté Grail, réutilisez la requête de l’étape 3 en agrégeant sur la fenêtre complète :

timeseries {
    total    = sum(dt.service.request.count),
    failures = sum(dt.service.request.failure_count)
  },
  from: now()-30d,
  filter: { in(dt.entity.service, "SERVICE-0123456789ABCDEF") }
| fieldsAdd t = arraySum(total), f = arraySum(failures)
| fieldsAdd sli = 100 * (t - f) / t
| fields sli

Tolérez un écart faible (de l’ordre de quelques centièmes de point) dû aux différences d’agrégation. Un écart plus grand signale presque toujours un périmètre différent : un service ajouté, un filtre de requêtes clés oublié, ou des requêtes synthétiques comptées d’un côté et pas de l’autre.

Étape 5 : basculer les alertes

La migration n’est terminée que lorsque l’astreinte est alertée par le nouveau SLO. Reprenez la logique multi-fenêtres décrite dans alertes burn rate SLO dans Dynatrace, appliquée au SLO Grail. Activez la nouvelle alerte, laissez l’ancienne en parallèle quelques jours, puis désactivez l’ancienne. Ne supprimez le SLO classique qu’après avoir exporté son historique si vos rapports mensuels en dépendent.

Si vous gérez vos SLO en code, mettez à jour vos définitions Terraform au lieu de cliquer dans l’interface : voir SLO Dynatrace avec Terraform. Vérifiez dans la documentation du provider quelle ressource correspond aux nouveaux SLO, car elle diffère de celle des SLO classiques.

Et sur Dynatrace Managed ?

Dynatrace Managed n’a pas Grail : les nouveaux SLO n’y sont pas disponibles. Vous pouvez néanmoins préparer une future migration vers SaaS :

  • exporter l’inventaire avec le même appel API (l’URL contient alors /e/ID-ENVIRONNEMENT) ;
  • nettoyer les SLO orphelins dès maintenant ;
  • documenter, pour chaque SLO, l’intention métier en une phrase. Elle survivra à la réécriture.

Comment vérifier que ça fonctionne

  1. Dans l’application des SLO, le nouveau SLO affiche un statut et un error budget restant, sans message d’erreur de requête.
  2. Le tableau de comparaison du double run montre un écart stable et faible sur toute la fenêtre.
  3. Dans un Notebook, la requête de l’étape 4 renvoie une seule ligne avec un sli cohérent avec l’application.
  4. Un test contrôlé (erreurs injectées en préproduction) fait baisser les deux SLO de la même façon et déclenche la nouvelle alerte.

Bonnes pratiques

  • Une cible inchangée pendant la migration : on change le moteur ou la cible, jamais les deux à la fois.
  • Migrer par lots : commencez par les trois SLO les plus suivis, pas par les cinquante.
  • Nommer clairement : un suffixe temporaire comme « (Grail) » évite de confondre les deux SLO pendant le double run.
  • Tracer les décisions : notez dans un ticket chaque fusion ou suppression, avec la raison.
  • Revoir les tableaux de bord : les tuiles qui pointent vers l’ancien SLO doivent suivre, voir le tableau de bord SLO pour la direction.

Questions fréquentes

Existe-t-il un outil de migration automatique des SLO classiques ?

Les capacités évoluent selon les versions de Dynatrace SaaS. Consultez la documentation officielle pour savoir si un assistant de conversion est proposé dans votre environnement. Même avec un assistant, le double run reste indispensable pour valider les chiffres.

Perd-on l’historique de l’error budget en migrant ?

Le nouveau SLO recalcule son SLI à partir des données présentes dans Grail, selon la rétention de vos métriques. L’historique du SLO classique, lui, ne se transfère pas tel quel. Exportez-le si vous en avez besoin pour des rapports.

Peut-on garder des SLO classiques et des SLO Grail en même temps ?

Oui, pendant la transition c’est même recommandé. À terme, évitez deux sources de vérité pour un même objectif : l’astreinte doit savoir quel chiffre fait foi.

Conclusion

Migrer les SLO vers Grail, c’est d’abord trier, puis réécrire chaque SLI en DQL, comparer pendant une fenêtre complète et seulement ensuite basculer les alertes. Cette discipline évite de « gagner » des points de fiabilité par simple changement de calcul, et garde l’error budget honnête.

span.observer est un blog indépendant de la communauté, non affilié à Dynatrace LLC. Dynatrace est une marque de son propriétaire. 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
Tableau de bord SLO pour la direction : statut, budget restant et tendance dans Dynatrace

Tableau de bord SLO pour la direction : statut, budget restant et tendance dans Dynatrace

Next Post
SLO parcours utilisateur : mesurer ce que vit le client avec RUM et synthétique

SLO parcours utilisateur : mesurer ce que vit le client avec RUM et synthétique

Related Posts