JavaScript/TypeScript SDKs for HyperDX, built on OpenTelemetry. This monorepo contains the browser and Node.js instrumentation libraries, logger transports, framework integrations, and the sourcemap-upload CLI.
| Package | npm | Description |
|---|---|---|
node-opentelemetry |
@hyperdx/node-opentelemetry |
Main Node.js OpenTelemetry SDK (auto-instrumentation, logs, traces, metrics). |
node-logger |
@hyperdx/node-logger |
Winston, Pino, and NestJS logger transports. |
browser |
@hyperdx/browser |
Browser SDK for real user monitoring and session replay. |
otel-web |
@hyperdx/otel-web |
OpenTelemetry-based RUM core (consumed via @hyperdx/browser). |
session-recorder |
@hyperdx/otel-web-session-recorder |
Session recording (consumed via @hyperdx/browser). |
instrumentation-exception |
@hyperdx/instrumentation-exception |
Exception capture instrumentation (used internally by the SDKs). |
instrumentation-sentry-node |
@hyperdx/instrumentation-sentry-node |
Bridges @sentry/node events into OpenTelemetry. |
cli |
@hyperdx/cli |
Command line tool for uploading sourcemaps. |
deno |
@hyperdx/deno |
OpenTelemetry logging support for Deno. |
- Product & setup docs: https://www.hyperdx.io/docs
- OpenTelemetry: https://opentelemetry.io/
This is a Yarn workspaces monorepo,
orchestrated with Nx and versioned with
Changesets. Node v25 is
recommended (see .nvmrc). The Yarn version is pinned via the packageManager
field in package.json and provided by Corepack;
run corepack enable once so the correct Yarn version is used automatically.
# Install dependencies (from the repo root)
yarn install
# Build, lint, and test all packages (respects dependency order via Nx)
yarn ci:build
yarn ci:lint
yarn ci:unitTo build or test a single package:
# Build one package
npx nx run @hyperdx/node-opentelemetry:build
# Run one package's tests (most packages use Jest)
cd packages/node-opentelemetry && npx jestSee CONTRIBUTING.md for the full contributor guide, and AGENTS.md for detailed build/test/style reference.
Packages are published under either the MIT or Apache-2.0 license. See the
LICENSE file within each package for details.