查看源代码 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 的详细信息,请参阅用户指南

概要

函数

在运行时更改工具的配置参数。允许的参数包括 linesintervalaccumulatesort

将当前显示内容转储到文本文件。

显示 etop 及其选项的帮助。

启动 etop。请注意,最好使用 etop 脚本启动 etop

启动 etop。要查看可能的选项,请使用 help/0

终止 etop

函数

-spec config(Key, Value) -> ok | {error, Reason}
                when Key :: lines | interval | accumulate | sort, Value :: term(), Reason :: term().

在运行时更改工具的配置参数。允许的参数包括 linesintervalaccumulatesort

-spec dump(File) -> ok | {error, Reason} when File :: file:filename_all(), Reason :: term().

将当前显示内容转储到文本文件。

链接到此函数

help()

查看源代码 (自 OTP R15B01 起)
-spec help() -> ok.

显示 etop 及其选项的帮助。

链接到此函数

start()

查看源代码 (自 OTP R15B01 起)
-spec start() -> ok.

启动 etop。请注意,最好使用 etop 脚本启动 etop

链接到此函数

start(Options)

查看源代码 (自 OTP R15B01 起)
-spec start(Options) -> ok when Options :: [{Key, Value}], Key :: atom(), Value :: term().

启动 etop。要查看可能的选项,请使用 help/0

-spec stop() -> stop | not_started.

终止 etop