1 #include "node_report.h"
2 #include "debug_utils-inl.h"
3 #include "diagnosticfilename-inl.h"
4 #include "env-inl.h"
5 #include "json_utils.h"
6 #include "node_internals.h"
7 #include "node_metadata.h"
8 #include "node_mutex.h"
9 #include "node_worker.h"
10 #include "util.h"
11
12 #ifdef _WIN32
13 #include <Windows.h>
14 #else // !_WIN32
15 #include <cxxabi.h>
16 #include <sys/resource.h>
17 #include <dlfcn.h>
18 #endif
19
20 #include <iostream>
21 #include <cstring>
22 #include <ctime>
23 #include <cwctype>
24 #include <fstream>
25
26 constexpr int NODE_REPORT_VERSION = 3;
27 constexpr int NANOS_PER_SEC = 1000 * 1000 * 1000;
28 constexpr double SEC_PER_MICROS = 1e-6;
29 constexpr int MAX_FRAME_COUNT = 10;
30
31 namespace node {
32 using node::worker::Worker;
33 using v8::Array;
34 using v8::Context;
35 using v8::HandleScope;
36 using v8::HeapSpaceStatistics;
37 using v8::HeapStatistics;
38 using v8::Isolate;
39 using v8::Just;
40 using v8::Local;
41 using v8::Maybe;
42 using v8::MaybeLocal;
43 using v8::Nothing;
44 using v8::Object;
45 using v8::RegisterState;
46 using v8::SampleInfo;
47 using v8::StackFrame;
48 using v8::StackTrace;
49 using v8::String;
50 using v8::TryCatch;
51 using v8::V8;
52 using v8::Value;
53
54 namespace report {
55 // Internal/static function declarations
56 static void WriteNodeReport(Isolate* isolate,
57 Environment* env,
58 const char* message,
59 const char* trigger,
60 const std::string& filename,
61 std::ostream& out,
62 Local<Value> error,
63 bool compact);
64 static void PrintVersionInformation(JSONWriter* writer);
65 static void PrintJavaScriptErrorStack(JSONWriter* writer,
66 Isolate* isolate,
67 Local<Value> error,
68 const char* trigger);
69 static void PrintEmptyJavaScriptStack(JSONWriter* writer);
70 static void PrintJavaScriptStack(JSONWriter* writer,
71 Isolate* isolate,
72 const char* trigger);
73 static void PrintJavaScriptErrorProperties(JSONWriter* writer,
74 Isolate* isolate,
75 Local<Value> error);
76 static void PrintNativeStack(JSONWriter* writer);
77 static void PrintResourceUsage(JSONWriter* writer);
78 static void PrintGCStatistics(JSONWriter* writer, Isolate* isolate);
79 static void PrintSystemInformation(JSONWriter* writer);
80 static void PrintLoadedLibraries(JSONWriter* writer);
81 static void PrintComponentVersions(JSONWriter* writer);
82 static void PrintRelease(JSONWriter* writer);
83 static void PrintCpuInfo(JSONWriter* writer);
84 static void PrintNetworkInterfaceInfo(JSONWriter* writer);
85
86 // Internal function to coordinate and write the various
87 // sections of the report to the supplied stream
WriteNodeReport(Isolate * isolate,Environment * env,const char * message,const char * trigger,const std::string & filename,std::ostream & out,Local<Value> error,bool compact)88 static void WriteNodeReport(Isolate* isolate,
89 Environment* env,
90 const char* message,
91 const char* trigger,
92 const std::string& filename,
93 std::ostream& out,
94 Local<Value> error,
95 bool compact) {
96 // Obtain the current time and the pid.
97 TIME_TYPE tm_struct;
98 DiagnosticFilename::LocalTime(&tm_struct);
99 uv_pid_t pid = uv_os_getpid();
100
101 // Save formatting for output stream.
102 std::ios old_state(nullptr);
103 old_state.copyfmt(out);
104
105 // File stream opened OK, now start printing the report content:
106 // the title and header information (event, filename, timestamp and pid)
107
108 JSONWriter writer(out, compact);
109 writer.json_start();
110 writer.json_objectstart("header");
111 writer.json_keyvalue("reportVersion", NODE_REPORT_VERSION);
112 writer.json_keyvalue("event", message);
113 writer.json_keyvalue("trigger", trigger);
114 if (!filename.empty())
115 writer.json_keyvalue("filename", filename);
116 else
117 writer.json_keyvalue("filename", JSONWriter::Null{});
118
119 // Report dump event and module load date/time stamps
120 char timebuf[64];
121 #ifdef _WIN32
122 snprintf(timebuf,
123 sizeof(timebuf),
124 "%4d-%02d-%02dT%02d:%02d:%02dZ",
125 tm_struct.wYear,
126 tm_struct.wMonth,
127 tm_struct.wDay,
128 tm_struct.wHour,
129 tm_struct.wMinute,
130 tm_struct.wSecond);
131 writer.json_keyvalue("dumpEventTime", timebuf);
132 #else // UNIX, OSX
133 snprintf(timebuf,
134 sizeof(timebuf),
135 "%4d-%02d-%02dT%02d:%02d:%02dZ",
136 tm_struct.tm_year + 1900,
137 tm_struct.tm_mon + 1,
138 tm_struct.tm_mday,
139 tm_struct.tm_hour,
140 tm_struct.tm_min,
141 tm_struct.tm_sec);
142 writer.json_keyvalue("dumpEventTime", timebuf);
143 #endif
144
145 uv_timeval64_t ts;
146 if (uv_gettimeofday(&ts) == 0) {
147 writer.json_keyvalue("dumpEventTimeStamp",
148 std::to_string(ts.tv_sec * 1000 + ts.tv_usec / 1000));
149 }
150
151 // Report native process ID
152 writer.json_keyvalue("processId", pid);
153 if (env != nullptr)
154 writer.json_keyvalue("threadId", env->thread_id());
155 else
156 writer.json_keyvalue("threadId", JSONWriter::Null{});
157
158 {
159 // Report the process cwd.
160 char buf[PATH_MAX_BYTES];
161 size_t cwd_size = sizeof(buf);
162 if (uv_cwd(buf, &cwd_size) == 0)
163 writer.json_keyvalue("cwd", buf);
164 }
165
166 // Report out the command line.
167 if (!per_process::cli_options->cmdline.empty()) {
168 writer.json_arraystart("commandLine");
169 for (const std::string& arg : per_process::cli_options->cmdline) {
170 writer.json_element(arg);
171 }
172 writer.json_arrayend();
173 }
174
175 // Report Node.js and OS version information
176 PrintVersionInformation(&writer);
177 writer.json_objectend();
178
179 if (isolate != nullptr) {
180 writer.json_objectstart("javascriptStack");
181 // Report summary JavaScript error stack backtrace
182 PrintJavaScriptErrorStack(&writer, isolate, error, trigger);
183
184 writer.json_objectend(); // the end of 'javascriptStack'
185
186 // Report V8 Heap and Garbage Collector information
187 PrintGCStatistics(&writer, isolate);
188 } else {
189 writer.json_objectstart("javascriptStack");
190 PrintEmptyJavaScriptStack(&writer);
191 writer.json_objectend(); // the end of 'javascriptStack'
192 }
193
194 // Report native stack backtrace
195 PrintNativeStack(&writer);
196
197 // Report OS and current thread resource usage
198 PrintResourceUsage(&writer);
199
200 writer.json_arraystart("libuv");
201 if (env != nullptr) {
202 uv_walk(env->event_loop(), WalkHandle, static_cast<void*>(&writer));
203
204 writer.json_start();
205 writer.json_keyvalue("type", "loop");
206 writer.json_keyvalue("is_active",
207 static_cast<bool>(uv_loop_alive(env->event_loop())));
208 writer.json_keyvalue("address",
209 ValueToHexString(reinterpret_cast<int64_t>(env->event_loop())));
210
211 // Report Event loop idle time
212 uint64_t idle_time = uv_metrics_idle_time(env->event_loop());
213 writer.json_keyvalue("loopIdleTimeSeconds", 1.0 * idle_time / 1e9);
214 writer.json_end();
215 }
216
217 writer.json_arrayend();
218
219 writer.json_arraystart("workers");
220 if (env != nullptr) {
221 Mutex workers_mutex;
222 ConditionVariable notify;
223 std::vector<std::string> worker_infos;
224 size_t expected_results = 0;
225
226 env->ForEachWorker([&](Worker* w) {
227 expected_results += w->RequestInterrupt([&](Environment* env) {
228 std::ostringstream os;
229
230 GetNodeReport(
231 env, "Worker thread subreport", trigger, Local<Value>(), os);
232
233 Mutex::ScopedLock lock(workers_mutex);
234 worker_infos.emplace_back(os.str());
235 notify.Signal(lock);
236 });
237 });
238
239 Mutex::ScopedLock lock(workers_mutex);
240 worker_infos.reserve(expected_results);
241 while (worker_infos.size() < expected_results)
242 notify.Wait(lock);
243 for (const std::string& worker_info : worker_infos)
244 writer.json_element(JSONWriter::ForeignJSON { worker_info });
245 }
246 writer.json_arrayend();
247
248 // Report operating system information
249 PrintSystemInformation(&writer);
250
251 writer.json_objectend();
252
253 // Restore output stream formatting.
254 out.copyfmt(old_state);
255 }
256
257 // Report Node.js version, OS version and machine information.
PrintVersionInformation(JSONWriter * writer)258 static void PrintVersionInformation(JSONWriter* writer) {
259 std::ostringstream buf;
260 // Report Node version
261 buf << "v" << NODE_VERSION_STRING;
262 writer->json_keyvalue("nodejsVersion", buf.str());
263 buf.str("");
264
265 #ifndef _WIN32
266 // Report compiler and runtime glibc versions where possible.
267 const char* (*libc_version)();
268 *(reinterpret_cast<void**>(&libc_version)) =
269 dlsym(RTLD_DEFAULT, "gnu_get_libc_version");
270 if (libc_version != nullptr)
271 writer->json_keyvalue("glibcVersionRuntime", (*libc_version)());
272 #endif /* _WIN32 */
273
274 #ifdef __GLIBC__
275 buf << __GLIBC__ << "." << __GLIBC_MINOR__;
276 writer->json_keyvalue("glibcVersionCompiler", buf.str());
277 buf.str("");
278 #endif
279
280 // Report Process word size
281 writer->json_keyvalue("wordSize", sizeof(void*) * 8);
282 writer->json_keyvalue("arch", per_process::metadata.arch);
283 writer->json_keyvalue("platform", per_process::metadata.platform);
284
285 // Report deps component versions
286 PrintComponentVersions(writer);
287
288 // Report release metadata.
289 PrintRelease(writer);
290
291 // Report operating system and machine information
292 uv_utsname_t os_info;
293
294 if (uv_os_uname(&os_info) == 0) {
295 writer->json_keyvalue("osName", os_info.sysname);
296 writer->json_keyvalue("osRelease", os_info.release);
297 writer->json_keyvalue("osVersion", os_info.version);
298 writer->json_keyvalue("osMachine", os_info.machine);
299 }
300
301 PrintCpuInfo(writer);
302 PrintNetworkInterfaceInfo(writer);
303
304 char host[UV_MAXHOSTNAMESIZE];
305 size_t host_size = sizeof(host);
306
307 if (uv_os_gethostname(host, &host_size) == 0)
308 writer->json_keyvalue("host", host);
309 }
310
311 // Report CPU info
PrintCpuInfo(JSONWriter * writer)312 static void PrintCpuInfo(JSONWriter* writer) {
313 uv_cpu_info_t* cpu_info;
314 int count;
315 if (uv_cpu_info(&cpu_info, &count) == 0) {
316 writer->json_arraystart("cpus");
317 for (int i = 0; i < count; i++) {
318 writer->json_start();
319 writer->json_keyvalue("model", cpu_info[i].model);
320 writer->json_keyvalue("speed", cpu_info[i].speed);
321 writer->json_keyvalue("user", cpu_info[i].cpu_times.user);
322 writer->json_keyvalue("nice", cpu_info[i].cpu_times.nice);
323 writer->json_keyvalue("sys", cpu_info[i].cpu_times.sys);
324 writer->json_keyvalue("idle", cpu_info[i].cpu_times.idle);
325 writer->json_keyvalue("irq", cpu_info[i].cpu_times.irq);
326 writer->json_end();
327 }
328 writer->json_arrayend();
329 uv_free_cpu_info(cpu_info, count);
330 }
331 }
332
PrintNetworkInterfaceInfo(JSONWriter * writer)333 static void PrintNetworkInterfaceInfo(JSONWriter* writer) {
334 uv_interface_address_t* interfaces;
335 char ip[INET6_ADDRSTRLEN];
336 char netmask[INET6_ADDRSTRLEN];
337 char mac[18];
338 int count;
339
340 if (uv_interface_addresses(&interfaces, &count) == 0) {
341 writer->json_arraystart("networkInterfaces");
342
343 for (int i = 0; i < count; i++) {
344 writer->json_start();
345 writer->json_keyvalue("name", interfaces[i].name);
346 writer->json_keyvalue("internal", !!interfaces[i].is_internal);
347 snprintf(mac,
348 sizeof(mac),
349 "%02x:%02x:%02x:%02x:%02x:%02x",
350 static_cast<unsigned char>(interfaces[i].phys_addr[0]),
351 static_cast<unsigned char>(interfaces[i].phys_addr[1]),
352 static_cast<unsigned char>(interfaces[i].phys_addr[2]),
353 static_cast<unsigned char>(interfaces[i].phys_addr[3]),
354 static_cast<unsigned char>(interfaces[i].phys_addr[4]),
355 static_cast<unsigned char>(interfaces[i].phys_addr[5]));
356 writer->json_keyvalue("mac", mac);
357
358 if (interfaces[i].address.address4.sin_family == AF_INET) {
359 uv_ip4_name(&interfaces[i].address.address4, ip, sizeof(ip));
360 uv_ip4_name(&interfaces[i].netmask.netmask4, netmask, sizeof(netmask));
361 writer->json_keyvalue("address", ip);
362 writer->json_keyvalue("netmask", netmask);
363 writer->json_keyvalue("family", "IPv4");
364 } else if (interfaces[i].address.address4.sin_family == AF_INET6) {
365 uv_ip6_name(&interfaces[i].address.address6, ip, sizeof(ip));
366 uv_ip6_name(&interfaces[i].netmask.netmask6, netmask, sizeof(netmask));
367 writer->json_keyvalue("address", ip);
368 writer->json_keyvalue("netmask", netmask);
369 writer->json_keyvalue("family", "IPv6");
370 writer->json_keyvalue("scopeid",
371 interfaces[i].address.address6.sin6_scope_id);
372 } else {
373 writer->json_keyvalue("family", "unknown");
374 }
375
376 writer->json_end();
377 }
378
379 writer->json_arrayend();
380 uv_free_interface_addresses(interfaces, count);
381 }
382 }
383
PrintJavaScriptErrorProperties(JSONWriter * writer,Isolate * isolate,Local<Value> error)384 static void PrintJavaScriptErrorProperties(JSONWriter* writer,
385 Isolate* isolate,
386 Local<Value> error) {
387 writer->json_objectstart("errorProperties");
388 if (!error.IsEmpty() && error->IsObject()) {
389 TryCatch try_catch(isolate);
390 Local<Object> error_obj = error.As<Object>();
391 Local<Context> context = error_obj->GetIsolate()->GetCurrentContext();
392 Local<Array> keys;
393 if (!error_obj->GetOwnPropertyNames(context).ToLocal(&keys)) {
394 return writer->json_objectend(); // the end of 'errorProperties'
395 }
396 uint32_t keys_length = keys->Length();
397 for (uint32_t i = 0; i < keys_length; i++) {
398 Local<Value> key;
399 if (!keys->Get(context, i).ToLocal(&key) || !key->IsString()) {
400 continue;
401 }
402 Local<Value> value;
403 Local<String> value_string;
404 if (!error_obj->Get(context, key).ToLocal(&value) ||
405 !value->ToString(context).ToLocal(&value_string)) {
406 continue;
407 }
408 node::Utf8Value k(isolate, key);
409 if (k == "stack" || k == "message") continue;
410 node::Utf8Value v(isolate, value_string);
411 writer->json_keyvalue(k.ToStringView(), v.ToStringView());
412 }
413 }
414 writer->json_objectend(); // the end of 'errorProperties'
415 }
416
ErrorToString(Isolate * isolate,Local<Context> context,Local<Value> error)417 static Maybe<std::string> ErrorToString(Isolate* isolate,
418 Local<Context> context,
419 Local<Value> error) {
420 if (error.IsEmpty()) {
421 return Nothing<std::string>();
422 }
423
424 MaybeLocal<String> maybe_str;
425 // `ToString` is not available to Symbols.
426 if (error->IsSymbol()) {
427 maybe_str = error.As<v8::Symbol>()->ToDetailString(context);
428 } else if (!error->IsObject()) {
429 maybe_str = error->ToString(context);
430 } else if (error->IsObject()) {
431 MaybeLocal<Value> stack = error.As<Object>()->Get(
432 context, FIXED_ONE_BYTE_STRING(isolate, "stack"));
433 if (!stack.IsEmpty() && stack.ToLocalChecked()->IsString()) {
434 maybe_str = stack.ToLocalChecked().As<String>();
435 }
436 }
437
438 Local<String> js_str;
439 if (!maybe_str.ToLocal(&js_str)) {
440 return Nothing<std::string>();
441 }
442 String::Utf8Value sv(isolate, js_str);
443 return Just<>(std::string(*sv, sv.length()));
444 }
445
PrintEmptyJavaScriptStack(JSONWriter * writer)446 static void PrintEmptyJavaScriptStack(JSONWriter* writer) {
447 writer->json_keyvalue("message", "No stack.");
448 writer->json_arraystart("stack");
449 writer->json_element("Unavailable.");
450 writer->json_arrayend();
451
452 writer->json_objectstart("errorProperties");
453 writer->json_objectend();
454 }
455
456 // Do our best to report the JavaScript stack without calling into JavaScript.
PrintJavaScriptStack(JSONWriter * writer,Isolate * isolate,const char * trigger)457 static void PrintJavaScriptStack(JSONWriter* writer,
458 Isolate* isolate,
459 const char* trigger) {
460 // Can not capture the stacktrace when the isolate is in a OOM state or no
461 // context is entered.
462 if (!strcmp(trigger, "OOMError") || !isolate->InContext()) {
463 PrintEmptyJavaScriptStack(writer);
464 return;
465 }
466
467 HandleScope scope(isolate);
468 RegisterState state;
469 state.pc = nullptr;
470 state.fp = &state;
471 state.sp = &state;
472
473 // in-out params
474 SampleInfo info;
475 void* samples[MAX_FRAME_COUNT];
476 isolate->GetStackSample(state, samples, MAX_FRAME_COUNT, &info);
477
478 constexpr StackTrace::StackTraceOptions stack_trace_options =
479 static_cast<StackTrace::StackTraceOptions>(
480 StackTrace::kDetailed |
481 StackTrace::kExposeFramesAcrossSecurityOrigins);
482 Local<StackTrace> stack = StackTrace::CurrentStackTrace(
483 isolate, MAX_FRAME_COUNT, stack_trace_options);
484
485 if (stack->GetFrameCount() == 0) {
486 PrintEmptyJavaScriptStack(writer);
487 return;
488 }
489
490 writer->json_keyvalue("message", trigger);
491 writer->json_arraystart("stack");
492 for (int i = 0; i < stack->GetFrameCount(); i++) {
493 Local<StackFrame> frame = stack->GetFrame(isolate, i);
494
495 Utf8Value function_name(isolate, frame->GetFunctionName());
496 Utf8Value script_name(isolate, frame->GetScriptName());
497 const int line_number = frame->GetLineNumber();
498 const int column = frame->GetColumn();
499
500 std::string stack_line = SPrintF(
501 "at %s (%s:%d:%d)", *function_name, *script_name, line_number, column);
502 writer->json_element(stack_line);
503 }
504 writer->json_arrayend();
505 writer->json_objectstart("errorProperties");
506 writer->json_objectend();
507 }
508
509 // Report the JavaScript stack.
PrintJavaScriptErrorStack(JSONWriter * writer,Isolate * isolate,Local<Value> error,const char * trigger)510 static void PrintJavaScriptErrorStack(JSONWriter* writer,
511 Isolate* isolate,
512 Local<Value> error,
513 const char* trigger) {
514 if (error.IsEmpty()) {
515 return PrintJavaScriptStack(writer, isolate, trigger);
516 }
517
518 TryCatch try_catch(isolate);
519 HandleScope scope(isolate);
520 Local<Context> context = isolate->GetCurrentContext();
521 std::string ss = "";
522 if (!ErrorToString(isolate, context, error).To(&ss)) {
523 PrintEmptyJavaScriptStack(writer);
524 return;
525 }
526
527 int line = ss.find('\n');
528 if (line == -1) {
529 writer->json_keyvalue("message", ss);
530 } else {
531 std::string l = ss.substr(0, line);
532 writer->json_keyvalue("message", l);
533 writer->json_arraystart("stack");
534 ss = ss.substr(line + 1);
535 line = ss.find('\n');
536 while (line != -1) {
537 l = ss.substr(0, line);
538 l.erase(l.begin(), std::find_if(l.begin(), l.end(), [](int ch) {
539 return !std::iswspace(ch);
540 }));
541 writer->json_element(l);
542 ss = ss.substr(line + 1);
543 line = ss.find('\n');
544 }
545 writer->json_arrayend();
546 }
547
548 // Report summary JavaScript error properties backtrace
549 PrintJavaScriptErrorProperties(writer, isolate, error);
550 }
551
552 // Report a native stack backtrace
PrintNativeStack(JSONWriter * writer)553 static void PrintNativeStack(JSONWriter* writer) {
554 auto sym_ctx = NativeSymbolDebuggingContext::New();
555 void* frames[256];
556 const int size = sym_ctx->GetStackTrace(frames, arraysize(frames));
557 writer->json_arraystart("nativeStack");
558 int i;
559 for (i = 1; i < size; i++) {
560 void* frame = frames[i];
561 writer->json_start();
562 writer->json_keyvalue("pc",
563 ValueToHexString(reinterpret_cast<uintptr_t>(frame)));
564 writer->json_keyvalue("symbol", sym_ctx->LookupSymbol(frame).Display());
565 writer->json_end();
566 }
567 writer->json_arrayend();
568 }
569
570 // Report V8 JavaScript heap information.
571 // This uses the existing V8 HeapStatistics and HeapSpaceStatistics APIs.
572 // The isolate->GetGCStatistics(&heap_stats) internal V8 API could potentially
573 // provide some more useful information - the GC history and the handle counts
PrintGCStatistics(JSONWriter * writer,Isolate * isolate)574 static void PrintGCStatistics(JSONWriter* writer, Isolate* isolate) {
575 HeapStatistics v8_heap_stats;
576 isolate->GetHeapStatistics(&v8_heap_stats);
577 HeapSpaceStatistics v8_heap_space_stats;
578
579 writer->json_objectstart("javascriptHeap");
580 writer->json_keyvalue("totalMemory", v8_heap_stats.total_heap_size());
581 writer->json_keyvalue("executableMemory",
582 v8_heap_stats.total_heap_size_executable());
583 writer->json_keyvalue("totalCommittedMemory",
584 v8_heap_stats.total_physical_size());
585 writer->json_keyvalue("availableMemory",
586 v8_heap_stats.total_available_size());
587 writer->json_keyvalue("totalGlobalHandlesMemory",
588 v8_heap_stats.total_global_handles_size());
589 writer->json_keyvalue("usedGlobalHandlesMemory",
590 v8_heap_stats.used_global_handles_size());
591 writer->json_keyvalue("usedMemory", v8_heap_stats.used_heap_size());
592 writer->json_keyvalue("memoryLimit", v8_heap_stats.heap_size_limit());
593 writer->json_keyvalue("mallocedMemory", v8_heap_stats.malloced_memory());
594 writer->json_keyvalue("externalMemory", v8_heap_stats.external_memory());
595 writer->json_keyvalue("peakMallocedMemory",
596 v8_heap_stats.peak_malloced_memory());
597 writer->json_keyvalue("nativeContextCount",
598 v8_heap_stats.number_of_native_contexts());
599 writer->json_keyvalue("detachedContextCount",
600 v8_heap_stats.number_of_detached_contexts());
601 writer->json_keyvalue("doesZapGarbage", v8_heap_stats.does_zap_garbage());
602
603 writer->json_objectstart("heapSpaces");
604 // Loop through heap spaces
605 for (size_t i = 0; i < isolate->NumberOfHeapSpaces(); i++) {
606 isolate->GetHeapSpaceStatistics(&v8_heap_space_stats, i);
607 writer->json_objectstart(v8_heap_space_stats.space_name());
608 writer->json_keyvalue("memorySize", v8_heap_space_stats.space_size());
609 writer->json_keyvalue(
610 "committedMemory",
611 v8_heap_space_stats.physical_space_size());
612 writer->json_keyvalue(
613 "capacity",
614 v8_heap_space_stats.space_used_size() +
615 v8_heap_space_stats.space_available_size());
616 writer->json_keyvalue("used", v8_heap_space_stats.space_used_size());
617 writer->json_keyvalue(
618 "available", v8_heap_space_stats.space_available_size());
619 writer->json_objectend();
620 }
621
622 writer->json_objectend();
623 writer->json_objectend();
624 }
625
PrintResourceUsage(JSONWriter * writer)626 static void PrintResourceUsage(JSONWriter* writer) {
627 // Get process uptime in seconds
628 uint64_t uptime =
629 (uv_hrtime() - per_process::node_start_time) / (NANOS_PER_SEC);
630 if (uptime == 0) uptime = 1; // avoid division by zero.
631
632 // Process and current thread usage statistics
633 uv_rusage_t rusage;
634 writer->json_objectstart("resourceUsage");
635
636 uint64_t free_memory = uv_get_free_memory();
637 uint64_t total_memory = uv_get_total_memory();
638
639 writer->json_keyvalue("free_memory", free_memory);
640 writer->json_keyvalue("total_memory", total_memory);
641
642 size_t rss;
643 int err = uv_resident_set_memory(&rss);
644 if (!err) {
645 writer->json_keyvalue("rss", rss);
646 }
647
648 uint64_t constrained_memory = uv_get_constrained_memory();
649 if (constrained_memory) {
650 writer->json_keyvalue("constrained_memory", constrained_memory);
651 }
652
653 // See GuessMemoryAvailableToTheProcess
654 if (!err && constrained_memory && constrained_memory >= rss) {
655 uint64_t available_memory = constrained_memory - rss;
656 writer->json_keyvalue("available_memory", available_memory);
657 } else {
658 writer->json_keyvalue("available_memory", free_memory);
659 }
660
661 if (uv_getrusage(&rusage) == 0) {
662 double user_cpu =
663 rusage.ru_utime.tv_sec + SEC_PER_MICROS * rusage.ru_utime.tv_usec;
664 double kernel_cpu =
665 rusage.ru_stime.tv_sec + SEC_PER_MICROS * rusage.ru_stime.tv_usec;
666 writer->json_keyvalue("userCpuSeconds", user_cpu);
667 writer->json_keyvalue("kernelCpuSeconds", kernel_cpu);
668 double cpu_abs = user_cpu + kernel_cpu;
669 double cpu_percentage = (cpu_abs / uptime) * 100.0;
670 double user_cpu_percentage = (user_cpu / uptime) * 100.0;
671 double kernel_cpu_percentage = (kernel_cpu / uptime) * 100.0;
672 writer->json_keyvalue("cpuConsumptionPercent", cpu_percentage);
673 writer->json_keyvalue("userCpuConsumptionPercent", user_cpu_percentage);
674 writer->json_keyvalue("kernelCpuConsumptionPercent", kernel_cpu_percentage);
675 writer->json_keyvalue("maxRss", rusage.ru_maxrss * 1024);
676 writer->json_objectstart("pageFaults");
677 writer->json_keyvalue("IORequired", rusage.ru_majflt);
678 writer->json_keyvalue("IONotRequired", rusage.ru_minflt);
679 writer->json_objectend();
680 writer->json_objectstart("fsActivity");
681 writer->json_keyvalue("reads", rusage.ru_inblock);
682 writer->json_keyvalue("writes", rusage.ru_oublock);
683 writer->json_objectend();
684 }
685 writer->json_objectend();
686 #ifdef RUSAGE_THREAD
687 struct rusage stats;
688 if (getrusage(RUSAGE_THREAD, &stats) == 0) {
689 writer->json_objectstart("uvthreadResourceUsage");
690 double user_cpu =
691 stats.ru_utime.tv_sec + SEC_PER_MICROS * stats.ru_utime.tv_usec;
692 double kernel_cpu =
693 stats.ru_stime.tv_sec + SEC_PER_MICROS * stats.ru_stime.tv_usec;
694 writer->json_keyvalue("userCpuSeconds", user_cpu);
695 writer->json_keyvalue("kernelCpuSeconds", kernel_cpu);
696 double cpu_abs = user_cpu + kernel_cpu;
697 double cpu_percentage = (cpu_abs / uptime) * 100.0;
698 double user_cpu_percentage = (user_cpu / uptime) * 100.0;
699 double kernel_cpu_percentage = (kernel_cpu / uptime) * 100.0;
700 writer->json_keyvalue("cpuConsumptionPercent", cpu_percentage);
701 writer->json_keyvalue("userCpuConsumptionPercent", user_cpu_percentage);
702 writer->json_keyvalue("kernelCpuConsumptionPercent", kernel_cpu_percentage);
703 writer->json_objectstart("fsActivity");
704 writer->json_keyvalue("reads", stats.ru_inblock);
705 writer->json_keyvalue("writes", stats.ru_oublock);
706 writer->json_objectend();
707 writer->json_objectend();
708 }
709 #endif // RUSAGE_THREAD
710 }
711
712 // Report operating system information.
PrintSystemInformation(JSONWriter * writer)713 static void PrintSystemInformation(JSONWriter* writer) {
714 uv_env_item_t* envitems;
715 int envcount;
716 int r;
717
718 writer->json_objectstart("environmentVariables");
719
720 {
721 Mutex::ScopedLock lock(per_process::env_var_mutex);
722 r = uv_os_environ(&envitems, &envcount);
723 }
724
725 if (r == 0) {
726 for (int i = 0; i < envcount; i++)
727 writer->json_keyvalue(envitems[i].name, envitems[i].value);
728
729 uv_os_free_environ(envitems, envcount);
730 }
731
732 writer->json_objectend();
733
734 #ifndef _WIN32
735 static struct {
736 const char* description;
737 int id;
738 } rlimit_strings[] = {
739 {"core_file_size_blocks", RLIMIT_CORE},
740 {"data_seg_size_kbytes", RLIMIT_DATA},
741 {"file_size_blocks", RLIMIT_FSIZE},
742 #if !(defined(_AIX) || defined(__sun))
743 {"max_locked_memory_bytes", RLIMIT_MEMLOCK},
744 #endif
745 #ifndef __sun
746 {"max_memory_size_kbytes", RLIMIT_RSS},
747 #endif
748 {"open_files", RLIMIT_NOFILE},
749 {"stack_size_bytes", RLIMIT_STACK},
750 {"cpu_time_seconds", RLIMIT_CPU},
751 #ifndef __sun
752 {"max_user_processes", RLIMIT_NPROC},
753 #endif
754 #ifndef __OpenBSD__
755 {"virtual_memory_kbytes", RLIMIT_AS}
756 #endif
757 };
758
759 writer->json_objectstart("userLimits");
760 struct rlimit limit;
761 std::string soft, hard;
762
763 for (size_t i = 0; i < arraysize(rlimit_strings); i++) {
764 if (getrlimit(rlimit_strings[i].id, &limit) == 0) {
765 writer->json_objectstart(rlimit_strings[i].description);
766
767 if (limit.rlim_cur == RLIM_INFINITY)
768 writer->json_keyvalue("soft", "unlimited");
769 else
770 writer->json_keyvalue("soft", limit.rlim_cur);
771
772 if (limit.rlim_max == RLIM_INFINITY)
773 writer->json_keyvalue("hard", "unlimited");
774 else
775 writer->json_keyvalue("hard", limit.rlim_max);
776
777 writer->json_objectend();
778 }
779 }
780 writer->json_objectend();
781 #endif // _WIN32
782
783 PrintLoadedLibraries(writer);
784 }
785
786 // Report a list of loaded native libraries.
PrintLoadedLibraries(JSONWriter * writer)787 static void PrintLoadedLibraries(JSONWriter* writer) {
788 writer->json_arraystart("sharedObjects");
789 std::vector<std::string> modules =
790 NativeSymbolDebuggingContext::GetLoadedLibraries();
791 for (auto const& module_name : modules) writer->json_element(module_name);
792 writer->json_arrayend();
793 }
794
795 // Obtain and report the node and subcomponent version strings.
PrintComponentVersions(JSONWriter * writer)796 static void PrintComponentVersions(JSONWriter* writer) {
797 std::stringstream buf;
798
799 writer->json_objectstart("componentVersions");
800
801 #define V(key) +1
802 std::pair<std::string_view, std::string_view>
803 versions_array[NODE_VERSIONS_KEYS(V)];
804 #undef V
805 auto* slot = &versions_array[0];
806
807 #define V(key) \
808 do { \
809 *slot++ = std::pair<std::string_view, std::string_view>( \
810 #key, per_process::metadata.versions.key); \
811 } while (0);
812 NODE_VERSIONS_KEYS(V)
813 #undef V
814
815 std::sort(&versions_array[0],
816 &versions_array[arraysize(versions_array)],
817 [](auto& a, auto& b) { return a.first < b.first; });
818
819 for (const auto& version : versions_array) {
820 writer->json_keyvalue(version.first, version.second);
821 }
822
823 writer->json_objectend();
824 }
825
826 // Report runtime release information.
PrintRelease(JSONWriter * writer)827 static void PrintRelease(JSONWriter* writer) {
828 writer->json_objectstart("release");
829 writer->json_keyvalue("name", per_process::metadata.release.name);
830 #if NODE_VERSION_IS_LTS
831 writer->json_keyvalue("lts", per_process::metadata.release.lts);
832 #endif
833
834 #ifdef NODE_HAS_RELEASE_URLS
835 writer->json_keyvalue("headersUrl",
836 per_process::metadata.release.headers_url);
837 writer->json_keyvalue("sourceUrl", per_process::metadata.release.source_url);
838 #ifdef _WIN32
839 writer->json_keyvalue("libUrl", per_process::metadata.release.lib_url);
840 #endif // _WIN32
841 #endif // NODE_HAS_RELEASE_URLS
842
843 writer->json_objectend();
844 }
845
846 } // namespace report
847
TriggerNodeReport(Isolate * isolate,Environment * env,const char * message,const char * trigger,const std::string & name,Local<Value> error)848 std::string TriggerNodeReport(Isolate* isolate,
849 Environment* env,
850 const char* message,
851 const char* trigger,
852 const std::string& name,
853 Local<Value> error) {
854 std::string filename;
855
856 // Determine the required report filename. In order of priority:
857 // 1) supplied on API 2) configured on startup 3) default generated
858 if (!name.empty()) {
859 // Filename was specified as API parameter.
860 filename = name;
861 } else {
862 std::string report_filename;
863 {
864 Mutex::ScopedLock lock(per_process::cli_options_mutex);
865 report_filename = per_process::cli_options->report_filename;
866 }
867 if (report_filename.length() > 0) {
868 // File name was supplied via start-up option.
869 filename = report_filename;
870 } else {
871 filename = *DiagnosticFilename(
872 env != nullptr ? env->thread_id() : 0, "report", "json");
873 }
874 }
875
876 // Open the report file stream for writing. Supports stdout/err,
877 // user-specified or (default) generated name
878 std::ofstream outfile;
879 std::ostream* outstream;
880 if (filename == "stdout") {
881 outstream = &std::cout;
882 } else if (filename == "stderr") {
883 outstream = &std::cerr;
884 } else {
885 std::string report_directory;
886 {
887 Mutex::ScopedLock lock(per_process::cli_options_mutex);
888 report_directory = per_process::cli_options->report_directory;
889 }
890 // Regular file. Append filename to directory path if one was specified
891 if (report_directory.length() > 0) {
892 std::string pathname = report_directory;
893 pathname += kPathSeparator;
894 pathname += filename;
895 outfile.open(pathname, std::ios::out | std::ios::binary);
896 } else {
897 outfile.open(filename, std::ios::out | std::ios::binary);
898 }
899 // Check for errors on the file open
900 if (!outfile.is_open()) {
901 std::cerr << "\nFailed to open Node.js report file: " << filename;
902
903 if (report_directory.length() > 0)
904 std::cerr << " directory: " << report_directory;
905
906 std::cerr << " (errno: " << errno << ")" << std::endl;
907 return "";
908 }
909 outstream = &outfile;
910 std::cerr << "\nWriting Node.js report to file: " << filename;
911 }
912
913 bool compact;
914 {
915 Mutex::ScopedLock lock(per_process::cli_options_mutex);
916 compact = per_process::cli_options->report_compact;
917 }
918
919 report::WriteNodeReport(
920 isolate, env, message, trigger, filename, *outstream, error, compact);
921
922 // Do not close stdout/stderr, only close files we opened.
923 if (outfile.is_open()) {
924 outfile.close();
925 }
926
927 // Do not mix JSON and free-form text on stderr.
928 if (filename != "stderr") {
929 std::cerr << "\nNode.js report completed" << std::endl;
930 }
931 return filename;
932 }
933
934 // External function to trigger a report, writing to file.
TriggerNodeReport(Isolate * isolate,const char * message,const char * trigger,const std::string & name,Local<Value> error)935 std::string TriggerNodeReport(Isolate* isolate,
936 const char* message,
937 const char* trigger,
938 const std::string& name,
939 Local<Value> error) {
940 Environment* env = nullptr;
941 if (isolate != nullptr) {
942 env = Environment::GetCurrent(isolate);
943 }
944 return TriggerNodeReport(isolate, env, message, trigger, name, error);
945 }
946
947 // External function to trigger a report, writing to file.
TriggerNodeReport(Environment * env,const char * message,const char * trigger,const std::string & name,Local<Value> error)948 std::string TriggerNodeReport(Environment* env,
949 const char* message,
950 const char* trigger,
951 const std::string& name,
952 Local<Value> error) {
953 return TriggerNodeReport(env != nullptr ? env->isolate() : nullptr,
954 env,
955 message,
956 trigger,
957 name,
958 error);
959 }
960
961 // External function to trigger a report, writing to a supplied stream.
GetNodeReport(Isolate * isolate,const char * message,const char * trigger,Local<Value> error,std::ostream & out)962 void GetNodeReport(Isolate* isolate,
963 const char* message,
964 const char* trigger,
965 Local<Value> error,
966 std::ostream& out) {
967 Environment* env = nullptr;
968 if (isolate != nullptr) {
969 env = Environment::GetCurrent(isolate);
970 }
971 report::WriteNodeReport(
972 isolate, env, message, trigger, "", out, error, false);
973 }
974
975 // External function to trigger a report, writing to a supplied stream.
GetNodeReport(Environment * env,const char * message,const char * trigger,Local<Value> error,std::ostream & out)976 void GetNodeReport(Environment* env,
977 const char* message,
978 const char* trigger,
979 Local<Value> error,
980 std::ostream& out) {
981 Isolate* isolate = nullptr;
982 if (env != nullptr) {
983 isolate = env->isolate();
984 }
985 report::WriteNodeReport(
986 isolate, env, message, trigger, "", out, error, false);
987 }
988
989 } // namespace node
990