Skip to content
Nexload SDK

Overview & Quick Start

Node.js & Container Observability

@nexload-sdk/healthcheck-node

v2.1.0 Stable Released

Node.js runtime, process, cgroup, TCP, and DNS adapters for @nexload-sdk/healthcheck.

Node.jsLinux containers
View on npm Browse source

@nexload-sdk/healthcheck-node equips @nexload-sdk/healthcheck with Node.js runtime introspection, process telemetry, Linux cgroup v1/v2 container resource limits, and TCP/DNS dependency checks.

10-Second Code Snippet

Section titled “10-Second Code Snippet”
import { createHealthManager, memoryCheck, shutdownCheck } from "@nexload-sdk/healthcheck";
import {
  containerResourceCheck,
  nodeRuntimeAdapter,
  processMetricsCollector,
} from "@nexload-sdk/healthcheck-node";


export const health = createHealthManager({
  service: { name: "node-service" },
  runtime: nodeRuntimeAdapter(),
  checks: [shutdownCheck(), memoryCheck(), containerResourceCheck()],
  collectors: [processMetricsCollector()],
});


const report = await health.run("readiness");
console.log(report.status, report.runtime.name); // "ok", "node"

What You Get

Section titled “What You Get”
  • Node.js Runtime Adapter: Exposes V8 heap memory stats, event loop delays, process uptime, and active handle counts.
  • Linux Container & Cgroup Detection: Autodetects Linux cgroup v1 and cgroup v2 memory limits and CPU quotas inside Docker, Kubernetes, or Dokploy containers.
  • Network Dependency Probes: Built-in non-blocking tcpCheck() and dnsCheck() to verify database reachability and DNS resolution.
  • Process & Container Collectors: Observational collectors that append telemetry without failing deployment health probes.

Installation & Requirements

Section titled “Installation & Requirements”
Terminal window
pnpm add @nexload-sdk/healthcheck-node @nexload-sdk/healthcheck

With alternative package managers:

Terminal window
# npm
npm install @nexload-sdk/healthcheck-node @nexload-sdk/healthcheck


# bun
bun add @nexload-sdk/healthcheck-node @nexload-sdk/healthcheck

Requires Node.js >=20.9.0.

Next Steps

Section titled “Next Steps”