rabbitmq-queues.8

名称

rabbitmq-queues — RabbitMQ 队列管理工具

语法

rabbitmq-queues

[-q] [-s] [-l] [-n 节点] [-t 超时时间] 命令 [命令选项]

描述

rabbitmq-queues 是一个命令行工具，提供用于管理队列的命令，例如，扩展、缩减或重新平衡复制队列类型的副本。请参阅 RabbitMQ 仲裁队列指南 和常规的 RabbitMQ 队列指南 ，以了解有关 RabbitMQ 中队列类型的更多信息。

选项

-n 节点

默认节点为“rabbit@目标主机名”，其中 目标主机名 是本地主机。在名为“myserver.example.com”的主机上，节点名称通常为“rabbit@myserver”（除非已覆盖 RABBITMQ_NODENAME）。“hostname -s”的输出通常是在“@”符号后使用的正确后缀。有关配置 RabbitMQ 节点的详细信息，请参阅 rabbitmq-server(8)。

-q, --quiet

选择静默输出模式。启用静默模式时，信息性消息会减少。

-s, --silent

选择静音输出模式。启用静音模式时，信息性消息会减少，并且表头会被抑制。

-t 超时时间, --timeout 超时时间

操作超时时间（秒）。并非所有命令都支持超时。默认为 无限。

-l, --longnames

当集群配置为使用长（FQDN）节点名称时，必须指定此选项。要了解更多信息，请参阅 RabbitMQ 集群指南

--erlang-cookie cookie

用于向目标节点进行身份验证的共享密钥。建议使用本地文件或 RABBITMQ_ERLANG_COOKIE 环境变量，而不是在命令行上指定此选项。要了解更多信息，请参阅 RabbitMQ CLI 工具指南

命令

help

显示 rabbitmq-queues 支持的常规帮助和命令。

集群

grow 节点 选择器 --vhost-pattern 模式 --queue-pattern 模式 --errors-only

为所有或一半匹配的仲裁队列在给定节点上添加一个新的副本。

支持的 选择器 值为

all

选择所有仲裁队列

even

选择具有偶数个副本的仲裁队列

示例

rabbitmq-queues grow "rabbit@newhost" "all" --vhost-pattern "a-vhost" --queue-pattern ".*"

rebalance 类型 --vhost-pattern 模式 --queue-pattern 模式

在集群节点之间重新平衡队列领导者副本。

支持的 类型 值为

all

所有队列类型

quorum

仅仲裁队列

classic

仅经典队列

stream

仅流

示例

rabbitmq-queues rebalance "all" --vhost-pattern "a-vhost" --queue-pattern ".*"

shrink 节点

通过删除给定节点上的任何成员（副本）来缩减仲裁队列集群。

示例

rabbitmq-queues shrink "rabbit@decomissioned-node"

复制

add_member 队列 节点 --vhost 虚拟主机

在给定节点上添加仲裁队列成员（副本）。

示例

rabbitmq-queues add_member --vhost "a-vhost" "a-queue" "rabbit@new-node"

delete_member 队列 节点 --vhost 虚拟主机

删除给定节点上的仲裁队列成员（副本）。

示例

rabbitmq-queues delete_member --vhost "a-vhost" "a-queue" "rabbit@decomissioned-node"

队列

quorum_status 队列 --vhost 虚拟主机

显示仲裁队列的仲裁状态。

示例

rabbitmq-queues quorum_status --vhost "a-vhost" "a-queue"

peek 队列 位置 --vhost 虚拟主机 --timeout

显示队列中给定位置的消息的详细信息。此命令目前仅受仲裁队列支持。

示例

rabbitmq-queues peek --vhost "a-vhost" "a-queue" "1"

check_if_cluster_has_classic_queue_mirroring_policy

如果集群中存在启用经典队列镜像的策略，则此健康检查将以非零代码退出。自 2021 年起，经典队列镜像已弃用，并在 RabbitMQ 4.0 开发周期中完全删除。

示例

rabbitmq-queues check_if_cluster_has_classic_queue_mirroring_policy

check_if_node_is_quorum_critical

如果存在具有最低在线仲裁数（如果目标节点关闭，其仲裁数将减少的队列），则此健康检查将以非零代码退出。

示例

rabbitmq-queues check_if_node_is_quorum_critical

另请参阅

rabbitmqctl(8)、rabbitmq-diagnostics(8)、rabbitmq-server(8)、rabbitmq-streams(8)、rabbitmq-upgrade(8)、rabbitmq-service(8)、rabbitmq-env.conf(5)、rabbitmq-echopid(8)

作者

RabbitMQ 团队 <contact-tanzu-data.pdl@broadcom.com>