Skip to main content
L’AppSignal CLI est conçue pour deux types d’utilisateurs : les humains et les agents IA. Par défaut, chaque commande affiche une sortie lisible par les humains ; passez --output json et elle retourne du JSON lisible par machine à la place. En d’autres termes, le même outil que vous utilisez lors d’un incident peut également fournir des données structurées à un agent de codage. Elle inclut même une compétence d’agent AppSignal : un ensemble d’instructions qui apprend à un agent comme Claude ou Codex à utiliser la CLI. Installez-la avec appsignal-cli skill install.
La CLI communique avec les mêmes données AppSignal que l’interface de l’application et AppSignal MCP. C’est une passerelle vers les données qu’AppSignal possède déjà. Si votre application n’envoie pas de logs, logs tail n’affichera rien.

Ce que vous pouvez faire

  • Logs : suivez les lignes de log au fur et à mesure qu’elles arrivent, ou recherchez dans une plage de temps avec la syntaxe de requête d’AppSignal. Filtrez par gravité ou source, appliquez des vues de logs enregistrées et listez les vues et sources d’une application. Créez et gérez des métriques dérivées des logs et des déclencheurs basés sur les logs à partir de vos données de logs.
  • Incidents : listez les incidents d’exception, de performance et d’anomalie, et recherchez ceux d’exception et de performance ; ouvrez les détails d’un incident ; mettez à jour son état, sa gravité, sa fréquence de notification ou ses assignés ; et ajoutez, modifiez ou supprimez ses notes.
  • Traces : listez les performance samples et error traces derrière une action ou un incident, filtrez-les par tag ou révision de déploiement, et ouvrez-en un pour lire son span tree jusqu’à un span individuel.
  • Déclencheurs : listez, créez, mettez à jour et archivez les déclencheurs de Anomaly detection.
  • Tableaux de bord : listez, créez et mettez à jour les tableaux de bord de votre application.
  • Applications : listez vos applications, trouvez une application par nom, et inspectez ses utilisateurs, notifieurs, namespaces, tableaux de bord et marqueurs de déploiement.
  • Configuration de projet : créez une configuration locale au projet pour que les commandes exécutées dans un dépôt utilisent par défaut la bonne organisation.
  • Compétence d’agent : installez la compétence AppSignal incluse dans votre agent IA, mettez-la à jour et vérifiez si elle est à jour.
  • Feedback : signalez une commande manquante, un comportement défectueux ou une fonctionnalité dont vous avez besoin, sans quitter le terminal.

Aide-mémoire rapide

Quelques commandes pour bien démarrer. Pour l’aide-mémoire complet de chaque commande et de ses arguments, consultez la référence des commandes.

Indicateurs globaux

Ces indicateurs fonctionnent sur chaque commande : Vous pouvez passer --output (ou --format) avant ou après la sous-commande. Les résultats de la commande sont envoyés vers la sortie standard dans le format que vous choisissez ; les messages de statut sont toujours envoyés vers la sortie d’erreur standard, de sorte qu’un flux --output json reste un JSON valide que vous pouvez transmettre à un autre outil.

Étapes suivantes

Pour commencer, installez la CLI et connectez-vous. La CLI ne peut pas accéder à vos données avant d’être connectée à votre compte AppSignal.