Instalar
Escolha a plataforma. Todos os SDKs sao TypeScript first e zero-config por padrao.
$ npm i @bugtrace/node
node
import 'bugtrace/node';
// pronto — captura errors, unhandledRejection e uncaughtException
// auto-instrumenta Express, Fastify, Koa, fetch, http, https, workers
// opcional: init explicito
import { init } from '@bugtrace/node';
init({
dsn: process.env.BUGTRACE_DSN,
environment: process.env.NODE_ENV,
release: 'v1.0.0',
});Configurar DSN
Seu DSN e a chave publica do projeto — pode ser exposto no frontend sem risco (nao autoriza leitura, so escrita de eventos).
Encontre no dashboard: /app/projects → SEU_PROJETO → DSN
Dica: use variaveis de ambiente. Nunca commit o DSN no repo publico (mesmo sendo publico — evita spam).
Adicionar contexto
Anexe informacoes do usuario, tags e extras pra cada evento:
context.ts
import { setUser, setTag, setContext } from '@bugtrace/node';
setUser({ id: '123', email: '[email protected]', plan: 'pro' });
setTag('feature', 'checkout');
setContext('cart', { items: 3, total: 297.00 });Source maps
Faca upload dos source maps no deploy pra ter stack traces com codigo original:
deploy.sh
bugtrace releases new v1.2.3 bugtrace releases files v1.2.3 upload ./dist bugtrace releases finalize v1.2.3
Pronto pra rastrear seu primeiro erro?
Crie sua conta free em 30 segundos.