Pular para o conteúdo principal
A AppSignal CLI traz seus dados de monitoramento para o terminal, para que você possa trabalhar no mesmo shell em que roda seus testes e deploys. Acompanhe logs conforme chegam, pesquise incidentes e os encerre, e gerencie triggers de detecção de anomalias, tudo sem abrir a interface web. É um binário único feito em Rust, então não há nada mais para instalar. A CLI foi feita para dois tipos de usuários: pessoas e agentes de IA. Por padrão, todo comando imprime saída legível por humanos; passe --output json e ela retorna JSON legível por máquina. Em outras palavras, a mesma ferramenta que você usa durante um incidente também pode alimentar dados estruturados para um agente de programação. Ela inclui ainda uma AppSignal agent skill: um conjunto de instruções que ensina um agente como Claude ou Codex a usar a CLI. Instale-a com appsignal-cli skill install.
A CLI conversa com os mesmos dados do AppSignal que a interface do app e o AppSignal MCP. Ela é um portal para dados que o AppSignal já tem. Se seu app não está enviando logs, logs tail não vai mostrar nada.

​
O que você pode fazer

  • Logs: acompanhe linhas de log conforme chegam, ou pesquise em um intervalo de tempo com a sintaxe de consulta do AppSignal. Filtre por severidade ou origem, aplique log views salvas e liste as views e fontes de um app. Crie e gerencie métricas derivadas de log e triggers baseados em log a partir dos seus dados de log.
  • Incidentes: liste incidentes de exceção, performance e anomalia, e pesquise os de exceção e performance por nome ou mensagem; abra os detalhes de um incidente; atualize seu estado, severidade ou responsáveis; e adicione notas.
  • Triggers: liste, crie, atualize e arquive triggers de detecção de anomalias.
  • Dashboards: liste, crie e atualize os dashboards do seu app.
  • Apps: liste suas aplicações, encontre um app pelo nome e inspecione seus usuários, notifiers, namespaces, dashboards e deploy markers.
  • Configuração de projeto: crie uma configuração local do projeto para que comandos executados em um repositório usem por padrão a organização correta.
  • Agent skill: instale a skill do AppSignal incluída no seu agente de IA, atualize-a e verifique se está atual.

​
Flags globais

Estas flags funcionam em todos os comandos:
FlagDescrição
--output <value> (-o)Renderiza os resultados como human (o padrão) ou json. --format é um sinônimo.
--help (-h)Mostra uso, subcomandos e opções de qualquer comando (por exemplo, appsignal-cli logs tail --help).
Você pode passar --output (ou --format) antes ou depois do subcomando. Os resultados do comando vão para a saída padrão no formato escolhido; mensagens de status sempre vão para a saída de erro padrão, então um fluxo --output json permanece um JSON válido que você pode encaminhar para outra ferramenta.

​
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.
Instale a fórmula. O Homebrew faz o tap de appsignal/appsignal-cli automaticamente:
brew install appsignal/appsignal-cli/appsignal-cli
Para atualizar depois, execute:
brew upgrade appsignal-cli
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 seu PATH:
Shell
appsignal-cli --version
Em seguida, execute 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
appsignal-cli about
Antes de você autenticar, aparecerá Auth: Not authenticated e ele indicará os comandos a executar em seguida.

​
Próximos passos

Você instalou a CLI, mas ela não consegue acessar seus dados até que você faça login. Vá para Autenticação para conectar a CLI à sua conta do AppSignal.