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

# Aplicações e organizações

> Encontre e inspecione suas aplicações a partir do terminal, defina uma organização padrão e veja os usuários, namespaces, dashboards e marcadores de deploy de uma aplicação.

A maioria dos comandos da CLI atua em uma única aplicação em um único ambiente, então antes de acompanhar logs ou listar incidentes, você precisa saber quais aplicações tem e como nomeá-las. Esta página cobre listar suas aplicações, definir uma organização padrão e inspecionar os recursos de uma aplicação.

## Organizações

Suas aplicações vivem sob uma organização, identificada por seu slug: o nome curto na sua URL do AppSignal, `appsignal.com/<org-slug>`. A CLI trabalha com a organização vinculada à sua conta autenticada.

### Definir uma organização padrão

A maioria dos comandos recorre a uma organização padrão, então você não precisa passar `--org` toda vez. Executar `appsignal-cli apps list` determina a organização da sua conta e a salva como padrão. Para defini-la ou alterá-la você mesmo:

```sh Shell theme={null}
appsignal-cli apps set-org --org <YOUR_ORG_SLUG>
```

Para ver o padrão atual:

```sh Shell theme={null}
appsignal-cli apps show-org
```

Você também pode definir o padrão durante o login com `appsignal-cli auth login --org <YOUR_ORG_SLUG>`, ou por projeto com `appsignal-cli project init --org <YOUR_ORG_SLUG>`. Veja [Autenticação](/cli/authentication) para entender como as configurações globais e locais do projeto se relacionam.

## Aplicações

Para listar as aplicações da organização da sua conta:

```sh Shell theme={null}
appsignal-cli apps list
```

Isso também salva sua organização como o padrão para comandos posteriores, então você não precisa passar `--org` para eles.

### Encontrar uma aplicação por nome

Para procurar uma aplicação específica por nome, opcionalmente restringindo a um ambiente:

```sh Shell theme={null}
appsignal-cli apps find --name "MyApp" --environment production
```

O nome e o ambiente são ambos insensíveis a maiúsculas/minúsculas. Esta é a forma mais rápida de confirmar o nome exato e o ambiente da aplicação que outros comandos esperam.

### Mostrar detalhes de uma aplicação

Se você souber o ID de uma aplicação, pode buscar seus detalhes diretamente:

```sh Shell theme={null}
appsignal-cli apps info --app-id <APP_ID>
```

## Como os comandos identificam uma aplicação

Comandos que atuam em uma única aplicação a aceitam de duas maneiras:

* **Pelo nome:** `--app "MyApp"`. Adicione `--environment production` somente quando mais de uma aplicação compartilhar o nome.
* **Pelo ID:** `--app-id <APP_ID>`, o valor da coluna `ID` de `appsignal-cli apps list` (uma string hexadecimal longa). Um ID identifica uma aplicação específica e seu ambiente por si só, então você não passa `--environment` com ele.

Use o que você tiver. Um nome é mais fácil de ler e digitar; o ID é inequívoco e conveniente em scripts.

## Inspecionar os recursos de uma aplicação

Os comandos `apps resources` mostram a configuração e os metadados anexados a uma aplicação:

| Comando                         | Mostra                                         |
| ------------------------------- | ---------------------------------------------- |
| `apps resources all`            | Todos os recursos abaixo, em uma única chamada |
| `apps resources users`          | Usuários com acesso à aplicação                |
| `apps resources notifiers`      | Notificadores configurados                     |
| `apps resources namespaces`     | Os namespaces da aplicação                     |
| `apps resources dashboards`     | Dashboards personalizados                      |
| `apps resources deploy-markers` | Marcadores de deploy recentes                  |

Cada um aceita o mesmo seletor de aplicação que outros comandos, seja `--app` com `--environment` ou `--app-id`, e usa sua organização padrão a menos que você passe `--org`. Por exemplo, para ver os namespaces de uma aplicação:

```sh Shell theme={null}
appsignal-cli apps resources namespaces --app "MyApp" --environment production
```

Para obter tudo de uma vez como JSON, para alimentar outra ferramenta:

```sh Shell theme={null}
appsignal-cli apps resources all --app "MyApp" --environment production --output json
```

## Próximos passos

Uma vez que você sabe o nome e o ambiente de uma aplicação, pode começar a consultá-la. Inspecione seus [incidentes](/cli/incidents) ou acompanhe seus [logs](/cli/logs) a partir do terminal.