Integração Vercel

Setup do Obtrace SDK em aplicações Next.js na Vercel

Instalação

npm install @obtrace/sdk-js

Configuração

Servidor:

  • OBTRACE_API_KEY
  • OBTRACE_TENANT_ID
  • OBTRACE_PROJECT_ID
  • OBTRACE_ENV

Cliente:

  • NEXT_PUBLIC_OBTRACE_API_KEY
  • NEXT_PUBLIC_OBTRACE_TENANT_ID
  • NEXT_PUBLIC_OBTRACE_PROJECT_ID

Início rápido

Servidor (Node runtime):

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

Cliente:

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

Hardening de produção

  1. Nunca use chave de servidor no browser.
  2. Separe chaves de preview e produção.
  3. Restrinja origem permitida no ingest.

Solução de problemas

  • Cliente sem telemetria: valide NEXT_PUBLIC_*.
  • Servidor sem telemetria: confirme env vars e runtime.

Nesta página