Documentação do FG Tracker

O FG Tracker é um APM: mede o tempo de resposta de cada endpoint (p50, p95, p99), grava traces em waterfall, agrupa erros em issues, detecta N+1 e loops e avisa quando algo muda. Os dados chegam por um SDK na sua aplicação e são consultados no painel, pela API HTTP ou por um agente de código via MCP.

O caminho completo

1. Conta: crie em tracker.fortground.com.br/register com e-mail e senha (e confirme o e-mail pelo link) ou com Google ou Meta. O cadastro é feito por você, sem aprovação da equipe.
2. Projeto: o painel pede só o nome. Quem cria vira owner e recebe duas chaves: a de servidor fgsk_… e a pública stk_….
3. Integração: o SDK Node manda spans com a chave de servidor; o SDK de navegador manda erros e fetches com a chave pública.
4. Consulta: o painel mostra traces, endpoints e issues. Para scripts e agentes, crie um token pessoal fgt_… com as permissões necessárias.

Guias e referência

• Primeiro trace em 10 minutosDa conta ao primeiro trace no painel com Node.js e Express: projeto, chave de servidor, SDK, requisição de teste e encerramento.
• Chaves e tokensSessão do painel, token pessoal fgt_, chave pública stk_ e chave de servidor fgsk_: onde cada uma vale, como obter, rotacionar e revogar.
• SDK Node.jsfg-tracker-sdk com Express, NestJS, route handlers do Next.js, Postgres, chamadas HTTP, logs, erros, amostragem e encerramento.
• SDK de navegadorfg-tracker-browser: erros, breadcrumbs, fetch ligado à API e pageviews, com a chave pública e os domínios permitidos.
• AWS LambdaSpans por invocação com wrapLambda e métricas da plataforma com a camada fg-tracker-lambda-extension.
• API HTTPRotas públicas de integração, autenticação, corpo da ingestão, limites, idempotência, erros, paginação e filtros.
• Servidor MCPfg-tracker-mcp em Claude Code, Codex, Cursor, Windsurf e Claude Desktop: token, permissões, ferramentas, confirmação e erros.
• Sem dados no painel?Diagnóstico passo a passo quando o trace não aparece: endpoint, chave, filtros, relógio, encerramento e CORS.

Endereços e versões

O que é suportado

• Node.js ≥ 20 com Express, NestJS sobre Express, route handlers do App Router do Next.js (runtime Node), pg, postgres, saídas HTTP por node:http/node:https e fetch, contexto por SQS e EventBridge, logs com pino, winston e o logger do Nest, AWS Lambda (handlers async) e ECS.
• Navegador: erros, breadcrumbs, fetch e pageviews. XHR (axios) e Web Vitals não são capturados.
• Outras linguagens: enviam o JSON de ingestão direto para POST /v1/ingest (veja a API). Não há SDK oficial fora do Node e do navegador.