Passer au contenu principal
La commande dashboards gère les tableaux de bord d’une application depuis le terminal : lister ceux existants, créer un tableau de bord et mettre à jour le titre ou la description d’un tableau de bord. Chaque commande cible une application, par nom et environnement (--app "MyApp" --environment production) ou par ID (--app-id <APP_ID>, le long ID hexadécimal de l’application provenant de appsignal-cli apps list). L’option --environment n’est nécessaire que lorsque plusieurs applications partagent un nom. Chaque commande utilise votre organisation par défaut sauf si vous passez --org. Voir Applications et organisations pour savoir comment les applications sont identifiées.

Lister les tableaux de bord

Shell
appsignal-cli dashboards list --app "MyApp" --environment production
La liste inclut l’ID de chaque tableau de bord, dont vous avez besoin pour en mettre un à jour.

Créer un tableau de bord

Un nouveau tableau de bord a besoin d’un titre et peut prendre une description optionnelle :
Shell
appsignal-cli dashboards create --app "MyApp" --environment production \
  --title "Checkout health" --description "Latency and error rate for checkout"
OptionDescription
--title <title>Titre du tableau de bord (requis)
--description <text>Description optionnelle
--app <name>Application dans laquelle créer le tableau de bord (ajoutez --environment quand le nom n’est pas unique)
--environment <env>Environnement, utilisé avec --app
--app-id <id>L’ID de l’application (une longue chaîne hexadécimale), comme alternative à --app et --environment
--org <slug>Slug de l’organisation (utilise votre valeur par défaut si omis)

Mettre à jour un tableau de bord

Passez le --id du tableau de bord (depuis dashboards list) avec le nouveau titre :
Shell
appsignal-cli dashboards update --id <DASHBOARD_ID> --app "MyApp" --environment production \
  --title "Checkout health" --description "Updated description"
OptionDescription
--id <id>ID du tableau de bord à mettre à jour (requis ; depuis dashboards list)
--title <title>Nouveau titre (requis)
--description <text>Description optionnelle
--app <name>Application à laquelle appartient le tableau de bord (ajoutez --environment quand le nom n’est pas unique)
--environment <env>Environnement, utilisé avec --app
--app-id <id>L’ID de l’application (une longue chaîne hexadécimale), comme alternative à --app et --environment
--org <slug>Slug de l’organisation (utilise votre valeur par défaut si omis)
--title est requis même lorsque vous ne modifiez que la description.

Prochaines étapes

Un tableau de bord visualise vos métriques. Pour être alerté lorsque l’un d’eux franchit un seuil, configurez des déclencheurs de détection d’anomalies.