rabbitmq-server/deps/rabbitmq_top
Loïc Hoguin bbfa066d79
Cleanup .gitignore files for the monorepo
We don't need to duplicate so many patterns in so many
files since we have a monorepo (and want to keep it).

If I managed to miss something or remove something that
should stay, please put it back. Note that monorepo-wide
patterns should go in the top-level .gitignore file.
Other .gitignore files are for application or folder-
specific patterns.
2024-06-28 12:00:52 +02:00
..
priv/www/js More missed license header updates #9969 2024-02-05 11:53:50 -05:00
src Remove unused imports (thanks elp!) 2024-05-23 16:36:08 +02:00
BUILD.bazel Use rules_elixir to build the cli without mix 2024-06-18 14:50:34 +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 Replace @rabbitmq.com addresses with rabbitmq-core@groups.vmware.com 2023-06-20 15:40:13 +04: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 More missed license header updates #9969 2024-02-05 12:26:25 -05:00
app.bzl Remove unused imports (thanks elp!) 2024-05-23 16:36:08 +02: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).

(c) 2007-2024 Broadcom. The term “Broadcom” refers to Broadcom Inc. and/or its subsidiaries. All rights reserved.

Released under the same license as RabbitMQ.