Pular para o conteúdo principal
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:
Shell
appsignal-cli apps set-org --org <YOUR_ORG_SLUG>
Para ver o padrão atual:
Shell
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 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:
Shell
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:
Shell
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:
Shell
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:
ComandoMostra
apps resources allTodos os recursos abaixo, em uma única chamada
apps resources usersUsuários com acesso à aplicação
apps resources notifiersNotificadores configurados
apps resources namespacesOs namespaces da aplicação
apps resources dashboardsDashboards personalizados
apps resources deploy-markersMarcadores 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:
Shell
appsignal-cli apps resources namespaces --app "MyApp" --environment production
Para obter tudo de uma vez como JSON, para alimentar outra ferramenta:
Shell
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 ou acompanhe seus logs a partir do terminal.