reap

一种通过分析引用图解析Ruby堆转储的工具。

支持深入到特定对象保留的内存，以及可选的图形输出。

何时使用reap

此工具旨在优化内存使用以及调试内存泄漏。如果您有Ruby进程的堆快照（下面提供获取快照的提示），reap 可帮助您理解该快照的内容。

为此，我们从引用图中构建一个 支配树，以显示哪些对象持有大量内存。（在有向图中，如果从给定根到节点 w 的所有路径都通过节点 v，则节点 v "支配" 节点 w。在内存引用的上下文中，这意味着对象 w 仅因对象 v 活跃而活跃。）

限制和比较

reap 目前不理解垃圾收集 "代"，这可能也有助于找到泄漏。

分析GC代的不利之处在于，为了收集必要的数据，您需要跟踪对象分配，这在生产中可能非常昂贵。如果您不介意这个问题，您可能想尝试其他工具，例如 heapy，而不是或与 reap 一起。

reap 意在即使在未跟踪分配的情况下也能提供有用的数据。它还可以在几秒钟内分析相当大的（超过千兆字节）堆，这得益于它是用Rust而不是Ruby编写的。

如何使用reap

运行 --help 以获取完整文档。

基本用法

$ cargo run -q --release -- /tmp/heap.json -f flamegraph.svg -c 3
Object types using the most live memory:
Thread: 2.1 MB (40 objects)
String: 462.6 KB (9235 objects)
Class: 223.7 KB (287 objects)
...: 653.0 KB (5909 objects)

Objects retaining the most live memory:
root: 3.4 MB (15472 objects)
Thread[0x7f83df87dc40]: 1.1 MB (25 objects)
Thread[0x7f83e107cd78]: 1.0 MB (7 objects)
...: 4.6 MB (59857 objects)

Object types retaining the most live memory:
ROOT: 3.4 MB (15472 objects)
Thread: 2.1 MB (70 objects)
ARRAY: 949.3 KB (13053 objects)
...: 3.6 MB (46766 objects)

Objects unreachable from root:
Class: 189.6 KB (617 objects)
String: 81.8 KB (1174 objects)
ARRAY: 38.6 KB (298 objects)
...: 91.5 KB (1422 objects)

Wrote 15471 nodes to flamegraph.svg

深入到子树（在这种情况下，较大的Thread）

$ cargo run -q --release -- /tmp/heap.json -d out.dot -c 3 -r 0x7f83df87dc40
Object types using the most live memory:
Thread: 1.0 MB (1 objects)
Class: 1.6 KB (3 objects)
Hash: 1.3 KB (7 objects)
...: 980 B (14 objects)

Objects retaining the most live memory:
Thread[0x7f83df87dc40]: 1.1 MB (25 objects)
Hash[0x7f83e10452d8][size=5]: 1.2 KB (6 objects)
Object[0x7f83df8d62c8][CLASS]: 992 B (8 objects)
...: 3.0 KB (24 objects)

Object types retaining the most live memory:
Thread: 1.1 MB (25 objects)
Hash: 2.2 KB (12 objects)
Class: 1.9 KB (10 objects)
...: 1.1 KB (16 objects)

Objects reachable from, but not dominated by, 0x7f83df87dc40:
String: 352.3 KB (6604 objects)
Class: 220.6 KB (283 objects)
Regexp: 108.8 KB (139 objects)
...: 465.2 KB (5716 objects)

Wrote 1 nodes & 0 edges to out.dot

安装

确保您已安装Rust的 cargo 软件包管理器，然后只需 cargo install reap。

获取堆转储

如果您已安装 rbtrace 并在您计划跟踪的进程中需要，您可以运行

rbtrace -p $PID -e "Thread.new{require 'objspace';f=open('/tmp/heap.json','w');ObjectSpace.dump_all(output: f, full: true);f.close}"

否则，您可以使用 gdb 连接到 Ruby 进程，然后运行

call rb_eval_string_protect("Thread.new{require 'objspace';f=open('/tmp/heap.json','w');ObjectSpace.dump_all(output: f, full: true);f.close}", 0)