4.5. AMQ 管理コンソールを使用したブローカーの管理


AMQ 管理コンソールを使用して、稼働中のブローカーに関する情報を表示し、以下のリソースを管理できます。

  • 着信ネットワーク接続 (アクセプター)
  • アドレス
  • Queues

4.5.1. ブローカーの詳細の表示

ブローカーの設定方法を確認するには、左側のメニューで Artemis をクリックします。フォルダーツリーでは、ローカルブローカーがデフォルトで選択されます。

メインペインで、以下のタブが利用できます。

ステータス

アップタイムやクラスター情報などのブローカーの現在のステータスに関する情報を表示します。また、ブローカーが現在使用しているアドレスメモリー容量も表示します。グラフでは、この値を global-max-size コ設定パラメーターに対する割合で示しています。

図4.2 Status タブ

*Status* タブ
Connections
クライアント、クラスター、ブリッジ接続などのブローカー接続に関する情報を表示します。
セッション
ブローカーで現在開いているすべてのセッションに関する情報を表示します。
Consumers
ブローカーで現在開いているすべてのコンシューマーに関する情報を表示します。
Producers
ブローカーで現在開いているプロデューサーに関する情報を表示します。
アドレス
ブローカーのアドレスに関する情報を表示します。これには、store-and-forward アドレスなどの内部アドレスが含まれます。
Queues
ブローカーのキューに関する情報を表示します。これには、store-and-forward キューなどの内部キューが含まれます。
属性
ブローカーに設定された属性に関する詳細情報を表示します。
操作
コンソールからブローカーで実行できる JMX 操作を表示します。操作をクリックすると、ダイアログボックスが開き、操作のパラメーター値を指定できます。
チャート
ブローカーに設定された属性のリアルタイムデータを表示します。チャートを編集して、チャートに含まれる属性を指定できます。
Broker diagram
クラスタートポロジーの図を表示します。これには、クラスター内のすべてのブローカーと、ローカルブローカーのアドレスおよびキューが含まれます。

4.5.2. ブローカーダイアグラムの表示

ブローカー (ライブおよびバックアップブローカー)、プロデューサーおよびコンシューマー、アドレス、およびキューなど、トポロジー内のすべての AMQ Broker リソースの図を表示できます。

手順

  1. 左側のメニューで Artemis をクリックします。
  2. メインペインで、Broker diagram タブをクリックします。

    コンソールは、クラスタートポロジーの図を表示します。これには、図に示すように、クラスター内のすべてのブローカーとローカルブローカーのアドレスおよびキューが含まれます。

    図4.3 ブローカーのダイアグラム タブ

    *Broker diagram* タブ
  3. ダイアグラムに表示される項目を変更するには、ダイアグラムの上部にあるチェックボックスを使用します。Refresh をクリックします。
  4. ローカルブローカーの属性、または接続先のアドレスまたはキューの属性を表示するには、ダイアグラムのそのノードをクリックします。たとえば、以下の図は、ローカルブローカーの属性も含まれる図を示しています。

    図4.4 属性を含むブローカーダイアグラム タブ

    *Broker diagram* タブ

4.5.3. アクセプターの表示

ブローカーに設定されたアクセプターの詳細を表示できます。

手順

  1. 左側のメニューで Artemis をクリックします。
  2. フォルダーツリーで、acceptors をクリックします。
  3. アクセプターの設定方法の詳細を表示するには、アクセプターをクリックします。

    コンソールには、図に示すように Attributes タブの対応する属性が表示されます。

    図4.5 AMQP アクセプター属性

    AMQP アクセプター属性
  4. 属性の詳細を表示するには、属性をクリックします。詳細を表示する追加のウィンドウが開きます。

4.5.4. アドレスおよびキューの管理

アドレスはメッセージングエンドポイントを表します。設定内で、通常のアドレスには一意の名前が指定されます。

キューがアドレスに関連付けられます。アドレスごとに複数のキューが存在する場合があります。受信メッセージがアドレスにマッチすると、設定されたルーティングタイプに応じて、メッセージは 1 つ以上のキューに送信されます。キューは、自動作成および削除ができるように設定できます。

4.5.4.1. アドレスの作成

一般的なアドレスには、一意の名前、ゼロ以上のキュー、およびルーティングタイプが指定されます。

ルーティングタイプは、アドレスに関連付けられたキューへメッセージが送信される方法を決定します。アドレスは、2 つの異なるルーティングタイプで設定できます。

メッセージをルーティング先とルーティングする場合

このルーティングタイプを使用する...

ポイントツーポイント方式で、一致するアドレス内の単一キュー。

Anycast

パブリッシュ/サブスクライブ方式で、一致するアドレス内のすべてのキュー。

マルチキャスト

アドレスおよびキューを作成および設定し、使用されていない場合はそれらを削除できます。

手順

  1. 左側のメニューで Artemis をクリックします。
  2. フォルダーツリーで addresses をクリックします。
  3. メインペインで、Create address タブをクリックします。

    図に示すように、アドレスを作成するページが表示されます。

    図4.6 Create Address ページ

    AMQ 管理コンソール Create Address
  4. 以下のフィールドに入力します。

    Address name
    アドレスのルーティング名。
    Routing type

    以下のオプションのいずれかを選択します。

    • Multicast: アドレスに送信されたメッセージは、パブリッシュサブスクライブ方式ですべてのサブスクライバーに配信されます。
    • Anycast: このアドレスに送信されたメッセージは、ポイントツーポイント方式で 1 人のサブスクライバーにのみ配信されます。
    • Both: アドレスごとに複数のルーティングタイプを定義できます。通常、これによりアンチパターンが発生するため、推奨されません。

      注記

      アドレスが両方のルーティングタイプを使用し、クライアントがどちらにも優先していない場合、ブローカーはデフォルトで anycast ルーティングタイプに設定されます。1 つの例外は、クライアントが MQTT プロトコルを使用する場合です。この場合、デフォルトのルーティングタイプは multicast です。

  5. Create Address をクリックします。

4.5.4.2. アドレスへのメッセージの送信

以下の手順では、コンソールを使用してメッセージをアドレスに送信する方法を説明します。

手順

  1. 左側のメニューで Artemis をクリックします。
  2. フォルダーツリーで、アドレスを選択します。
  3. メインペインのナビゲーションバーで More Send message をクリックします。

    図に示すように、メッセージを作成するページが表示されます。

    図4.7 Send Message ページ

    AMQ 管理コンソール Send Message
  4. デフォルトでは、メッセージは AMQ 管理コンソールへのログインに使用した認証情報を使用して送信されます。別の認証情報を使用する場合は、Use current logon user チェックボックスをオフにし、チェックボックスをオフにすると表示される Username フィールドと Password フィールドに値を指定します。
  5. 必要な場合は、Add Header ボタンをクリックしてメッセージヘッダー情報を追加します。
  6. メッセージのボディーを入力します。
  7. Format ドロップダウンメニューで、メッセージのボディーのフォーマットのオプションを選択し、Format をクリックします。メッセージ本文は、選択した形式向けに人間が判読できるスタイルでフォーマットされます。
  8. Send message をクリックします。

    メッセージは送信されます。

  9. 追加のメッセージを送信するには、入力した情報のいずれかを変更し、Send message をクリックします。

4.5.4.3. キューの作成

キューは、プロデューサーとコンシューマー間のチャネルを提供します。

前提条件

  • キューをバインドするアドレスが存在する必要があります。コンソールを使用してアドレスを作成する方法は、「アドレスの作成」 を参照してください。

手順

  1. 左側のメニューで Artemis をクリックします。
  2. フォルダーツリーで、キューをバインドするアドレスを選択します。
  3. メインペインで Create queue タブをクリックします。

    図に示すように、キューを作成するページが表示されます。

    図4.8 Create Queue ページ

    AMQ 管理コンソール Create Queue
  4. 以下のフィールドに入力します。

    Queue name
    キューの一意の名前。
    Routing type

    以下のオプションのいずれかを選択します。

    • Multicast: 親アドレスに送信されたメッセージは、アドレスにバインドされるすべてのキューに送信されます。
    • Anycast: 親アドレスにバインドされた 1 つのキューのみがメッセージのコピーを受信します。メッセージはアドレスにバインドされたすべてのキューに均等に分散されます。
    永続性
    このオプションを選択すると、キューとそのメッセージは永続化されます。
    フィルター
    ブローカーへの接続時に使用されるユーザー名。
    Max Consumers
    一度にキューにアクセスできるコンシューマーの最大数。
    Purge when no consumers
    選択した場合、コンシューマーが接続されていない場合にキューがパージされます。
  5. Create Queue をクリックします。

4.5.4.4. キューのステータスの確認

チャートは、ブローカーのキューのステータスのリアルタイムビューを提供します。

手順

  1. 左側のメニューで Artemis をクリックします。
  2. フォルダーツリーで、キューに移動します。
  3. メインペインで、Chart タブをクリックします。

    コンソールは、すべてのキュー属性のリアルタイムデータを表示するチャートを表示します。

    図4.9 キューのチャートタブ

    キューのチャートタブ
    注記

    あるアドレスの複数のキューのチャートを表示するには、キューを含む anycast または multicast のフォルダーを選択します。

  4. 必要に応じて、チャートに異なる基準を選択します。

    1. メインペインで、Edit をクリックします。
    2. Attributes リストで、チャートに追加する属性を 1 つ以上選択します。複数の属性を選択するには、Ctrl キーを押して保持し、各属性を選択します。
    3. View Chart ボタンをクリックします。チャートは選択した属性に基づいて更新されます。

4.5.4.5. キューの参照

キューを参照すると、キュー内のすべてのメッセージが表示されます。また、リストをフィルタリングしてソートして、特定のメッセージを見つけることもできます。

手順

  1. 左側のメニューで Artemis をクリックします。
  2. フォルダーツリーで、キューに移動します。

    キューはバインドされるアドレス内にあります。

  3. メインペインのナビゲーションバーで More Browse queue をクリックします。

    キューのメッセージが表示されます。デフォルトでは、最初の 200 メッセージが表示されます。

    図4.10 Browse Queue ページ

    Browse Queue ページ
  4. 特定のメッセージまたはメッセージのグループを参照するには、以下のいずれかを行います。

    次を行う場合:こちらを実行します。

    メッセージリストをフィルターします。

    Filter…​ テキストフィールドで、フィルター基準を入力します。検索 (虫眼鏡) アイコンをクリックします。

    メッセージリストを並べ替えます。

    メッセージのリストで、列ヘッダーをクリックします。メッセージを降順に並び替えるには、ヘッダーを 2 回クリックします。

  5. メッセージの内容を表示するには、Show ボタンをクリックします。

    メッセージヘッダー、プロパティー、およびボディーを表示できます。

4.5.4.6. キューへのメッセージの送信

キューの作成後、メッセージを送信できます。以下の手順は、メッセージを既存のキューに送信するのに必要な手順の概要を説明します。

手順

  1. 左側のメニューで Artemis をクリックします。
  2. フォルダーツリーで、キューに移動します。
  3. メインペインで Send message タブをクリックします。

    メッセージを作成するページが表示されます。

    図4.11 キューのメッセージページの送信

    キューへのメッセージ送信
  4. デフォルトでは、メッセージは AMQ 管理コンソールへのログインに使用した認証情報を使用して送信されます。別の認証情報を使用する場合は、Use current logon user チェックボックスをオフにし、チェックボックスをオフにすると表示される Username フィールドと Password フィールドに値を指定します。
  5. 必要な場合は、Add Header ボタンをクリックしてメッセージヘッダー情報を追加します。
  6. メッセージのボディーを入力します。
  7. Format ドロップダウンメニューで、メッセージのボディーのフォーマットのオプションを選択し、Format をクリックします。メッセージ本文は、選択した形式向けに人間が判読できるスタイルでフォーマットされます。
  8. Send message をクリックします。メッセージは送信されます。
  9. 追加のメッセージを送信するには、入力した情報のいずれかを変更し、Send message をクリックします。

4.5.4.7. キューへのメッセージの再送信

以前送信されたメッセージを再送信できます。

手順

  1. 再送信するメッセージを参照します。
  2. 再送信するメッセージの横にあるチェックボックスをクリックします。
  3. Resend ボタンをクリックします。メッセージが表示されます。
  4. 必要に応じて メッセージヘッダーとボディー を更新し、Send message をクリックします。

4.5.4.8. 別のキューへのメッセージの移動

キュー内の 1 つ以上のメッセージを別のキューに移動できます。

手順

  1. 移動するメッセージを参照します
  2. 移動する各メッセージの横にあるチェックボックスをクリックします。
  3. ナビゲーションバーで、Move Messages をクリックします。

    確認ダイアログボックスが表示されます。

  4. ドロップダウンメニューから、メッセージを移動するキューの名前を選択します。Move をクリックします。

4.5.4.9. メッセージまたはキューの削除

キューからキューを削除したり、すべてのメッセージをパージしたりすることができます。

手順

  1. 削除またはパージするキューを参照します
  2. 次のいずれかを行います。

    次を行う場合:こちらを実行します。

    キューからメッセージを削除します。

    1. 削除する各メッセージの横にあるチェックボックスをクリックします。
    2. Delete ボタンをクリックします。

    キューからすべてのメッセージをパージします。

    1. メインペインのナビゲーションバーで、Delete queue をクリックします。
    2. Purge Queue ボタンをクリックします。

    キューの削除

    1. メインペインのナビゲーションバーで、Delete queue をクリックします。
    2. Delete Queue ボタンをクリックします。
Red Hat logoGithubRedditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

© 2024 Red Hat, Inc.