@equipe-tech/observability-cli

CLI da plataforma de observabilidade da Equipe Tech para operar a stack local, provisionar assets do Collector e criar ambientes remotos isolados.

Requisito de runtime

A CLI exige Bun 1.4 ou posterior. O executável publicado usa #!/usr/bin/env bun; instalar o pacote com npm não substitui esse requisito.

Instalação

npm install --global @equipe-tech/observability-cli
observability --help

Também pode ser executada sem instalação global:

npx @equipe-tech/observability-cli --help

Capacidades

• observability dev up|status|down opera o Collector e o viewer locais.
• observability provision gera a configuração de produção do Collector e o accessory Kamal.
• Os comandos de autenticação e ambiente provisionam recursos específicos de Axiom e Sentry e armazenam credenciais locais com modo restrito.
• Os assets de produção incluem filas persistentes limitadas, retry, health check, métricas internas, normalização de ambiente e redação de dados sensíveis.

A stack local usa um diretório por versão em OBSERVABILITY_HOME, cujo padrão é ~/.local/state/observability. A CLI 0.2.1 usa o diretório ativo 0.2.1. Derrube uma stack iniciada por versão anterior antes de atualizar; a CLI atual não reutiliza nem remove automaticamente o diretório anterior.

A dependência direta @effect/[email protected] impede que instaladores npm selecionem uma release candidate posterior incompatível com @effect/[email protected]. Remova o pin somente quando todo o conjunto Effect for atualizado e validado em conjunto.

Consulte a referência completa da CLI e o guia operacional do Collector.

Licença

Apache-2.0