> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appsignal.com/llms.txt
> Use this file to discover all available pages before exploring further.
# AppSignal CLI
> Interrogez vos données AppSignal depuis le terminal : suivez les logs en temps réel, inspectez les incidents et gérez les déclencheurs sans quitter votre shell.
L'AppSignal CLI apporte vos données de surveillance dans le terminal, afin que vous puissiez travailler depuis le même shell où vous exécutez vos tests et déploiements. Suivez les logs au fur et à mesure qu'ils arrivent, recherchez les incidents et clôturez-les, et gérez les déclencheurs de détection d'anomalies, le tout sans ouvrir l'interface web. C'est un binaire unique construit en Rust, donc il n'y a rien d'autre à installer.
La 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](/cli/skill) : 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](/mcp-server). 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](/logging/query-syntax) 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](/cli/dashboards) 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](/cli/configuration) 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 ` (`-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`). |
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.
## 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.
Installez la formule. Homebrew tape `appsignal/appsignal-cli` automatiquement :
```sh theme={null}
brew install appsignal/appsignal-cli/appsignal-cli
```
Pour mettre à jour ultérieurement, exécutez :
```sh theme={null}
brew upgrade appsignal-cli
```
Installez la dernière version avec la commande en une ligne ci-dessous. Elle nécessite des privilèges super-utilisateur pour installer le binaire dans le chemin système de votre machine, et vérifie le téléchargement par rapport au manifeste `SHA256SUMS` publié avant l'installation :
```sh theme={null}
curl -sSL https://github.com/appsignal/appsignal-cli/releases/latest/download/install.sh | sudo sh
```
Réexécutez la même commande à tout moment pour mettre à jour vers la dernière version.
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](https://github.com/appsignal/appsignal-cli/releases/latest/).
### Vérifier l'installation
Vérifiez que la CLI est dans votre `PATH` :
```sh Shell theme={null}
appsignal-cli --version
```
Puis exécutez `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 :
```sh Shell theme={null}
appsignal-cli about
```
Avant que vous ne vous authentifiiez, il affichera `Auth: Not authenticated` et vous orientera vers les commandes à exécuter ensuite.
## Étapes suivantes
Vous avez installé la CLI, mais elle ne peut pas accéder à vos données tant que vous ne vous êtes pas connecté. Rendez-vous sur [Authentification](/cli/authentication) pour connecter la CLI à votre compte AppSignal.