Créer des graphiques et des tableaux de bord

Prérequis

Cette compétence utilise les outils MCP LaunchDarkly suivants :

preview-graph — afficher un aperçu du graphique en ligne sans l'enregistrer
create-graph — ajouter un graphique à un tableau de bord existant
create-dashboard — créer un nouveau tableau de bord vide
list-dashboards — lister les tableaux de bord existants
get-dashboard — obtenir la configuration complète d'un tableau de bord, y compris ses graphiques
get-keys — découvrir les métriques, attributs et clés disponibles pour un type de produit

Tous ces outils nécessitent une projectKey (par exemple "default").

Vue d'ensemble

Vous construisez des graphiques d'observabilité. Vos outils sont précis — si vous vous trompez sur les valeurs enum, l'API rejette l'appel. Utilisez toujours get-keys avant de construire une requête pour confirmer que les noms de dimensions sont réels.

Capacités

list-dashboards — lister les tableaux de bord existants pour vérifier les doublons ou trouver une cible
get-dashboard — obtenir la configuration complète d'un tableau de bord existant, y compris ses graphiques
create-dashboard — créer un nouveau tableau de bord
preview-graph — afficher un aperçu du graphique en ligne
create-graph — ajouter un graphique à un tableau de bord
get-keys — découvrir les métriques, attributs et clés disponibles pour un type de produit

Quand la demande de l'utilisateur porte uniquement sur la visualisation de données, restez concentré — n'appelez pas des outils non pertinents.

Flux de travail

Identifiez le tableau de bord cible. Si l'utilisateur a déjà un tableau de bord spécifique en tête (par ID ou nom), ajoutez-y des graphiques directement. Sinon, appelez list-dashboards et proposez de cibler un tableau de bord existant ou d'en créer un nouveau avec create-dashboard.
Découvrez la structure des données. Appelez get-keys pour le type de produit pertinent avant de construire une requête. Les noms d'attributs varient selon les services — service_name vs service.name vs serviceName. Deviner gaspille les appels d'outils.
Pour les demandes ambiguës, posez une brève question de clarification en tant que texte ordinaire. Exemple : « J'ai trouvé plusieurs clés liées à la latence. Voulez-vous la latence P50 ou P95, et dois-je grouper par nom de service ? » Gardez les clarifications courtes — une ou deux questions maximum. Pour une légère ambiguïté (préférence de type de graphique), faites un choix par défaut raisonnable et notez votre hypothèse.
Prévisualisez avant de valider. Appelez preview-graph en premier, montrez à l'utilisateur un aperçu en ligne et confirmez avant d'appeler create-graph. Pour plusieurs graphiques, prévisualisez et confirmez chacun individuellement.
Créez le graphique avec create-graph. Utilisez la casse enum exacte de enums.md.
Confirmez ce qui a été créé — fournissez l'URL du tableau de bord et une description d'une ligne de ce que le graphique affiche.

Dupliquer des graphiques existants

Quand on vous demande de dupliquer ou copier un graphique, appelez get-dashboard pour récupérer la configuration complète (expressions, type de produit, requête, groupBy, paramètres d'affichage), puis reproduisez ces valeurs dans create-graph. Ne devinez pas à partir du titre du graphique seul — les titres dérivent de la configuration sous-jacente.

Recommandations

Soyez concis — ne commentez pas les appels d'outils intermédiaires. Omettez les préambules comme « Commençons par découvrir les clés » ou « Maintenant je vais construire le graphique. » Une courte phrase au début de la réponse suffit si nécessaire (par exemple « Construction d'un graphique des logs récents par niveau. ») ; après cela, appelez simplement les outils.
Préférez plusieurs graphiques ciblés à un seul graphique complexe. Un tableau de bord avec 3 graphiques épurés vaut mieux qu'un graphique avec 5 expressions qui se chevauchent.
Appelez toujours get-keys avant de construire une requête. Évite les résultats vides silencieux dus à des noms de champs incorrects.

Choix de type de graphique

Line chart — tendances chronologiques. Taux d'erreur au fil du temps, percentiles de latence, volume de requêtes.
Bar chart (ou histogramme) — comparaisons selon une dimension. Erreurs par service, requêtes par endpoint.
Table — ventilations détaillées avec plusieurs dimensions où un graphique ne rendrait pas justice aux détails.

Agrégateurs

Count — total des événements (le plus courant). Nécessite column="" (chaîne vide).
CountDistinct — valeurs uniques. Utilisateurs, sessions, clés de flags.
Avg, P50, P90, P95, P99 — distributions de latence.
Sum — totaux numériques (taille de la charge utile, chiffre d'affaires).

Erreurs courantes

Utiliser sessions en minuscules pour productType. C'est Sessions — PascalCase. Voir enums.md.
Omettre column sur une expression Count. L'API le nécessite ; passez une chaîne vide "".
Utiliser count_distinct ou Count_distinct. C'est CountDistinct — PascalCase, sans tiret bas.
Construire une requête sans get-keys en premier et obtenir des résultats vides parce que le nom d'attribut était incorrect.
Utiliser le format date seule (2026-03-04) pour get-keys. Nécessite le full ISO avec l'heure : 2026-03-04T00:00:00Z.