Passer au contenu principal
La plupart des commandes de la CLI agissent sur une seule application dans un seul environnement, donc avant de suivre les journaux ou de lister les incidents, vous devez savoir quelles applications vous avez et comment les nommer. Cette page couvre la liste de vos applications, la définition d’une organisation par défaut et l’inspection des ressources d’une application.

​
Organisations

Vos applications appartiennent à une organisation, identifiée par son slug : le nom court dans votre URL AppSignal, appsignal.com/<org-slug>. La CLI fonctionne avec l’organisation liée à votre compte connecté.

​
Définir une organisation par défaut

La plupart des commandes utilisent par défaut une organisation, vous n’avez donc pas besoin de passer --org à chaque fois. L’exécution de appsignal-cli apps list détermine l’organisation de votre compte et la sauvegarde comme valeur par défaut. Pour la définir ou la modifier vous-même :
Shell
appsignal-cli apps set-org --org <YOUR_ORG_SLUG>
Pour voir la valeur par défaut actuelle :
Shell
appsignal-cli apps show-org
Vous pouvez également définir la valeur par défaut lors de la connexion avec appsignal-cli auth login --org <YOUR_ORG_SLUG>, ou par projet avec appsignal-cli project init --org <YOUR_ORG_SLUG>. Voir Authentification pour savoir comment les configurations globales et locales au projet sont liées.

​
Applications

Pour lister les applications de l’organisation de votre compte :
Shell
appsignal-cli apps list
Cela sauvegarde également votre organisation par défaut pour les commandes ultérieures, vous n’avez donc pas besoin de leur passer --org.

​
Rechercher une application par nom

Pour rechercher une application spécifique par nom, en limitant éventuellement à un environnement :
Shell
appsignal-cli apps find --name "MyApp" --environment production
Le nom et l’environnement sont tous deux insensibles à la casse. C’est le moyen le plus rapide de confirmer le nom exact de l’application et l’environnement attendus par d’autres commandes.

​
Afficher les détails d’une application

Si vous connaissez l’ID d’une application, vous pouvez récupérer ses détails directement :
Shell
appsignal-cli apps info --app-id <APP_ID>

​
Comment les commandes identifient une application

Les commandes qui agissent sur une seule application l’acceptent de deux manières :
  • Par nom : --app "MyApp". Ajoutez --environment production uniquement lorsque plusieurs applications partagent le même nom.
  • Par ID : --app-id <APP_ID>, la valeur de la colonne ID de appsignal-cli apps list (une longue chaîne hexadécimale). Un ID identifie une application spécifique et son environnement à lui seul, vous ne passez donc pas --environment avec lui.
Utilisez celui que vous avez. Un nom est plus facile à lire et à taper ; l’ID est sans ambiguïté et pratique dans les scripts.

​
Inspecter les ressources d’une application

Les commandes apps resources affichent la configuration et les métadonnées attachées à une application :
CommandeAffiche
apps resources allToutes les ressources ci-dessous, en un seul appel
apps resources usersLes utilisateurs ayant accès à l’application
apps resources notifiersLes notifiers configurés
apps resources namespacesLes namespaces de l’application
apps resources dashboardsLes tableaux de bord personnalisés
apps resources deploy-markersLes marqueurs de déploiement récents
Chacune accepte le même sélecteur d’application que les autres commandes, soit --app avec --environment, soit --app-id, et utilise votre organisation par défaut sauf si vous passez --org. Par exemple, pour voir les namespaces d’une application :
Shell
appsignal-cli apps resources namespaces --app "MyApp" --environment production
Pour tout récupérer en une seule fois au format JSON, afin de le passer à un autre outil :
Shell
appsignal-cli apps resources all --app "MyApp" --environment production --output json

​
Prochaines étapes

Une fois que vous connaissez le nom et l’environnement d’une application, vous pouvez commencer à l’interroger. Inspectez ses incidents ou suivez ses journaux depuis le terminal.