Next.js integration

​

Registration path

1. stacknext dev starts the collector and the project’s dev script.
2. Next.js loads instrumentation.ts and calls register().
3. registerStackNext() checks for an existing OpenTelemetry provider.
4. StackNext attaches a span processor and exporter when it owns the provider.
5. Documented Next.js spans are normalized and sent to the loopback collector.
6. onRequestError sends redacted request errors.

​

What is captured

• Documented next.* request, route, render, fetch, action and proxy spans.
• HTTP attributes and parent ids preserved from Next.js.
• Drizzle or Prisma query events when an adapter is registered.
• Errors passed to the Next.js error hook.
• Custom spans and wrapped actions from @stacknext/next.

​

Existing OpenTelemetry setup

import {
  registerStackNext,
  onRequestError as stackNextOnRequestError,
} from '@stacknext/next'

export async function register() {
  // Keep your existing monitoring setup.
  await registerStackNext()
}

// Only when the file does not already export an error hook:
export const onRequestError = stackNextOnRequestError

​

Supported versions

​

Related

• Installation
• Instrumentation coverage
• Custom instrumentation
• Configuration