> ## 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.

# Tableaux de bord

> Listez, créez et mettez à jour les tableaux de bord d'une application depuis le terminal.

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](/cli/apps) pour savoir comment les applications sont identifiées.

## Lister les tableaux de bord

```sh Shell theme={null}
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 :

```sh Shell theme={null}
appsignal-cli dashboards create --app "MyApp" --environment production \
  --title "Checkout health" --description "Latency and error rate for checkout"
```

| Option                 | Description                                                                                                |
| ---------------------- | ---------------------------------------------------------------------------------------------------------- |
| `--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 :

```sh Shell theme={null}
appsignal-cli dashboards update --id <DASHBOARD_ID> --app "MyApp" --environment production \
  --title "Checkout health" --description "Updated description"
```

| Option                 | Description                                                                                                  |
| ---------------------- | ------------------------------------------------------------------------------------------------------------ |
| `--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](/cli/triggers).