SDKs

SDK JavaScript Node/Bun

Instrumentação backend para Node.js e Bun

Instalação

npm install @obtrace/sdk-js
# ou
bun add @obtrace/sdk-js

Configuração

import { initNodeSDK, SemanticMetrics } from "@obtrace/sdk-js/node";
 
const sdk = initNodeSDK({
  apiKey: process.env.OBTRACE_API_KEY!,
  tenantId: process.env.OBTRACE_TENANT_ID,
  projectId: process.env.OBTRACE_PROJECT_ID,
  appId: "checkout-api",
  env: process.env.OBTRACE_ENV,
  serviceName: "checkout-api",
  serviceVersion: process.env.OBTRACE_SERVICE_VERSION
});

Identidade canônica de runtime

const runtimeAttrs = {
  "cloud.region": process.env.AWS_REGION ?? "us-east-1",
  "deployment.ring": process.env.DEPLOYMENT_RING ?? "stable",
};

Início rápido

sdk.log("info", "service.started");
sdk.metric(SemanticMetrics.runtimeCpuUtilization, 0.42);
sdk.span({
  name: "db.query",
  attrs: {
    "db.system": "postgresql",
    "feature.name": "checkout",
    "cloud.region": runtimeAttrs["cloud.region"],
  },
});
await sdk.shutdown();

Checklist de validação

  • o mesmo serviceName, env e serviceVersion aparece entre deploys
  • um caminho real emite log e trace
  • não existe 401/403 na submissao OTLP

Nesta página