Sentinela

Releases e sourcemaps

Recomendado para stack traces legíveis. No seu pipeline de deploy do frontend:

npx @sentinela/cli releases new "meuapp@${VERSION}" --commit $GIT_SHA
npx @sentinela/cli sourcemaps upload ./dist --release "meuapp@${VERSION}"
npx @sentinela/cli deploys notify --env production
# usa SENTINELA_SECRET_TOKEN do ambiente do CI — nunca commite o token

E injete a versão no bundle — o plugin Vite/Webpack do CLI define __APP_VERSION__. Com isso você ganha stack traces des-minificados, saúde por release e detecção de regressão.

Content-Security-Policy

Se o seu sistema usa CSP, libere:

script-src  https://cdn.SEU_DOMINIO;
connect-src https://ingest.SEU_DOMINIO https://cdn.SEU_DOMINIO;
img-src     data: blob:;   // pré-visualização das capturas

Checklist de integração

  • Loader no template base com async — não hospede cópia local (quebra o auto-update).
  • setUser no login E setUser(null) no logout.
  • environment distinto para produção e homologação.
  • release injetada no build + upload de sourcemaps no CI.
  • Token secreto só no CI/backend; DSN público pode ir no frontend.
  • Origem do sistema cadastrada em Projeto → Origens permitidas.
  • Teste de fumaça: Sentinela.captureMessage('integração ok') e abra um chamado de teste pelo widget.