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

# Dashboards

> Listen, erstellen und aktualisieren Sie die Dashboards einer App vom Terminal aus.

Der `dashboards`-Befehl verwaltet die Dashboards einer App vom Terminal aus: vorhandene auflisten, ein Dashboard erstellen und den Titel oder die Beschreibung eines Dashboards aktualisieren.

Jeder Befehl zielt auf eine Anwendung, nach Name und Umgebung (`--app "MyApp" --environment production`) oder nach ID (`--app-id <APP_ID>`, die lange hexadezimale App-ID aus `appsignal-cli apps list`). Das Flag `--environment` wird nur benötigt, wenn mehrere Apps einen Namen teilen. Jeder Befehl verwendet Ihre Standard-Organisation, sofern Sie nicht `--org` übergeben. Siehe [Apps und Organisationen](/cli/apps) für die Identifizierung von Apps.

## Dashboards auflisten

```sh Shell theme={null}
appsignal-cli dashboards list --app "MyApp" --environment production
```

Die Liste enthält die ID jedes Dashboards, die Sie benötigen, um eines zu aktualisieren.

## Ein Dashboard erstellen

Ein neues Dashboard benötigt einen Titel und kann eine optionale Beschreibung haben:

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

| Flag                   | Beschreibung                                                                                                        |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------- |
| `--title <title>`      | Dashboard-Titel (erforderlich)                                                                                      |
| `--description <text>` | Optionale Beschreibung                                                                                              |
| `--app <name>`         | App, in der das Dashboard erstellt werden soll (fügen Sie `--environment` hinzu, wenn der Name nicht eindeutig ist) |
| `--environment <env>`  | Umgebung, wird mit `--app` verwendet                                                                                |
| `--app-id <id>`        | Die ID der App (eine lange hexadezimale Zeichenkette), als Alternative zu `--app` und `--environment`               |
| `--org <slug>`         | Organisations-Slug (verwendet Ihren Standard, wenn weggelassen)                                                     |

## Ein Dashboard aktualisieren

Übergeben Sie die `--id` des Dashboards (aus `dashboards list`) zusammen mit dem neuen Titel:

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

| Flag                   | Beschreibung                                                                                          |
| ---------------------- | ----------------------------------------------------------------------------------------------------- |
| `--id <id>`            | ID des zu aktualisierenden Dashboards (erforderlich; aus `dashboards list`)                           |
| `--title <title>`      | Neuer Titel (erforderlich)                                                                            |
| `--description <text>` | Optionale Beschreibung                                                                                |
| `--app <name>`         | App, zu der das Dashboard gehört (fügen Sie `--environment` hinzu, wenn der Name nicht eindeutig ist) |
| `--environment <env>`  | Umgebung, wird mit `--app` verwendet                                                                  |
| `--app-id <id>`        | Die ID der App (eine lange hexadezimale Zeichenkette), als Alternative zu `--app` und `--environment` |
| `--org <slug>`         | Organisations-Slug (verwendet Ihren Standard, wenn weggelassen)                                       |

`--title` ist auch dann erforderlich, wenn Sie nur die Beschreibung ändern.

## Nächste Schritte

Ein Dashboard visualisiert Ihre Metriken. Um benachrichtigt zu werden, wenn eine einen Schwellenwert überschreitet, richten Sie [Anomaly-Detection-Triggers](/cli/triggers) ein.