ActiveMQ Artemis 控制台文件

文件 > 使用控制台

連線至 Broker

新增連線

當您導覽至連線頁面後,請點擊新增連線按鈕,並填入您的 Broker 的 Jolokia 端點設定。

端點詳細資訊將取決於您的特定 Broker 設定,但可以在 Broker 啟動時列印到主控台的訊息中輕鬆找到。例如,一個顯示啟動訊息的全新 Broker 實例

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

將產生以下連線詳細資訊

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

請根據您的特定 Broker 實例需求進行設定。您可以在點擊新增以儲存連線之前,使用測試連線按鈕測試連線:編輯連線圖片

新增連線後,只需點擊您的 Broker 的連線按鈕,這應該會開啟一個新分頁並提示登入嘗試。登入後,您應該會看到包含兩個 Artemis 選單項目的控制台。

Connection Image

從左側選單有兩個 Artemis 檢視可供使用,即 Artemis 檢視和 Artemis JMX 檢視。

Artemis JMX 檢視使用 JMX 樹狀結構導覽資源,並呈現每個特定 MBean 的 JMX 屬性和操作以及公開的功能。

Artemis 檢視是一組索引標籤,以表格檢視形式公開功能,用於分頁瀏覽 Broker 資源,例如位址和佇列。

Artemis JMX 檢視

在左側導覽列中點擊 Artemis JMX 以查看 Artemis JMX 特定外掛程式。(如果此 JVM 中沒有 Broker,則不會顯示 Artemis 索引標籤)。Artemis 外掛程式的工作方式與 JMX 外掛程式非常相似,但重點是與 Artemis Broker 互動。

樹狀檢視

左側的樹狀檢視顯示 JVM 中執行的每個 Broker 實例的最上層 JMX 樹狀結構。展開樹狀結構將顯示 Artemis 註冊的各種 MBean,您可以透過「屬性」索引標籤檢查這些 MBean。在樹狀結構中選取特定 MBean 時,會顯示一組相關的索引標籤

Connection Image

預設索引標籤

所有 MBean 預設都會顯示下列索引標籤,這些索引標籤在所有 MBean 上公開。

屬性

如果權限允許,屬性索引標籤會顯示在 MBean 上設定的所有屬性。根據使用者的權限,這些屬性可能是可編輯的。

操作

操作索引標籤會顯示所選 MBean 公開的 JMX 操作清單。根據使用者的權限,可以透過展開每個操作來執行這些操作。

圖表

圖表索引標籤可讓您檢視 MBean 的數值資料在時間序列上的變化。

位址索引標籤

如果選取的 MBean 是位址 MBean(在樹狀結構中的 addresses 葉節點下找到),那麼如果權限允許,您會看到下列索引標籤。

建立佇列

此索引標籤可讓使用者建立繫結至所選位址的佇列。它可以設定佇列上可用的參數子集,但可以使用一組鍵/值對來設定未公開的其他設定,例如 delay-before-dispatch 或 auto-delete。

刪除位址

刪除索引標籤可讓您完全刪除位址。

注意:只有在位址沒有佇列的情況下才能刪除,並且無法復原。

傳送訊息

傳送訊息 索引標籤可讓使用者傳送訊息至位址,這會將訊息路由至繫結至此位址的任何佇列。

它允許新增訊息標頭和訊息內文。請注意,建立的訊息類型始終是文字訊息。

注意:訊息的傳送將使用目前登入的使用者進行驗證,取消選取使用目前登入的使用者以使用不同的使用者。

佇列索引標籤

如果選取的 MBean 是佇列 MBean,則會顯示下列索引標籤。

注意:佇列 MBean 在其繫結的位址 MBean 下找到。

瀏覽訊息

這可讓使用者檢視所選佇列上訊息的分頁清單,以及檢視、傳送和刪除訊息。雖然結果大小可能非常大,但控制台每次只從 Broker 擷取單一頁面。當清單經過迭代或順序或篩選器變更時,控制台會重新擷取每一頁訊息。

Connection Image

篩選訊息

瀏覽索引標籤也可以使用 JMS 訊息選取器語法篩選訊息,如 Artemis 篩選器運算式文件中所述。例如,如果您想篩選包含訊息標頭 myheader 且設定為 octopus 的訊息,您可以在索引標籤左上角的文字方塊中輸入 myheader='octopus',然後點擊搜尋。

刪除訊息

可以透過選取左側每個訊息的相關核取方塊,然後點擊刪除按鈕來批量刪除訊息。這會開啟一個對話方塊以確認刪除。請注意,此操作無法復原。

注意:也可以個別刪除訊息,方法是點擊每個訊息右側的 3 個點,然後點擊刪除。

移動訊息

可以透過選取左側每個訊息的相關核取方塊,然後點擊移動按鈕,將訊息批量移動到另一個佇列。這會開啟一個對話方塊,其中包含可搜尋的下拉式方塊,方便搜尋可用的佇列,只需開始輸入您要將訊息移至的佇列名稱即可。請注意,此操作無法復原。

重新傳送訊息

可以透過點擊訊息右側的 3 個點,然後點擊重新傳送,將訊息重新傳送到不同的佇列。這會開啟一個對話方塊,可讓您將訊息的複本傳送到特定佇列。

瀏覽訊息

可以透過點擊訊息右側的 3 個點,然後點擊檢視按鈕來檢視訊息的內容。這會開啟一個顯示訊息內文、標頭和屬性的對話方塊。

Connection Image

請注意,如果訊息類型不是文字訊息,則訊息內文可能無法檢視。所有其他訊息都顯示為位元組,並將根據瀏覽位元組訊息設定進行轉換,該設定可以在喜好設定中設定。

注意:大型訊息也會被截斷以保護瀏覽器,這可以在 Artemis 位址設定中設定

注意:可以透過點擊管理欄連結,然後選取應該顯示哪些欄來設定顯示的欄。欄設定會儲存到瀏覽器的本機儲存空間,並且會在每個瀏覽器工作階段中擷取。

刪除佇列

刪除佇列索引標籤可讓您刪除整個佇列或清除訊息,也就是移除佇列中的所有訊息。

兩者都會開啟一個對話方塊以確認操作。此操作無法復原。

傳送訊息

傳送訊息 索引標籤可讓使用者直接將訊息傳送到佇列,請注意,與傳送訊息到位址不同,這會略過任何訊息路由語意,並直接放置在佇列上。

它允許新增訊息標頭和訊息內文。請注意,建立的訊息類型始終是文字訊息。

注意:訊息的傳送將使用目前登入的使用者進行驗證,取消選取使用目前登入的使用者以使用不同的使用者。

Artemis 檢視

在左側導覽列中點擊 Artemis 以查看 Artemis 特定外掛程式。(如果此 JVM 中沒有 Broker,則不會顯示 Artemis 索引標籤)。與 JMX 檢視不同,Artemis 檢視更側重於分頁瀏覽 Broker 資源,例如位址和佇列。不過,JMX 檢視中也提供相同的功能。Artemis 檢視中有以下索引標籤。

Artemis 檢視中顯示表格資料的所有索引標籤都可讓使用者設定要顯示哪些欄。這會儲存在工作階段的本機儲存空間中,並在新工作階段開始時可用。

狀態

狀態索引標籤是登入後顯示的預設索引標籤,顯示 Broker 的基本狀態,包括執行時間、使用的位址記憶體和部署的 Broker 類型。它還顯示每個已設定的 Acceptor 的狀態,以及 Broker 集群中的網路狀態。此狀態每 5 秒重新整理一次。

連線

連線索引標籤會列出與 Broker 的所有連線。

Connection Image

可以透過點擊左上方工具列上的排序圖示,選取要排序的欄,然後選擇遞增遞減來排序連線。

也可以透過從下拉式選單中選擇欄和運算子,然後點擊搜尋按鈕輸入要篩選的值,來在多個欄上篩選清單。

點擊工作階段計數值會導覽至工作階段索引標籤,並自動篩選選取的連線。

如果權限允許,可以透過點擊右側的 3 個點來關閉工作階段,然後點擊關閉按鈕。

工作階段

工作階段索引標籤會列出 Broker 上開啟的所有工作階段。

Sessions Image

可以透過點擊左上方工具列上的排序圖示,選取要排序的欄,然後選擇遞增遞減來排序工作階段。

也可以透過從下拉式選單中選擇欄和運算子,然後點擊搜尋按鈕輸入要篩選的值,來在多個欄上篩選清單。

點擊連線 ID 值會自動導覽至連線索引標籤,並篩選該連線。

點擊消費者計數將自動導覽至消費者索引標籤,並篩選選取的消費者。

點擊生產者計數將自動導覽至生產者索引標籤,並篩選選取的消費者。

如果權限允許,可以透過點擊右側的 3 個點來關閉工作階段,然後點擊關閉按鈕。

生產者

生產者索引標籤會列出 Broker 上開啟的所有生產者。

Producers Image

可以透過點擊左上方工具列上的排序圖示,選取要排序的欄,然後選擇遞增遞減來排序生產者。

也可以透過從下拉式選單中選擇欄和運算子,然後點擊搜尋按鈕輸入要篩選的值,來在多個欄上篩選清單。

點擊工作階段值會導覽至工作階段索引標籤,並篩選選取的工作階段。

點擊位址值會導覽至位址索引標籤,並篩選該位址

消費者

消費者索引標籤會列出 Broker 上開啟的所有消費者。

Consumers Image

可以透過點擊左上方工具列上的排序圖示,選取要排序的欄,然後選擇遞增遞減來排序消費者。

也可以透過從下拉式選單中選擇欄和運算子,然後點擊搜尋按鈕輸入要篩選的值,來在多個欄上篩選清單。

點擊工作階段值會導覽至工作階段索引標籤,並篩選選取的工作階段。

點擊位址值會導覽至位址索引標籤,並篩選該位址

點擊佇列值將會導覽至 位址 頁籤,並依該佇列進行篩選。

點擊消費者右邊的 3 個點,然後點擊關閉,即可關閉消費者。

位址

位址 頁籤將會列出 Broker 上所有的位址。

Addresses Image

點擊左上方工具列的排序圖示,選擇要排序的欄位,然後選擇遞增遞減,即可排序位址。

也可以透過從下拉式選單中選擇欄和運算子,然後點擊搜尋按鈕輸入要篩選的值,來在多個欄上篩選清單。

點擊佇列計數值將會導覽至 位址 頁籤,並依該位址進行篩選。

點擊每個位址右邊的 3 個點,使用者可以執行以下操作。

在 Artemis JMX 中顯示

這將會導覽至 Artemis JMX 檢視畫面,並自動選取位址 MBean。

屬性

這將會開啟一個對話方塊,顯示所有佇列 MBean 的屬性,並允許在權限許可的情況下進行編輯。

操作

這將會開啟一個對話方塊,顯示所有佇列 MBean 的操作,並允許在權限許可的情況下執行。

刪除位址

這將會開啟一個對話方塊,確認是否在權限許可的情況下刪除位址。

傳送訊息

這將會開啟一個對話方塊,允許使用者在權限許可的情況下傳送訊息到此佇列。

建立佇列

這將會開啟一個對話方塊,允許使用者在權限許可的情況下傳送訊息到此佇列。進而將訊息路由至綁定到此位址的所有佇列。

它允許新增訊息標頭和訊息內文。請注意,建立的訊息類型始終是文字訊息。

注意:訊息的傳送將使用目前登入的使用者進行驗證,取消選取使用目前登入的使用者以使用不同的使用者。

建立佇列

這將會開啟一個對話方塊,允許使用者建立綁定到所選位址的佇列。它提供配置佇列上可用參數子集的功能,然而,未公開的額外配置可以使用一組鍵/值對進行配置,例如 delay-before-dispatch 或 auto-delete。

佇列

佇列 頁籤將會列出 Broker 上所有的位址。

Queues Image

點擊左上方工具列的排序圖示,選擇要排序的欄位,然後選擇遞增遞減,即可排序佇列。

也可以透過從下拉式選單中選擇欄和運算子,然後點擊搜尋按鈕輸入要篩選的值,來在多個欄上篩選清單。

點擊位址值將會導覽至 位址 頁籤,並依所選位址進行篩選。

點擊消費者計數值將會導覽至 消費者 頁籤,並依所選佇列進行篩選。

點擊訊息計數值將會顯示不同的檢視畫面,允許使用者瀏覽訊息。

這可讓使用者檢視所選佇列上訊息的分頁清單,以及檢視、傳送和刪除訊息。雖然結果大小可能非常大,但控制台每次只從 Broker 擷取單一頁面。當清單經過迭代或順序或篩選器變更時,控制台會重新擷取每一頁訊息。

Connection Image

篩選訊息

瀏覽索引標籤也可以使用 JMS 訊息選取器語法篩選訊息,如 Artemis 篩選器運算式文件中所述。例如,如果您想篩選包含訊息標頭 myheader 且設定為 octopus 的訊息,您可以在索引標籤左上角的文字方塊中輸入 myheader='octopus',然後點擊搜尋。

刪除訊息

可以透過選取左側每個訊息的相關核取方塊,然後點擊刪除按鈕來批量刪除訊息。這會開啟一個對話方塊以確認刪除。請注意,此操作無法復原。

注意:也可以個別刪除訊息,方法是點擊每個訊息右側的 3 個點,然後點擊刪除。

移動訊息

可以透過選取左側每個訊息的相關核取方塊,然後點擊移動按鈕,將訊息批量移動到另一個佇列。這會開啟一個對話方塊,其中包含可搜尋的下拉式方塊,方便搜尋可用的佇列,只需開始輸入您要將訊息移至的佇列名稱即可。請注意,此操作無法復原。

重新傳送訊息

可以透過點擊訊息右側的 3 個點,然後點擊重新傳送,將訊息重新傳送到不同的佇列。這會開啟一個對話方塊,可讓您將訊息的複本傳送到特定佇列。

從此頁籤的瀏覽檢視畫面中,您可以點擊訊息右邊的 3 個點,然後點擊檢視按鈕,來瀏覽單一訊息。這將會變更檢視畫面為

browse2 Image

注意:您可以使用左下角的佇列瀏覽按鈕,在每個檢視畫面之間導覽。

Broker 圖表

Broker 圖表 頁籤會顯示 Broker、其位址、佇列以及可能在叢集中的任何其他 Broker 的視覺表示。您可以點擊節點選項下拉式選單,選擇要顯示的節點。

點擊節點也會擷取與該節點相關聯的 MBean 的屬性。

Diagram Image

安全性

Jolokia 存取

Jolokia JMX-HTTP 橋接器是透過 Broker 設定目錄中的原則檔案:‘etc/jolokia-access.xml’ 來保護。該檔案的內容應該按照 Jolokia 安全指南中的描述進行修改。預設情況下,主控台會鎖定為 ‘localhost’,在透過網路公開主控台 Web 端點時,請特別注意 ‘CORS’ 限制。

MBean 存取

MBean 的存取是在 ActiveMQ Artemis 中設定的,請參閱 透過 JMX 管理 章節。

某些畫面和頁籤的顯示與否,是由特定 JMX 操作的存取權限控制的,例如,只有當使用者有權存取建立佇列的 JMX 操作時,才會顯示 建立佇列 頁籤。

單一登入

請參閱 HawtIO 文件

Apache、ActiveMQ、Apache ActiveMQ、Apache 羽毛標誌和 Apache ActiveMQ 專案標誌是 The Apache Software Foundation 的商標。版權所有 © 2024,The Apache Software Foundation。依據 Apache License 2.0 授權。