Node.js servers

Single foam.init() at app entry. Wires up OTLP traces, logs, and metrics; patches console.* to OTel logs; captures uncaught exceptions and unhandled rejections. Pass getNodeAutoInstrumentations() to opt into HTTP, Express, and database-driver instrumentations.

npm install @foam-ai/node@alpha

Browser apps

Drop-in foam.init() that captures page loads, route transitions, Web Vitals (LCP, FID, CLS, INP), XHR / Fetch, and resource loading. Propagates trace context to your backend so client and server traces stitch together.

npm install @foam-ai/browser

Next.js on Vercel

Returns a registerOTel-compatible config object pre-wired for Foam: trace exporter, log processor, and optional metric reader. Spread into @vercel/otel's registerOTel call in your instrumentation.ts hook.

npm install @vercel/otel @foam-ai/vercel-otel

Ruby on Rails

Initializer-based setup; exports via OTLP. Auto-instruments Rails controllers & routing, Active Record, Action Pack / View / Mailer, Active Job, and Rack middleware.

gem 'foam-ruby'

Next.js sourcemap upload

Build-time plugin that generates, uploads, and cleans up production sourcemaps during `next build`. Pair with @foam-ai/vercel-otel or @foam-ai/node to get readable stack traces in production traces.

npm install --save-dev @foam-ai/next