# stread-track

> APM (Application Performance Monitoring) interno da Stread para backends Node.js: latência p50/p95/p99 por endpoint, traces em waterfall, detecção automática de N+1 e loops, logs centralizados, alertas por e-mail e WhatsApp, IA Insights e servidor MCP para agentes de código. Instrumentação em três linhas com o pacote `stread-track-sdk`.

## Páginas

- [Início](https://track.stread.com.br/): o que é, como funciona, vídeos, recursos, integração, MCP e FAQ.
- [Privacidade](https://track.stread.com.br/privacidade/): o que é coletado, retenção e acesso.

## Fatos

- SDK: `stread-track-sdk`, zero dependências de runtime, Node >= 20. Suporta Express, NestJS (platform-express), Next.js App Router (runtime Node), `pg.Pool`, `fetch` e spans manuais. Logs via pino, winston e Nest logger.
- Integração Express: `const tracker = createTracker({ apiKey, serviceName }); app.use(tracker.express());`. Para pg: `tracker.instrumentPg(pool)`. Para Next.js: `export const GET = tracker.wrapNextRoute(handler)`.
- Ingestão: `POST /v1/ingest` com header `x-stread-track-key: stk_...`, lotes a cada 2 s ou 200 spans. Qualquer linguagem pode enviar o JSON do contrato.
- Detectores por trace: N+1 (>= 10 spans db.query iguais sob o mesmo pai), LOOP (http.client/custom repetidos), SLOW_ENDPOINT (> 1000 ms), ERROR (5xx ou exceção). Issues têm fingerprint estável e contagem.
- Alertas: request_spike, error_rate, status_5xx_burst, p95_regression, slow_query_onset, timeouts, critical_issue. Canais e-mail (Resend) e WhatsApp (Cloud API), cooldown 30 min por fingerprint.
- Logs: `POST /v1/logs`, busca por texto, frase, `key=value` e `~trigram`, retenção 7 dias, tail ao vivo.
- IA Insights: responde perguntas, diagnostica traces e explica issues usando só metadados de spans via tools.
- MCP: `npx -y stread-track-mcp` com tools track_status, track_list_projects, track_create_project, track_get_overview, track_list_endpoints, track_list_issues, track_get_trace, track_search_logs, track_instrumentation_guide, track_verify_ingest e o prompt `instrument-project`.
- Uso: ferramenta interna da Stread, sem plano público. Retenção padrão: spans 14 dias, logs 7 dias.