Vercel Integration

Obtrace SDK setup for Next.js on Vercel

Install

npm install @obtrace/sdk-js

Configuration

Server:

  • OBTRACE_API_KEY
  • OBTRACE_INGEST_BASE_URL
  • OBTRACE_TENANT_ID
  • OBTRACE_PROJECT_ID
  • OBTRACE_ENV

Client:

  • NEXT_PUBLIC_OBTRACE_API_KEY
  • NEXT_PUBLIC_OBTRACE_INGEST_BASE_URL
  • NEXT_PUBLIC_OBTRACE_TENANT_ID
  • NEXT_PUBLIC_OBTRACE_PROJECT_ID

Quick start

Server (Node runtime):

import { initNodeSDK } from "@obtrace/sdk-js/node";
 
export const obtrace = initNodeSDK({
  apiKey: process.env.OBTRACE_API_KEY!,
  ingestBaseUrl: process.env.OBTRACE_INGEST_BASE_URL!,
  serviceName: "vercel-api",
  appId: "vercel-api"
});

Client:

import { initBrowserSDK } from "@obtrace/sdk-js/browser";

Production hardening

  1. Never expose server keys to browser bundles.
  2. Isolate preview and production keys.
  3. Restrict ingest origin allowlist.

Troubleshooting

  • No client telemetry: verify NEXT_PUBLIC_* variables.
  • No server telemetry: validate runtime and server env vars.

On this page