summaryrefslogtreecommitdiff
path: root/deps/v8/tools/heap-stats/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'deps/v8/tools/heap-stats/README.md')
-rw-r--r--deps/v8/tools/heap-stats/README.md15
1 files changed, 15 insertions, 0 deletions
diff --git a/deps/v8/tools/heap-stats/README.md b/deps/v8/tools/heap-stats/README.md
new file mode 100644
index 0000000000..70083fe257
--- /dev/null
+++ b/deps/v8/tools/heap-stats/README.md
@@ -0,0 +1,15 @@
+# Heap Stats
+
+Heap stats is a HTML-based tool for visualizing V8-internal object statistics.
+For example, the tool can be used to visualize how much heap memory is used for
+maintaining internal state versus actually allocated by the user.
+
+The tool consumes log files produced by d8 (or Chromium) by passing
+`--trace-gc-object-stats` or a trace captured using Chrome's tracing
+infrastructure. Chrome trace files need to be unpacked before they can
+be used though.
+
+Hosting requires a web server, e.g.:
+
+ cd tools/heap-stats
+ python -m SimpleHTTPServer 8000