Dashboard Dynatrace Managed : tuiles, Data Explorer et JSON, avec 3 exemples complets

Construisez un dashboard Dynatrace Managed utile : sélecteurs builtin exacts, management zones, export JSON via l’API et 3 exemples complets à copier.
Dashboard Dynatrace Managed : tuiles, Data Explorer et JSON, avec 3 exemples complets

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) et WriteConfig (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

  1. Ouvrez Data Explorer depuis le menu, cherchez la métrique (par exemple CPU usage %).
  2. Choisissez l’agrégation, le découpage (Split by) et les filtres, ou basculez dans l’éditeur avancé pour saisir directement le sélecteur.
  3. Choisissez la visualisation (graphique, valeur unique, tableau, top list), puis Pin to dashboard et le dashboard cible.
  4. 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.

Total
0
Shares
Laisser un commentaire

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

Previous Post
Dashboard Dynatrace SaaS : construire des tableaux de bord DQL sur Grail, avec 3 exemples complets

Dashboard Dynatrace SaaS : construire des tableaux de bord DQL sur Grail, avec 3 exemples complets

Next Post
MCP Dynatrace SaaS : installer, authentifier et connaître ses outils

MCP Dynatrace SaaS : installer, authentifier et connaître ses outils

Related Posts