All 15 Advanced Node.js questions
More in Advanced Node.js
What is the libuv library, and what specific role does it play inside Node.js? How do you use the --inspect flag and Chrome DevTools to profile a running Node.js application in production? What is the difference between process.nextTick(), setImmediate(), and setTimeout(fn, 0) in terms of execution order? What is V8's hidden class mechanism, and why does it matter for writing performant Node.js code? What is backpressure in Node.js streams, and how do you handle it correctly when piping data? What is the AsyncLocalStorage API, and what problem does it solve for tracking context across asynchronous calls? How does Node.js implement the Worker Threads module differently from Child Processes, and when should each be used? What is monkey-patching in the context of Node.js APM (Application Performance Monitoring) tools, and what are its risks? What is the node:diagnostics_channel module, and how does it differ from simply emitting a custom event? How do you detect and prevent event loop blocking in a long-running Node.js service?
Advertisement
Node.js › Advanced Node.js

What are Node.js's built-in diagnostic reports, and how do you generate one?

Advanced

Answer

A diagnostic report (enabled via --report-uncaught-exception, --report-on-signal, or triggered programmatically) is a JSON snapshot of the process's state at a point in time -- including JavaScript and native stack traces, heap statistics, loaded modules, environment variables, and resource usage -- useful for post-mortem analysis of crashes or hangs in production without needing to reproduce the issue.
// Trigger a report on demand from within the process
const { writeReport } = require('node:process').report;
writeReport('report.json');

// Or generate one automatically on uncaught exceptions
// node --report-uncaught-exception --report-on-fatalerror app.js
Real-world example A production service that occasionally hangs under load is configured with --report-on-signal so operators can send SIGUSR2 to the process during a hang, capturing a full diagnostic report for offline analysis without restarting or losing the in-progress state.

Common follow-ups: What specific information does a diagnostic report include that a simple stack trace doesn't?;How do you configure a report to be generated automatically on an unhandled promise rejection?

Debugging & Diagnostics;Error Handling
All 15 Advanced Node.js questions