--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 par nom ou message ; ouvrez les détails d’un incident ; mettez à jour son état, sa gravité ou ses personnes assignées ; et ajoutez des notes.
- Déclencheurs : listez, créez, mettez à jour et archivez les déclencheurs de détection d’anomalies.
- 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.
Indicateurs globaux
Ces indicateurs fonctionnent sur chaque commande :| Indicateur | Description |
|---|---|
--output <value> (-o) | Affiche les résultats au format human (par défaut) ou json. --format est un synonyme. |
--help (-h) | Affiche l’utilisation, les sous-commandes et les options pour n’importe quelle commande (par exemple, appsignal-cli logs tail --help). |
--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.
Installation
La CLI fonctionne sur macOS et Linux, sur les machines Intel (x86_64) et Apple Silicon / ARM (arm64). Les distributions Linux basées sur musl, comme Alpine, sont également prises en charge.
- Homebrew
- Script d'installation (macOS & Linux)
Installez la formule. Homebrew tape Pour mettre à jour ultérieurement, exécutez :
appsignal/appsignal-cli automatiquement :Vous préférez ne pas transmettre un script à votre shell ? Téléchargez directement le binaire pour votre plateforme depuis la dernière version.
Vérifier l’installation
Vérifiez que la CLI est dans votrePATH :
Shell
appsignal-cli about pour un aperçu de votre configuration, y compris sa version, son point de terminaison, son organisation par défaut et son statut d’authentification :
Shell
Auth: Not authenticated et vous orientera vers les commandes à exécuter ensuite.