查看源代码 etop (观察器 v2.17)
Erlang Top 是一个用于展示 Erlang 进程信息的工具,类似于 UNIX 中的 "top" 命令。
使用提供的脚本 etop
启动 Erlang Top。这会启动一个隐藏的 Erlang 节点,该节点连接到要测量的节点。要测量的节点通过选项 -node
指定。如果要测量的节点的 cookie 与调用脚本的用户的默认 cookie 不同,则必须使用选项 -setcookie
显式指定 cookie。
在 Windows 下,可以使用批处理文件 etop.bat
。
执行 etop
脚本时,可以将配置参数指定为命令行选项,例如,etop -node testnode@myhost -setcookie MyCookie
。该工具存在以下配置参数
node
- 要测量的节点。值:
atom/0
必需
setcookie
- 用于etop
节点的 cookie。必须与要测量的节点上的 cookie 相同。值:
atom/0
lines
- 要显示的行数(进程数)。值:
integer/0
默认值:
10
interval
- 每次更新显示的时间间隔(秒)。值:
integer/0
默认值:
5
accumulate
- 如果为true
,则累积执行时间和规约。值:
boolean/0
默认值:
false
sort
- 标识按什么信息排序。值:
runtime | reductions | memory | msg_q
默认值:
runtime
(如果tracing=off
,则为reductions
)tracing
-etop
使用 Erlang 的跟踪工具,因此在etop
运行时,除非此选项设置为off
,否则无法在被测量的节点上进行其他跟踪。如果etop
跟踪导致被测量的节点负载过高,此选项也很有用。关闭跟踪后,不会测量运行时间。值:
on | off
默认值:
on
有关 Erlang Top 的详细信息,请参阅用户指南。
概要
函数
-spec config(Key, Value) -> ok | {error, Reason} when Key :: lines | interval | accumulate | sort, Value :: term(), Reason :: term().
在运行时更改工具的配置参数。允许的参数包括 lines
、interval
、accumulate
和 sort
。
-spec dump(File) -> ok | {error, Reason} when File :: file:filename_all(), Reason :: term().
将当前显示内容转储到文本文件。
-spec help() -> ok.
显示 etop
及其选项的帮助。
-spec start() -> ok.
启动 etop
。请注意,最好使用 etop
脚本启动 etop
。
启动 etop
。要查看可能的选项,请使用 help/0
。
-spec stop() -> stop | not_started.
终止 etop
。