HyperDX for Node.js and Browsers
25
stars
462
commits
TypeScript
primary language
Sep 3, 2026
updated
README
HyperDX JavaScript SDKs
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.
Packages
| 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. |
Documentation
- Product & setup docs: https://www.hyperdx.io/docs
- OpenTelemetry: https://opentelemetry.io/
Development
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:unit
To 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 jest
See CONTRIBUTING.md for the full contributor guide, and AGENTS.md for detailed build/test/style reference.
License
Packages are published under either the MIT or Apache-2.0 license. See the
LICENSE file within each package for details.
Contributors
Similar repos
Languages
TypeScript
69.2%
JavaScript
22.2%
EJS
5.5%
Shell
2.2%
HyperDX for Node.js and Browsers
25
stars
462
commits
TypeScript
primary language
Sep 3, 2026
updated
README
HyperDX JavaScript SDKs
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.
Packages
| 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. |
Documentation
- Product & setup docs: https://www.hyperdx.io/docs
- OpenTelemetry: https://opentelemetry.io/
Development
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:unit
To 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 jest
See CONTRIBUTING.md for the full contributor guide, and AGENTS.md for detailed build/test/style reference.
License
Packages are published under either the MIT or Apache-2.0 license. See the
LICENSE file within each package for details.
Similar repos
Contributors
Languages
TypeScript
69.2%
JavaScript
22.2%
EJS
5.5%
Shell
2.2%