@fd-fastest/tracer-next

Server-side fetch tracing for Next.js applications.

Installation

pnpm add @fd-fastest/tracer-next

Usage

1. Add instrumentation

Create instrumentation.ts in your Next.js root:

export { register } from '@fd-fastest/tracer-next/instrumentation';

2. Create spans endpoint

Create app/__fdfast/spans/route.ts:

export { GET } from '@fd-fastest/tracer-next/route';

3. Access spans

Visit http://localhost:3000/__fdfast/spans to see fetch traces.

Example Response

{
  "spans": [
    {
      "t": "fetch",
      "url": "https://api.example.com/data",
      "method": "GET",
      "status": 200,
      "dur": 45.3,
      "ts": 1705324800000
    }
  ],
  "count": 1,
  "timestamp": 1705324800500
}

Features

• ✅ Automatic fetch patching
• ✅ Timing information
• ✅ Status codes
• ✅ Buffer size limiting (2000 spans)
• ✅ Zero configuration

License

MIT