• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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