root
/
rabbitmq-server
mirror of https://github.com/rabbitmq/rabbitmq-server.git
1
0
Fork 0
Code Issues Actions Packages Projects Releases Wiki Activity
rabbitmq-server/deps/rabbitmq_top
History
Philip Kuryloski 15a79466b1 Use the new xref2 macro from rules_erlang 
That adopts the modern erlang.mk xref behaviour
 		2022-06-09 23:18:28 +02:00
..
priv/www/js Switch to MPL2 2020-07-15 02:40:45 +03:00
src Bump (c) year 2022-03-21 01:21:56 +04:00
.gitignore Git: Ignore copied CLI 2019-12-12 15:08:54 +01:00
.travis.yml Travis CI: Update config from rabbitmq-common 2020-03-04 14:24:32 +01:00
BUILD.bazel Use the new xref2 macro from rules_erlang 2022-06-09 23:18:28 +02:00
CODE_OF_CONDUCT.md Replace files with symlinks 2022-04-15 06:04:29 -07:00
CONTRIBUTING.md Replace files with symlinks 2022-04-15 06:04:29 -07:00
LICENSE Cosmetics 2020-07-15 02:44:32 +03:00
LICENSE-MPL-RabbitMQ Revert drop of Exhibit B on MPL 2.0 2020-07-20 17:04:35 +01:00
Makefile Update Erlang.mk and switch to new xref code 2022-05-31 13:51:12 +02:00
README.md Update copyright (year 2020) 2020-03-10 16:59:32 +01:00

README.md

RabbitMQ Top Plugin

Adds UNIX top-like information on the Erlang VM to the management UI. The closest interactive CLI alternative in recent releases is rabbitmq-diagnostics observer.

This is what it looks like:

Installation

This plugin ships with RabbitMQ as of 3.6.3. Enable it with

# use sudo as necessary
rabbitmq-plugins enable rabbitmq_top

RabbitMQ 3.5.x

You can download a pre-built binary of this plugin for RabbitMQ 3.5.x from RabbitMQ Community plugins page.

Usage

Sort by process ID, memory use or reductions/sec (an approximate measure of CPU use).

Click on the process description (e.g. "my queue") to see that object's management view.

Click on the process ID (e.g. "<0.3423.0>") to see some more Erlang process details.

See Memory Use Analysis guide on RabbitMQ website for more information.

HTTP API

You can drive the HTTP API yourself. It installs into the management plugin's API; you should understand that first. Once you do, the additional paths look like:

/api/top/<node-name>

List of processes. Takes similar query string parameters to other lists, sort, sort_reverse and columns. Sorting is quite important as it currently hard-codes returning the top 20 processes.

/api/process/<pid>

Individual process details.

More Screenshots

Individual process metrics are also available:

Building from Source

You can build and install it like any other plugin (see the plugin development guide).

License and Copyright

(c) 2007-2020 VMware, Inc. or its affiliates.

Released under the same license as RabbitMQ.