Passer au contenu principal
Un Big Number est un graphique KPI à valeur unique, utile pour afficher un total, la dernière lecture ou une métrique agrégée en un coup d’œil (par exemple, le total des erreurs, la profondeur actuelle de la file d’attente, la latence moyenne des requêtes). Cette page explique comment utiliser cette fonctionnalité depuis un agent IA connecté à AppSignal MCP. Pour un tour d’horizon de tous les types de graphiques de tableau de bord dans l’interface utilisateur, consultez Tableaux de bord.

​
Ce que vous pouvez faire

Avec la permission dashboards définie sur write, un agent peut :
  • Créer un nouveau tableau de bord pour contenir le graphique (manage_dashboard)
  • Ajouter un graphique Big Number à n’importe quel tableau de bord (create_dashboard_visual avec type: "number")
  • Modifier la métrique, l’agrégat ou le formatage d’un graphique existant (update_dashboard_visual)
Le graphique s’affiche de la même manière que celui créé dans l’application AppSignal, MCP n’est qu’une autre façon de le créer. Graphique Big Number sur un tableau de bord

​
Exemple de prompt

Text
Add a Big Number chart to the "API Health" dashboard showing the mean
of request_latency_ms over the selected time range, formatted as a duration.
L’agent traduira cela en un appel create_dashboard_visual avec :
  • type: "number"
  • metric.name: "request_latency_ms"
  • metric.field: "mean"
  • metric.aggregate: "avg"
  • format: "duration"

​
Configuration du graphique

Un graphique Big Number nécessite une métrique et une agrégation sur la plage horaire sélectionnée :
  • Metric — Le nom de la métrique à afficher dans ce graphique. Vous pouvez soit utiliser le nom complet de la métrique pour sélectionner une seule métrique, soit utiliser un caractère générique (_) pour sélectionner plusieurs métriques à la fois : db_users_document_count, db\__\_size. Consultez les conventions de nommage des métriques pour les règles complètes.
  • Aggregation type — L’agrégation utilisée pour afficher la valeur de la métrique. Le nombre sur le graphique est sélectionné ou calculé en fonction de cette agrégation, appliquée aux données métriques rapportées dans la plage horaire sélectionnée sur le tableau de bord ou l’aperçu :
    • Maximum value — la valeur métrique la plus élevée
    • Minimum value — la valeur métrique la plus basse
    • Average value — la moyenne des valeurs métriques
    • Total value — la valeur combinée des valeurs métriques
    • First value — la première valeur métrique
    • Last value — la dernière valeur métrique
  • Data format — Sélectionnez le format de valeur utilisé pour afficher les valeurs dans le graphique et les légendes du graphique. Consultez le formatage des valeurs pour les formats disponibles.
  • Tags (facultatif) — Sélectionnez quels tags de la métrique doivent être affichés dans le graphique :
    • Lorsqu’il est vide, toutes les variations d’un tag créeront leur propre ligne dans le graphique.
    • Entrez des tags pour filtrer certaines valeurs de tag. Dans ce cas, tous les tags de la métrique doivent être spécifiés, soit avec une valeur, soit avec un caractère générique.
    Consultez les tags de métrique pour la référence complète.
Configuration du graphique Big Number dans l'interface AppSignal

​
Envoi des données

MCP crée le visuel ; il n’ingère pas de métriques. La métrique à laquelle vous pointez un graphique doit déjà être envoyée vers AppSignal via votre intégration. Consultez les métriques personnalisées pour savoir comment les envoyer depuis votre application.