root
/
rabbitmq-server
mirror of https://github.com/rabbitmq/rabbitmq-server.git
1
0
Fork 0
Code Issues Actions 10 Packages Projects Releases Wiki Activity
rabbitmq-server/deps/rabbitmq_top
History
Michal Kuratczyk 1a2126676d Update CLA URL 2021-09-23 14:29:36 +02:00
..
priv/www/js Switch to MPL2 2020-07-15 02:40:45 +03:00
src Bump (c) year 2021-01-22 09:00:14 +03: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 Add dialyze for remaning tier-1 plugins 2021-06-01 10:19:10 +02:00
CODE_OF_CONDUCT.md URL Cleanup 2019-03-20 03:24:27 -05:00
CONTRIBUTING.md Update CLA URL 2021-09-23 14:29:36 +02: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 Remove duplicate rabbitmq-components.mk and erlang.mk files 2021-03-22 15:40:19 +01: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.