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

> Liste, crie e atualize os dashboards de uma aplicação a partir do terminal.

O comando `dashboards` gerencia os dashboards de uma aplicação a partir do terminal: lista os existentes, cria um dashboard e atualiza o título ou a descrição de um dashboard.

Cada comando direciona uma aplicação, por nome e ambiente (`--app "MyApp" --environment production`) ou por ID (`--app-id <APP_ID>`, o ID hexadecimal longo da aplicação obtido em `appsignal-cli apps list`). A flag `--environment` só é necessária quando várias aplicações compartilham um nome. Cada comando usa sua organização padrão, a menos que você passe `--org`. Veja [Aplicações e organizações](/cli/apps) para saber como as aplicações são identificadas.

## Listar dashboards

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

A lista inclui o ID de cada dashboard, que você precisa para atualizar um.

## Criar um dashboard

Um novo dashboard precisa de um título e pode receber uma descrição opcional:

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

| Flag                   | Descrição                                                                                      |
| ---------------------- | ---------------------------------------------------------------------------------------------- |
| `--title <title>`      | Título do dashboard (obrigatório)                                                              |
| `--description <text>` | Descrição opcional                                                                             |
| `--app <name>`         | Aplicação onde criar o dashboard (adicione `--environment` quando o nome não for único)        |
| `--environment <env>`  | Ambiente, usado com `--app`                                                                    |
| `--app-id <id>`        | O ID da aplicação (uma string hexadecimal longa), como alternativa a `--app` e `--environment` |
| `--org <slug>`         | Slug da organização (usa seu padrão se omitido)                                                |

## Atualizar um dashboard

Passe o `--id` do dashboard (de `dashboards list`) junto com o novo título:

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

| Flag                   | Descrição                                                                                      |
| ---------------------- | ---------------------------------------------------------------------------------------------- |
| `--id <id>`            | ID do dashboard a atualizar (obrigatório; de `dashboards list`)                                |
| `--title <title>`      | Novo título (obrigatório)                                                                      |
| `--description <text>` | Descrição opcional                                                                             |
| `--app <name>`         | Aplicação à qual o dashboard pertence (adicione `--environment` quando o nome não for único)   |
| `--environment <env>`  | Ambiente, usado com `--app`                                                                    |
| `--app-id <id>`        | O ID da aplicação (uma string hexadecimal longa), como alternativa a `--app` e `--environment` |
| `--org <slug>`         | Slug da organização (usa seu padrão se omitido)                                                |

`--title` é obrigatório mesmo quando você só altera a descrição.

## Próximos passos

Um dashboard visualiza suas métricas. Para ser alertado quando uma cruza um limite, configure [gatilhos de detecção de anomalias](/cli/triggers).