More rabbitmqadmin v2-related updates

Author: michaelklishin

docs/cli.md

@@ -56,7 +56,7 @@ be named `rabbitmqctl.bat`.
 
 Additional tools are optional and can be obtained from GitHub:
 
- * [`rabbitmqadmin`](./management-cli) for operator tasks over [HTTP API](./management)
+ * [`rabbitmqadmin` v2](./management-cli) for operator tasks over the [HTTP API](./management#http-api)
  * [`rabbitmq-collect-env`](https://github.com/rabbitmq/support-tools) which collects relevant cluster and environment information
     as well as server logs. This tool is specific to Linux and UNIX-like operating systems.
 
@@ -66,7 +66,7 @@ including virtual host, user and permission management, destructive operations
 on node's data and so on.
 
 `rabbitmqadmin` is built on top of the HTTP API and uses a different mechanism, and only
-requires that the [HTTP API](./management) port is open for outside connections.
+requires that the [HTTP API](./management#http-api) port is open for outside connections.
 
 Even though CLI tools ship with the server, most commands [can be used to operate on remote nodes](#remote-nodes).
 Plugins can [provide CLI commands](#command-discovery) that will be discovered by CLI tools for explicitly enabled plugins.
@@ -92,8 +92,8 @@ that has RabbitMQ installed.
 root is added to `PATH` for simpler interactive use. Non-interactive use cases can use full or relative paths without
 modifications to the `PATH` environment variable.
 
-[`rabbitmqadmin`](./management-cli) is a standalone tool (no dependencies other than Python 3)
-that can be downloaded from a running node or [directly from GitHub](https://github.com/rabbitmq/rabbitmq-server/blob/main/deps/rabbitmq_management/bin/rabbitmqadmin).
+[`rabbitmqadmin`](./management-cli) is a standalone tool
+that is [distributed via GitHub releases](https://github.com/rabbitmq/rabbitmqadmin-ng/releases).
 
 If interaction from a remote node is required, download and extract the [generic UNIX package](./install-generic-unix)
 or use the [Windows installer](./install-windows).
@@ -737,10 +737,10 @@ rabbitmqctl.bat shutdown --node [email protected]
 It is not a replacement for `rabbitmqctl` and provides access to a subset of most commonly
 performed operations provided by the [management UI](./management).
 
-The tool requires Python 2.7.9 or a more recent version.
+`rabbitmqadmin` uses HTTP API authentication mechanism (basic HTTP authentication).
 
-`rabbitmqadmin` uses HTTP API authentication mechanism (basic HTTP authentication). It has to be
-downloaded separately from a running node or [GitHub](https://github.com/rabbitmq/rabbitmq-server/blob/main/deps/rabbitmq_management/bin/rabbitmqadmin).
+It is a native binary and must be [downloaded separately](https://github.com/rabbitmq/rabbitmqadmin-ng/releases) from the RabbitMQ
+distribution.
 
 
 ## "Node-local" and "Clusterwide" Commands {#cli-and-clustering}

docs/management-cli.md

@@ -315,6 +315,87 @@ rabbitmqadmin --vhost "events" delete exchange --name "target.exchange.name"
 rabbitmqadmin --vhost "events" delete exchange --name "target.exchange.name" --idempotently
 ```
 
+### Inspecting Node Memory Breakdown
+
+There are two commands for reasoning about target [node's memory footprint](./memory-use):
+
+```shell
+# displays a breakdown in bytes
+rabbitmqadmin show memory_breakdown_in_bytes --node 'rabbit@hostname'
+```
+
+```shell
+# displays a breakdown in percent
+rabbitmqadmin show memory_breakdown_in_percent --node 'rabbit@hostname'
+```
+
+Example output of `show memory_breakdown_in_percent`:
+
+```
+┌────────────────────────────────────────┬────────────┐
+│ key                                    │ percentage │
+├────────────────────────────────────────┼────────────┤
+│ total                                  │ 100%       │
+├────────────────────────────────────────┼────────────┤
+│ Binary heap                            │ 45.10%     │
+├────────────────────────────────────────┼────────────┤
+│ Allocated but unused                   │ 23.45%     │
+├────────────────────────────────────────┼────────────┤
+│ Quorum queue ETS tables                │ 23.05%     │
+├────────────────────────────────────────┼────────────┤
+│ Other processes                        │ 5.32%      │
+├────────────────────────────────────────┼────────────┤
+│ Other (used by the runtime)            │ 4.98%      │
+├────────────────────────────────────────┼────────────┤
+│ Code                                   │ 4.54%      │
+├────────────────────────────────────────┼────────────┤
+│ Client connections: others processes   │ 3.64%      │
+├────────────────────────────────────────┼────────────┤
+│ Management stats database              │ 3.48%      │
+├────────────────────────────────────────┼────────────┤
+│ Client connections: reader processes   │ 3.22%      │
+├────────────────────────────────────────┼────────────┤
+│ Plugins and their data                 │ 3.12%      │
+├────────────────────────────────────────┼────────────┤
+│ Other (ETS tables)                     │ 1.55%      │
+├────────────────────────────────────────┼────────────┤
+│ Metrics data                           │ 0.66%      │
+├────────────────────────────────────────┼────────────┤
+│ AMQP 0-9-1 channels                    │ 0.40%      │
+├────────────────────────────────────────┼────────────┤
+│ Message store indices                  │ 0.27%      │
+├────────────────────────────────────────┼────────────┤
+│ Atom table                             │ 0.24%      │
+├────────────────────────────────────────┼────────────┤
+│ Client connections: writer processes   │ 0.19%      │
+├────────────────────────────────────────┼────────────┤
+│ Quorum queue replica processes         │ 0.10%      │
+├────────────────────────────────────────┼────────────┤
+│ Stream replica processes               │ 0.07%      │
+├────────────────────────────────────────┼────────────┤
+│ Mnesia                                 │ 0.02%      │
+├────────────────────────────────────────┼────────────┤
+│ Metadata store                         │ 0.02%      │
+├────────────────────────────────────────┼────────────┤
+│ Stream coordinator processes           │ 0.02%      │
+├────────────────────────────────────────┼────────────┤
+│ Classic queue processes                │ 0.00%      │
+├────────────────────────────────────────┼────────────┤
+│ Metadata store ETS tables              │ 0.00%      │
+├────────────────────────────────────────┼────────────┤
+│ Stream replica reader processes        │ 0.00%      │
+├────────────────────────────────────────┼────────────┤
+│ Reserved by the kernel but unallocated │ 0.00%      │
+└────────────────────────────────────────┴────────────┘
+```
+
+Note that there are [two different supported strategies](./memory-use#strategies)
+for computing memory footprint of a node. `rabbitmqadmin` will use the greater value
+for 100% when computing the relative share in percent for each category.
+
+Other factors that can affect the precision of percentage values reported  are [runtime allocator](./memory-use#preallocated-memory)
+behavior nuances and the [kernel page cache](./memory-use#page-cache).
+
 ### List feature flags and their state
 
 ```shell

versioned_docs/version-3.13/cli.md

@@ -56,7 +56,7 @@ be named `rabbitmqctl.bat`.
 
 Additional tools are optional and can be obtained from GitHub:
 
- * [`rabbitmqadmin`](./management-cli) for operator tasks over [HTTP API](./management)
+ * [`rabbitmqadmin` v2](./management-cli) for operator tasks over the [HTTP API](./management#http-api)
  * [`rabbitmq-collect-env`](https://github.com/rabbitmq/support-tools) which collects relevant cluster and environment information
     as well as server logs. This tool is specific to Linux and UNIX-like operating systems.
 
@@ -66,7 +66,7 @@ including virtual host, user and permission management, destructive operations
 on node's data and so on.
 
 `rabbitmqadmin` is built on top of the HTTP API and uses a different mechanism, and only
-requires that the [HTTP API](./management) port is open for outside connections.
+requires that the [HTTP API](./management#http-api) port is open for outside connections.
 
 Even though CLI tools ship with the server, most commands [can be used to operate on remote nodes](#remote-nodes).
 Plugins can [provide CLI commands](#command-discovery) that will be discovered by CLI tools for explicitly enabled plugins.
@@ -92,8 +92,8 @@ that has RabbitMQ installed.
 root is added to `PATH` for simpler interactive use. Non-interactive use cases can use full or relative paths without
 modifications to the `PATH` environment variable.
 
-[`rabbitmqadmin`](./management-cli) is a standalone tool (no dependencies other than Python 3)
-that can be downloaded from a running node or [directly from GitHub](https://github.com/rabbitmq/rabbitmq-server/blob/main/deps/rabbitmq_management/bin/rabbitmqadmin).
+[`rabbitmqadmin`](./management-cli) is a standalone tool
+that is [distributed via GitHub releases](https://github.com/rabbitmq/rabbitmqadmin-ng/releases).
 
 If interaction from a remote node is required, download and extract the [generic UNIX package](./install-generic-unix)
 or use the [Windows installer](./install-windows).
@@ -245,7 +245,7 @@ Most commands only support the online mode (when target node is running).
 `rabbitmq-upgrade` uses a [shared secret authentication mechanism](#erlang-cookie) (described below) with server nodes.
 
 
-### Offline Mode {#offline-mode}
+## Offline Mode {#offline-mode}
 
 `--offline` is a flag supported by `rabbitmq-plugins` commands. When provided, the tool will avoid
 contacting the target node and instead operate on plugin files directly.
@@ -737,10 +737,10 @@ rabbitmqctl.bat shutdown --node [email protected]
 It is not a replacement for `rabbitmqctl` and provides access to a subset of most commonly
 performed operations provided by the [management UI](./management).
 
-The tool requires Python 2.7.9 or a more recent version.
+`rabbitmqadmin` uses HTTP API authentication mechanism (basic HTTP authentication).
 
-`rabbitmqadmin` uses HTTP API authentication mechanism (basic HTTP authentication). It has to be
-downloaded separately from a running node or [GitHub](https://github.com/rabbitmq/rabbitmq-server/blob/main/deps/rabbitmq_management/bin/rabbitmqadmin).
+It is a native binary and must be [downloaded separately](https://github.com/rabbitmq/rabbitmqadmin-ng/releases) from the RabbitMQ
+distribution.
 
 
 ## "Node-local" and "Clusterwide" Commands {#cli-and-clustering}