@flexsolutions/flex-trace-node

SDK Node.js do Flex Trace — monitoramento de exceções e releases, estilo Sentry. Zero dependências, fila em memória com flush em batch e falha sempre silenciosa: sua aplicação nunca fica lenta (nem quebra) por causa do monitoramento.

Requer Node.js ≥ 20.

Instalação

npm install @flexsolutions/flex-trace-node

Uso

// instrument.js — importe antes de qualquer outra coisa no seu entrypoint
import * as FlexTrace from '@flexsolutions/flex-trace-node'

FlexTrace.init({
  dsn: 'https://seu-flex-trace.exemplo.com/api/ingest/SUA_PUBLIC_KEY',
  environment: process.env.NODE_ENV,
  release: process.env.APP_VERSION // opcional, habilita release tracking/regressões
})

init() instala handlers de uncaughtException e unhandledRejection automaticamente.

Captura manual

FlexTrace.captureException(err, {
  tags: { modulo: 'faturamento' },
  user: { id: '42', email: '[email protected]' }
})
FlexTrace.captureMessage('algo estranho aconteceu', 'warning')
FlexTrace.addBreadcrumb({ category: 'job', message: 'iniciando processamento' })
await FlexTrace.flush() // força envio (ex.: antes de encerrar um script)

Integração com frameworks

// Express — depois das rotas:
app.use(FlexTrace.expressErrorHandler())

// Fastify:
FlexTrace.fastifyPlugin()(app)

Ambos capturam o contexto da requisição (URL, método, headers, body) junto do erro.

Licença

MIT © Flex Soluções