etop — observer v2.16

Search documentation of observer

# View Source etop (observer v2.16)

Erlang Top is a tool for presenting information about Erlang processes similar to the information presented by "top" in UNIX.

Start Erlang Top with the provided scripts `etop`. This starts a hidden Erlang node that connects to the node to be measured. The measured node is specified with option `-node`. If the measured node has a different cookie than the default cookie for the user who invokes the script, the cookie must be explicitly specified with option `-setcookie`.

Under Windows, batch file `etop.bat` can be used.

When executing the `etop` script, configuration parameters can be specified as command-line options, for example, `etop -node testnode@myhost -setcookie MyCookie`. The following configuration parameters exist for the tool:

- `node` - The measured node.

  Value: `atom/0`

  Mandatory

- `setcookie` - Cookie to use for the `etop` node. Must be same as the cookie on the measured node.

  Value: `atom/0`

- `lines` - Number of lines (processes) to display.

  Value: `integer/0`

  Default: `10`

- `interval` - Time interval (in seconds) between each update of the display.

  Value: `integer/0`

  Default: `5`

- `accumulate` - If `true`, the execution time and reductions are accumulated.

  Value: `boolean/0`

  Default: `false`

- `sort` - Identifies what information to sort by.

  Value: `runtime | reductions | memory | msg_q`

  Default: `runtime` (`reductions` if `tracing=off`)

- `tracing` - `etop` uses the Erlang trace facility, and thus no other tracing is possible on the measured node while `etop` is running, unless this option is set to `off`. Also helpful if the `etop` tracing causes too high load on the measured node. With tracing off, runtime is not measured.

  Value: `on | off`

  Default: `on`

For details about Erlang Top, see the User's Guide.

# Summary

## Functions

config(Key, Value)

config(Key,Value) -> Result

dump(File)

dump(File) -> Result

help()

help() -> ok

start()

start() -> ok

start(Options)

start(Options) -> ok

stop()

stop() -> stop

# Functions

Link to this function

# config(Key, Value)

View Source

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

config(Key,Value) -> Result

Changes the configuration parameters of the tool during runtime. Allowed parameters are `lines`, `interval`, `accumulate`, and `sort`.

Link to this function

# dump(File)

View Source

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

dump(File) -> Result

Dumps the current display to a text file.

Link to this function

# help()

View Source (since OTP R15B01)

    -spec help() -> ok.

help() -> ok

Displays the help of `etop` and its options.

Link to this function

# start()

View Source (since OTP R15B01)

    -spec start() -> ok.

start() -> ok

Starts `etop`. Notice that `etop` is preferably started with the `etop` script.

Link to this function

# start(Options)

View Source (since OTP R15B01)

    -spec start(Options) -> ok when Options :: [{Key, Value}], Key :: atom(), Value :: term().

start(Options) -> ok

Starts `etop`. To view the possible options, use `help/0`.

Link to this function

# stop()

View Source

    -spec stop() -> stop | not_started.

stop() -> stop

Terminates `etop`.