Skip to main content
These diagnostics guides were created by the Diagnostics Working Group and the Node.js Website Team with the objective of providing guidance when diagnosing an issue in a user’s application. The documentation project is organized based on user journey. Those journeys are a coherent set of step-by-step procedures that a user can follow to root-cause their issues.

Journeys

Live debugging

Attach a debugger to a running Node.js process, set breakpoints, and inspect variables step by step.

Memory

Diagnose memory leaks, out-of-memory crashes, and inefficient memory usage using heap snapshots, heap profiling, and GC traces.

Poor performance

Profile CPU usage with the V8 sampling profiler or Linux perf to identify hot functions and bottlenecks.

Flame graphs

Visualize CPU time spent in functions with flame graphs to pinpoint synchronous bottlenecks.

Build docs developers (and LLMs) love