ActiveMQ Artemis 控制台文档

文档 > 使用控制台

连接到代理

添加连接

导航到“连接”页面后，单击“添加连接”按钮并填写代理的 Jolokia 端点配置。

端点详细信息将取决于您的特定代理配置，但可以在代理启动期间打印到控制台的消息中轻松找到。例如，一个新的代理实例显示启动消息

AMQ241002: Artemis Jolokia REST API available at https://127.0.0.1:8161/console/jolokia

将产生连接详细信息

Host: localhost
Port: 8161
Path: /console/jolokia

根据您的特定代理实例进行配置。您可以在单击“添加”以保存连接之前，使用“测试连接”按钮测试连接：

添加连接后，只需单击代理的“连接”按钮，这将打开一个新标签并提示进行登录尝试。登录后，您应该会看到带有两个 Artemis 菜单项的控制台。

导航 Artemis 视图

左侧菜单中有两个可用的 Artemis 视图，即 **Artemis** 视图和 **Artemis JMX** 视图。

通过 Artemis JMX 视图，可以使用 JMX 树导航资源，并显示每个特定 MBean 的 JMX 属性和操作，以及公开的功能。

通过 Artemis 视图，可以使用一组选项卡以表格视图显示功能，用于分页浏览代理资源，例如地址和队列。

Artemis JMX 视图

单击左侧导航栏中的 **Artemis JMX** 以查看特定于 Artemis JMX 的插件。（如果 JVM 中没有代理，则不会显示 Artemis 选项卡）。Artemis 插件的工作方式与 JMX 插件非常相似，但侧重于与 Artemis 代理交互。

树状视图

左侧的树状视图显示了 JVM 中运行的每个代理实例的顶级 JMX 树。展开树将显示 Artemis 注册的各种 MBean，您可以通过“属性”选项卡检查这些 MBean。在树中选择特定 MBean 时，一组相关的选项卡将变得可见

默认选项卡

默认情况下，所有 MBean 都将显示以下选项卡，这些选项卡在所有 MBean 上公开。

属性

如果权限允许，**属性** 选项卡将显示在 MBean 上配置的所有属性。根据用户的权限，这些属性可能是可编辑的。

操作

**操作** 选项卡公开所选 MBean 公开的 JMX 操作列表。根据用户的权限，可以通过展开每个操作来执行这些操作。

图表

**图表** 选项卡允许您查看 MBean 的数值数据，这些数据沿时间序列显示。

地址选项卡

如果所选 MBean 是地址 MBean（在树的“addresses”叶子下找到），那么如果权限允许，您将看到以下选项卡。

创建队列

此选项卡允许用户创建绑定到所选地址的队列。它公开了对队列上可用参数子集进行配置的功能，但是可以使用一组键值对配置未公开的其他配置，例如 delay-before-dispatch 或 auto-delete。

删除地址

**删除** 选项卡允许您完全删除地址。

注意：只有当地址没有队列并且无法撤消时，才能删除地址。

发送消息

此 **发送消息** 选项卡允许用户将消息发送到地址，这将依次将消息路由到绑定到此地址的任何队列。

它允许添加消息头和消息正文。请注意，创建的消息类型始终是文本消息。

注意：将使用当前登录用户对消息的发送进行身份验证，取消选中“使用当前登录用户”以使用其他用户。

队列选项卡

如果所选 MBean 是 *队列* MBean，则将显示以下选项卡。

注意：队列 MBean 在其绑定的 *地址* MBean 下找到。

浏览消息

这允许用户查看所选队列上消息的分页列表，并能够查看、发送和删除消息。尽管结果大小可能非常大，但控制台每次只从代理中获取一页。当迭代列表或更改顺序或过滤器时，控制台将重新获取每页消息。

筛选消息

**浏览** 选项卡还可以使用 JMS 消息选择器语法筛选消息，如 Artemis 筛选器表达式文档 中所述。例如，如果您想筛选包含设置为 octopus 的消息头的 myheader 的消息，则在选项卡左上角的文本框中输入 **myheader=’octopus’**，然后单击搜索。

删除消息

可以通过选中左侧每个消息的相关复选框，然后单击 *删除* 按钮来批量删除消息。这将打开一个对话框，用于确认删除。请注意，此操作无法撤消。

注意：也可以通过单击每个消息右侧的 3 个点，然后单击删除来单独删除消息。

移动消息

可以通过选中左侧每个消息的相关复选框，然后单击 *移动* 按钮来将消息批量移动到另一个队列。这将打开一个对话框，其中包含一个可搜索的下拉框，用于轻松搜索可用队列，只需开始输入要将消息移动到的队列的名称即可。请注意，此操作无法撤消。

重新发送消息

可以通过单击消息右侧的 3 个点，然后单击 *重新发送* 来将消息重新发送到另一个队列。这将打开一个对话框，允许您将消息副本发送到特定队列。

浏览消息

可以通过单击消息右侧的 3 个点，然后单击 *查看* 按钮来查看消息的内容。这将打开一个对话框，显示消息的正文、头和属性。

请注意，如果消息不是文本消息类型，则可能无法查看消息正文。所有其他消息都将显示为字节，并将根据 **浏览字节消息** 设置进行转换，该设置可以在 **首选项** 中设置。

注意：大型消息也将被截断以保护浏览器，这可以在 Artemis 地址设置 中配置。

注意：可以通过单击 *管理列* 链接，然后选择要显示的列来配置显示的列。列配置将持久保存到浏览器的本地存储中，并在每个浏览器会话中检索。

删除队列

**删除队列** 选项卡允许您删除整个队列或清除消息，即删除队列中的所有消息。

两者都将打开一个对话框，以确认操作。此操作无法撤消。

发送消息

此 **发送消息** 选项卡允许用户将消息直接发送到队列。请注意，与发送到地址的 **发送消息** 不同，这将绕过任何消息路由语义，并直接放置到队列中。

它允许添加消息头和消息正文。请注意，创建的消息类型始终是文本消息。

注意：将使用当前登录用户对消息的发送进行身份验证，取消选中“使用当前登录用户”以使用其他用户。

Artemis 视图

单击左侧导航栏中的 Artemis 以查看特定于 Artemis 的插件。（如果 JVM 中没有代理，则不会显示 Artemis 选项卡）。与 JMX 视图不同，**Artemis 视图** 更侧重于分页浏览代理资源，例如地址和队列。但是，与 JMX 视图中相同的功能也可用。Artemis 视图中提供以下选项卡。

**Artemis 视图** 中显示表格数据的每个选项卡都允许用户配置要显示的列。这将持久保存到会话的本地存储中，并在启动新会话时可用。

状态

**状态** 选项卡是登录后显示的默认选项卡，显示代理的基本状态，包括正常运行时间、地址内存使用情况和部署的代理类型。它还显示每个配置的 **接收器** 的状态，以及代理集群的网络状态。此状态每 5 秒刷新一次。

连接

**连接** 选项卡列出所有与代理的连接。

可以通过单击左上角工具栏上的排序图标，选择要排序的列，然后选择 *升序* 或 *降序* 来对连接进行排序。

还可以通过从下拉菜单中选择列和运算符，输入要筛选的值，然后单击 *搜索* 按钮来对多个列进行筛选列表。

单击 *会话数量* 值将导航到 **会话** 选项卡，并自动筛选所选连接。

如果权限允许，可以通过单击右侧的 3 个点，然后单击 *关闭* 按钮来关闭会话。

会话

**会话** 选项卡将列出代理上打开的所有会话。

可以通过单击左上角工具栏上的排序图标，选择要排序的列，然后选择 *升序* 或 *降序* 来对会话进行排序。

还可以通过从下拉菜单中选择列和运算符，输入要筛选的值，然后单击 *搜索* 按钮来对多个列进行筛选列表。

单击 *连接 ID* 值将自动导航到 **连接** 选项卡，并筛选该连接。

单击 *消费者数量* 将自动导航到 **消费者** 选项卡，并筛选所选消费者。

单击 *生产者数量* 将自动导航到 **生产者** 选项卡，并筛选所选消费者。

如果权限允许，可以通过单击右侧的 3 个点，然后单击 *关闭* 按钮来关闭会话。

生产者

**生产者** 选项卡将列出代理上打开的所有生产者。

可以通过单击左上角工具栏上的排序图标，选择要排序的列，然后选择 *升序* 或 *降序* 来对生产者进行排序。

还可以通过从下拉菜单中选择列和运算符，输入要筛选的值，然后单击 *搜索* 按钮来对多个列进行筛选列表。

单击 *会话* 值将导航到 **会话** 选项卡，并筛选所选会话。

单击 *地址* 值将导航到 **地址** 选项卡，并筛选该地址

消费者

**消费者** 选项卡将列出代理上打开的所有消费者。

可以通过单击左上角工具栏上的排序图标，选择要排序的列，然后选择 *升序* 或 *降序* 来对消费者进行排序。

还可以通过从下拉菜单中选择列和运算符，输入要筛选的值，然后单击 *搜索* 按钮来对多个列进行筛选列表。

单击 *会话* 值将导航到 **会话** 选项卡，并筛选所选会话。

单击 *地址* 值将导航到 **地址** 选项卡，并筛选该地址

点击队列值将导航到地址选项卡并筛选该队列。

可以通过点击消费者右侧的三个点，然后点击关闭来关闭消费者。

地址

地址选项卡将列出代理上的所有地址。

可以通过点击左上角工具栏上的排序图标，选择要排序的列，并选择升序或降序来对地址进行排序。

还可以通过从下拉菜单中选择列和运算符，输入要筛选的值，然后单击 *搜索* 按钮来对多个列进行筛选列表。

点击队列计数值将导航到地址选项卡并筛选该地址。

每个地址右侧的三个点将允许用户执行以下操作。

在 Artemis JMX 中显示

这将导航到Artemis JMX视图并自动选择地址 MBean。

属性

这将打开一个对话框，显示所有队列 MBean 属性，并允许编辑（如果权限允许）。

操作

这将打开一个对话框，显示所有队列 MBean 操作，并允许执行（如果权限允许）。

删除地址

这将打开一个对话框，如果权限允许，将确认删除地址。

发送消息

这将打开一个对话框，如果权限允许，将允许用户向此队列发送消息。

创建队列

这将打开一个对话框，如果权限允许，将允许用户向此队列发送消息。这将依次将其路由到绑定到此地址的任何队列。

它允许添加消息头和消息正文。请注意，创建的消息类型始终是文本消息。

注意：将使用当前登录用户对消息的发送进行身份验证，取消选中“使用当前登录用户”以使用其他用户。

创建队列

这将打开一个对话框，允许用户创建绑定到所选地址的队列。它提供了配置队列上可用的参数子集的功能，但是，可以使用键值对配置未公开的额外配置，例如延迟转发或自动删除。

队列

队列选项卡将列出代理上的所有地址。

可以通过点击左上角工具栏上的排序图标，选择要排序的列，并选择升序或降序来对队列进行排序。

还可以通过从下拉菜单中选择列和运算符，输入要筛选的值，然后单击 *搜索* 按钮来对多个列进行筛选列表。

点击地址值将导航到地址选项卡并筛选所选地址。

点击消费者计数值将导航到消费者选项卡并筛选所选队列。

点击消息计数值将显示一个不同的视图，允许用户浏览消息。

这允许用户查看所选队列上消息的分页列表，并能够查看、发送和删除消息。尽管结果大小可能非常大，但控制台每次只从代理中获取一页。当迭代列表或更改顺序或过滤器时，控制台将重新获取每页消息。

筛选消息

**浏览** 选项卡还可以使用 JMS 消息选择器语法筛选消息，如 Artemis 筛选器表达式文档 中所述。例如，如果您想筛选包含设置为 octopus 的消息头的 myheader 的消息，则在选项卡左上角的文本框中输入 **myheader=’octopus’**，然后单击搜索。

删除消息

可以通过选中左侧每个消息的相关复选框，然后单击 *删除* 按钮来批量删除消息。这将打开一个对话框，用于确认删除。请注意，此操作无法撤消。

注意：也可以通过单击每个消息右侧的 3 个点，然后单击删除来单独删除消息。

移动消息

可以通过选中左侧每个消息的相关复选框，然后单击 *移动* 按钮来将消息批量移动到另一个队列。这将打开一个对话框，其中包含一个可搜索的下拉框，用于轻松搜索可用队列，只需开始输入要将消息移动到的队列的名称即可。请注意，此操作无法撤消。

重新发送消息

可以通过单击消息右侧的 3 个点，然后单击 *重新发送* 来将消息重新发送到另一个队列。这将打开一个对话框，允许您将消息副本发送到特定队列。

从该选项卡的浏览视图中，您可以通过点击消息右侧的三个点，然后点击查看按钮来浏览单个消息。这将更改视图到

注意：您可以使用左下角的队列和*浏览*按钮在每个视图之间导航。

代理图表

代理图表选项卡显示代理、其地址和队列以及群集中的任何其他代理的视觉表示。您可以通过点击节点选项下拉菜单来选择要显示的节点。

点击节点还会获取与节点关联的 MBean 的属性。

安全

Jolokia 访问

Jolokia JMX-HTTP 桥通过代理配置目录中的策略文件进行保护：“etc/jolokia-access.xml”。应根据Jolokia 安全指南中描述的步骤修改该文件的内容。默认情况下，控制台锁定为“localhost”，在通过网络公开控制台 Web 端点时，请特别注意“CORS”限制。

MBean 访问

MBean 访问在 ActiveMQ Artemis 中进行配置，请参阅通过 JMX 进行管理一章。

某些屏幕和选项卡的可见性由对特定 JMX 操作的访问权限控制，例如，只有在用户有权访问创建队列 JMX 操作时，才会显示创建队列选项卡。

单点登录

请参阅HawtIO 文档