Instalação
A CLI roda em macOS e Linux, tanto em máquinas Intel (x86_64) quanto Apple Silicon / ARM (arm64). Distribuições Linux baseadas em musl, como Alpine, também são suportadas.
- Homebrew
- Script de instalação (macOS & Linux)
Instale a fórmula. O Homebrew faz o tap de Para atualizar depois, execute:Para receber atualizações e correções de bugs e de segurança, siga as etapas de atualização.
appsignal/appsignal-cli automaticamente:Prefere não encaminhar um script para o seu shell? Baixe o binário para sua plataforma diretamente da última release.
Verifique a instalação
Verifique se a CLI está no seuPATH:
Shell
appsignal-cli about para uma visão geral da sua configuração, incluindo sua versão, endpoint, organização padrão e status de autenticação:
Shell
Auth: Not authenticated e ele indicará os comandos a executar em seguida.
Autenticação
Antes que a CLI possa acessar seus dados, você precisa fazer login. Ela usa OAuth, um login baseado em navegador, então você nunca precisa copiar ou armazenar um token manualmente. Você pode verificar se está autenticado a qualquer momento comappsignal-cli auth status.
Execute:
Shell
http://127.0.0.1:9789/callback. Uma vez aprovado, a CLI armazena os tokens e os renova para você, então você não precisará fazer login novamente.
O fluxo do navegador precisa de um navegador na mesma máquina da CLI.
O que a CLI pode acessar
Na tela de autorização, escolha uma Organization. Em Applications, marque as aplicações que a CLI pode acessar, ou deixe todas desmarcadas para dar a ela acesso a todas as aplicações dessa organização. A CLI só vê essa organização e essas aplicações. Ela não vê aplicações desativadas nem aplicações às quais você não tem mais acesso.Definir uma organização padrão
Se você pertence a mais de uma organização, defina um padrão enquanto faz login, para não precisar passá-lo em cada comando:Shell
appsignal.com/<org-slug>. Executar appsignal-cli apps list depois de fazer login também salva a organização da sua conta como o padrão.
Verificar seu status
Para ver se você está autenticado e qual configuração a CLI está lendo, execute:Shell
appsignal-cli about mostra o mesmo status de autenticação junto com sua versão, endpoint e organização padrão.
Fazer logout
Para remover suas credenciais armazenadas:Shell
Onde suas credenciais ficam
A CLI armazena suas credenciais em um arquivo de configuração global, no diretório de configuração padrão do seu sistema operacional. A localização exata varia por SO, então executeappsignal-cli auth status para ver o caminho que a CLI está usando.
Configuração local do projeto
Você também pode manter a configuração junto com um projeto, em um arquivo.appsignal.toml no diretório do projeto. Crie um com:
Shell
Shell
.appsignal.toml local de projeto está presente, a CLI usa o mais próximo como a única configuração para comandos executados nesse diretório ou em seus subdiretórios. Para a lista completa de chaves de configuração e como elas se resolvem, veja Configuração.
project init não copia suas credenciais OAuth globais para a configuração do projeto. Após criá-la, execute appsignal-cli auth login novamente dentro do projeto para configurar credenciais específicas do projeto.