Pendant un incident, l’astreinte ouvre un dashboard Dynatrace Managed et tombe sur vingt tuiles sans hiérarchie : graphiques par défaut, hôtes de tous les environnements mélangés, aucun repère sur les SLO. On perd dix minutes à chercher la bonne vue, et le MTTR s’allonge d’autant.
Ce guide montre comment construire des dashboards classiques utiles sur Dynatrace Managed : tuiles natives, graphiques du Data Explorer avec des sélecteurs de métriques builtin: exacts, filtrage par management zone, puis export et import JSON avec l’API Configuration pour les versionner.
Objectif : repartir avec trois dashboards complets, décrits tuile par tuile (santé applicative, hôtes, vue exploitation), et une méthode pour les provisionner sans clic. Le contenu vise Dynatrace Managed ; les dashboards classiques et l’API Configuration existent aussi en Dynatrace SaaS, où seule l’URL change.
Prérequis
- Un environnement Dynatrace Managed avec OneAgent déployé sur les hôtes et les services à suivre.
- Des management zones en place (voir management zones et tagging) : elles servent de filtre à chaque dashboard.
- Pour l’API : un token avec le scope
ReadConfig(lecture et export) etWriteConfig(création, mise à jour, validation). - L’URL de l’environnement au format Managed :
https://{votre-domaine}/e/{id-environnement}. - Des SLO déjà définis si vous voulez la tuile SLO de l’exemple 3.
Les briques d’un dashboard Dynatrace Managed
Un dashboard classique est une grille de tuiles. Chacune a un type (tileType), une position (bounds : top, left, width, height en pixels) et, au besoin, un filtre propre (tileFilter) qui remplace le filtre du dashboard.
| Type de tuile | Usage |
|---|---|
HEADER |
Titre de section, pour structurer la grille |
HOSTS, SERVICES, APPLICATIONS |
Santé globale d’une famille d’entités, filtrable par management zone |
DATA_EXPLORER |
Graphique construit dans le Data Explorer à partir d’un sélecteur de métriques |
OPEN_PROBLEMS |
Problèmes ouverts détectés par Davis |
SLO |
État et error budget d’un SLO |
MARKDOWN |
Texte libre : lien vers le runbook, contacts d’astreinte |
Au niveau du dashboard, dashboardMetadata.dashboardFilter fixe la management zone et la plage temporelle par défaut (par exemple l_2_HOURS ou l_72_HOURS). Le champ dynamicFilters.filters ajoute des filtres que le lecteur change à la volée, comme SERVICE_TYPE, HOST_TAG_KEY:<tag> ou KUBERNETES_CLUSTER.
Construire une tuile avec le Data Explorer
- Ouvrez Data Explorer depuis le menu, cherchez la métrique (par exemple CPU usage %).
- Choisissez l’agrégation, le découpage (Split by) et les filtres, ou basculez dans l’éditeur avancé pour saisir directement le sélecteur.
- Choisissez la visualisation (graphique, valeur unique, tableau, top list), puis Pin to dashboard et le dashboard cible.
- Sur le dashboard, éditez la tuile pour lui donner un nom parlant et, si besoin, une management zone propre.
Le sélecteur suit la syntaxe Metrics v2 : clé de métrique, puis transformations chaînées par :. Exemple documenté : builtin:host.cpu.user:sort(value(max,descending)):limit(10) pour les dix hôtes les plus chargés. Pour approfondir l’exploration, voir le module d’exploration des données.
Exemple 1 : santé applicative
But : savoir en dix secondes si les services d’une application tiennent leurs SLI (latence, erreurs, débit). Filtre du dashboard : la management zone de l’application, plage Last 2 hours.
| Tuile | Type | Sélecteur ou réglage |
|---|---|---|
| « Services » | HEADER |
Titre de section |
| Santé des services | SERVICES |
Filtre : management zone de l’application |
| Temps de réponse médian | DATA_EXPLORER, graphique |
builtin:service.response.time:splitBy("dt.entity.service"):median |
| Temps de réponse p90 | DATA_EXPLORER, graphique |
builtin:service.response.time:splitBy("dt.entity.service"):percentile(90) |
| Taux d’erreur | DATA_EXPLORER, top list |
builtin:service.errors.total.rate:splitBy("dt.entity.service"):avg:sort(value(avg,descending)):limit(10) |
| Débit | DATA_EXPLORER, graphique |
builtin:service.requestCount.total:splitBy("dt.entity.service"):auto |
Lignes critiques : builtin:service.response.time est exprimé en microsecondes, le Data Explorer convertit l’affichage. Le taux d’erreur builtin:service.errors.total.rate est déjà un pourcentage et n’accepte que auto et avg. Le compteur builtin:service.requestCount.total n’accepte que auto et value : n’y appliquez pas avg. Le p90 colle mieux à l’expérience réelle qu’une moyenne.
Exemple 2 : hôtes
But : repérer les hôtes saturés avant qu’ils ne déclenchent un problème. Filtre : la management zone de l’équipe infrastructure, plage Last 24 hours.
| Tuile | Type | Sélecteur ou réglage |
|---|---|---|
| Santé des hôtes | HOSTS |
Filtre : management zone |
| Top 10 CPU | DATA_EXPLORER, top list |
builtin:host.cpu.usage:splitBy("dt.entity.host"):avg:sort(value(avg,descending)):limit(10) |
| Top 10 mémoire | DATA_EXPLORER, top list |
builtin:host.mem.usage:splitBy("dt.entity.host"):max:sort(value(max,descending)):limit(10) |
| Disques les plus pleins | DATA_EXPLORER, tableau |
builtin:host.disk.usedPct:splitBy("dt.entity.host"):max:sort(value(max,descending)):limit(10) |
| Disponibilité | DATA_EXPLORER, graphique |
builtin:host.availability (agrégation par défaut) |
Les trois métriques de ressources sont en pourcentage et acceptent avg, max et min. Prenez max pour la mémoire et le disque : une moyenne masque le pic qui fait tomber un processus. Dans le Data Explorer, ajoutez une valeur seuil à 85 % pour colorer les dépassements.
Exemple 3 : vue exploitation de l’environnement
But : la page d’accueil de l’astreinte. Sans filtre de management zone, ou avec une zone « Production », plage Last 2 hours.
| Tuile | Type | Réglage |
|---|---|---|
| Problèmes ouverts | OPEN_PROBLEMS |
Filtre : management zone Production |
| SLO disponibilité du front | SLO |
SLO assigné à la tuile, avec error budget |
| SLO latence de l’API | SLO |
SLO assigné à la tuile |
| Erreurs, tous services | DATA_EXPLORER, valeur unique |
builtin:service.errors.total.rate:splitBy():avg |
| Hôtes indisponibles | DATA_EXPLORER, top list |
builtin:host.availability:splitBy("dt.entity.host") |
| Runbook | MARKDOWN |
Lien vers la procédure et le canal d’astreinte |
La tuile OPEN_PROBLEMS reflète ce que Davis a ouvert ; c’est le pendant visuel des notifications de vos profils d’alerting. Pour surveiller le cluster Managed lui-même (nœuds, stockage, ActiveGates), gardez un dashboard séparé et appuyez-vous sur le monitoring de la santé du cluster.
Exporter et importer un dashboard en JSON
Étape 1 : lister et exporter
export DT_URL="https://{votre-domaine}/e/{id-environnement}"
# Lister (scope ReadConfig) : renvoie id, name, owner
curl -s "$DT_URL/api/config/v1/dashboards" \
-H "Authorization: Api-Token $DT_TOKEN" | jq '.dashboards[] | {id, name, owner}'
# Exporter un dashboard
curl -s "$DT_URL/api/config/v1/dashboards/<id>" \
-H "Authorization: Api-Token $DT_TOKEN" > sante-app.json
La liste renvoie tous les dashboards, quels que soient les droits dans l’interface. Le meilleur moyen d’obtenir la structure exacte d’une tuile DATA_EXPLORER est de l’exporter après l’avoir construite dans l’interface.
Étape 2 : un JSON minimal valide
{
"dashboardMetadata": {
"name": "Exploitation - Production",
"owner": "sre-team",
"shared": true,
"dashboardFilter": {
"timeframe": "l_2_HOURS",
"managementZone": { "id": "3438779970106539862", "name": "Production" }
}
},
"tiles": [
{
"name": "Hôtes", "tileType": "HEADER", "configured": true,
"bounds": { "top": 0, "left": 0, "width": 304, "height": 38 },
"tileFilter": {}
},
{
"name": "Santé des hôtes", "tileType": "HOSTS", "configured": true,
"chartVisible": true,
"bounds": { "top": 38, "left": 0, "width": 304, "height": 304 },
"tileFilter": {}
}
]
}
dashboardMetadata (avec name et owner) et tiles sont obligatoires. Avant d’importer un export, retirez id et le bloc metadata, qui servent au débogage : l’identifiant est attribué par Dynatrace.
Étape 3 : valider puis créer ou mettre à jour
# Valider sans créer (scope WriteConfig) : 204 = valide
curl -s -o /dev/null -w "%{http_code}\n" -X POST \
"$DT_URL/api/config/v1/dashboards/validator" \
-H "Authorization: Api-Token $DT_TOKEN" \
-H "Content-Type: application/json" -d @sante-app.json
# Créer
curl -s -X POST "$DT_URL/api/config/v1/dashboards" \
-H "Authorization: Api-Token $DT_TOKEN" \
-H "Content-Type: application/json" -d @sante-app.json
# Mettre à jour un dashboard existant
curl -s -X PUT "$DT_URL/api/config/v1/dashboards/<id>" \
-H "Authorization: Api-Token $DT_TOKEN" \
-H "Content-Type: application/json" -d @sante-app.json
Un 400 renvoie un ErrorEnvelope dont les constraintViolations pointent le champ fautif. Les management zones ont des identifiants propres à chaque environnement : adaptez-les en passant d’un environnement à l’autre.
Partage et permissions
Le champ shared rend le dashboard visible des autres utilisateurs ; sharingDetails (linkShared, published) règle le partage par lien et la publication. Le propriétaire (owner) garde l’édition. Un dashboard partagé ne donne pas accès aux données : chaque lecteur ne voit que ce que ses permissions de management zone autorisent. Les dashboards contenant des tuiles d’environnement distant ne peuvent être modifiés par l’API que par un administrateur (réponse 403 sinon).
Provisionner avec Terraform ou Monaco
Le provider Terraform Dynatrace gère les dashboards classiques avec la ressource dynatrace_json_dashboard, qui prend le JSON du dashboard. Son outil d’export les exclut par défaut : nommez-les explicitement. Avec Monaco, les dashboards sont un type de configuration spécifique ; depuis Monaco CLI 1.208, owner doit être non nul et sharingDetails n’est plus pris en charge. Référez-vous à la documentation du provider pour la syntaxe exacte de votre version.
Comment vérifier que ça fonctionne
- L’appel au validateur renvoie
204, le POST renvoie l’identifiant du nouveau dashboard. - Le GET de liste montre le dashboard avec le bon
owner. - Dans l’interface, menu Dashboards : le dashboard apparaît, le filtre de management zone est affiché en haut, chaque tuile Data Explorer montre des données sur la plage choisie.
- Connecté avec un compte limité à une autre management zone, le dashboard partagé n’affiche que les entités autorisées.
Bonnes pratiques
- Un dashboard, une question : « l’application va-t-elle bien ? », pas « tout sur tout ».
- Mettez les SLI en haut à gauche, les détails en dessous.
- Préférez percentiles et maximums aux moyennes pour la latence et la saturation.
- Limitez les top lists à 10 entités avec
limit(10): plus, c’est du bruit. - Versionnez le JSON et appliquez-le par pipeline ; un dashboard modifié à la main dérive vite.
- Ajoutez une tuile Markdown avec le runbook : elle réduit le temps de première action.
Questions fréquentes
Les dashboards Dynatrace Managed sont-ils les mêmes qu’en SaaS ?
Les dashboards classiques et l’API /api/config/v1/dashboards existent dans les deux. En SaaS, la nouvelle application Dashboards fondée sur Grail et DQL s’y ajoute ; elle ne concerne pas Managed.
Pourquoi ma tuile Data Explorer est-elle vide ?
Le plus souvent, la management zone de la tuile ou du dashboard exclut les entités, ou l’agrégation choisie n’est pas acceptée par la métrique. Testez le sélecteur seul dans le Data Explorer, puis réappliquez le filtre.
Puis-je copier un dashboard entre deux environnements Managed ?
Oui : export GET, suppression de id et metadata, remplacement des identifiants de management zone, SLO et entités, puis validation et POST sur l’environnement cible.
Conclusion
Un bon dashboard Dynatrace Managed se construit autour des SLI : latence, erreurs, débit, saturation et problèmes ouverts. Avec des sélecteurs exacts, des management zones bien définies et un JSON versionné, vos trois dashboards deviennent reproductibles et utiles au moment où l’astreinte en a besoin. Référence officielle : API Dashboards de Dynatrace Managed.
span.observer est un blog indépendant de la communauté, non affilié à Dynatrace LLC. Dynatrace est une marque de son propriétaire. Les exemples sont fournis à titre indicatif : vérifiez-les dans la documentation officielle de votre version.