WebLogic JMS のコンフィグレーションと管理
|
 |
 |
|
このリリースで追加されたメッセージ管理ツールにより、Administration Console または新しいパブリックな実行時 API を使用して、実行中の JMS サーバですべてのメッセージを表示したりほとんどのメッセージを操作したりできるようになりました。これらのメッセージ管理機能には、トランザクション管理、恒久サブスクライバの管理、JMS クライアント接続の管理に加えて、メッセージの表示 (ソート用)、メッセージの操作 (作成、移動、削除など)、メッセージのインポートとエクスポートなどがあります。
以下の節では、Administration Console からの JMS メッセージをモニタおよび管理する方法について説明します。
WebLogic JMS をコンフィグレーションすると、アプリケーションで JMS API を使用してメッセージの送受信ができるようになります。詳細については、『WebLogic JMS プログラマーズ ガイド』の「Developing a Basic JMS Application」を参照してください。
統計をモニタできる JMS オブジェクトは、JMS サーバ、接続、キューとトピックの送り先、および JMS サーバ セッション プールです。
サーバが実行されていれば、JMS 統計は増え続けます。統計は、サーバを再起動するときにのみリセットされます。
ドメインで定義されているアクティブな JMS サーバに関する統計をモニタできます。JMS サーバは、JMS サーバに限定的に対象指定された JMS モジュール内の JMS キュー リソースおよび JMS トピック リソースの管理コンテナとして機能します。
JMS サーバの実行時統計の詳細については、Administration Console オンライン ヘルプの「JMS サーバ : モニタ」を参照してください。
Administration Console で JMS サーバをモニタする場合は、アクティブな送り先、トランザクション、接続、およびセッション プールもモニタできます。
JMS サーバに対象指定されているすべてのアクティブな送り先に関する統計をモニタできます。JMS 送り先は、JMS サーバに限定的に対象指定された JMS モジュール内のキュー送り先またはトピック送り先のタイプを特定します。
詳細については、Administration Console オンライン ヘルプの「JMS サーバ : モニタ : アクティブな送り先」を参照してください。
JMS サーバで実行しているすべてのアクティブなトランザクションに関する統計をモニタできます。
アクティブな JMS トランザクションの実行時統計の詳細については、Administration Console オンライン ヘルプの「JMS サーバ : モニタ : アクティブなトランザクション」を参照してください。
JMS サーバへのアクティブな JMS 接続に関する統計をモニタできます。JMS 接続は、メッセージング システムへの開かれた通信チャネルです。
アクティブな JMS サーバ接続の実行時統計の詳細については、Administration Console オンライン ヘルプの「JMS サーバ : モニタ : アクティブな接続」を参照してください。
JMS サーバ用に定義されているすべてのアクティブな JMS セッション プールに関する統計をモニタできます。セッション プールを使用すると、アプリケーションでメッセージを並行して処理できます。
アクティブな JMS セッション プールの実行時統計の詳細については、Administration Console オンライン ヘルプの「JMS サーバ : モニタ : アクティブなセッション プール」を参照してください。
JMS モジュール内のキュー リソースに関する統計をモニタできます。JMS キューでは、JMS サーバのポイント ツー ポイントの送り先タイプが定義されます。キューは、非同期のピア通信に使用されます。キューに配信されたメッセージは、1 つのコンシューマに配信されます。
キュー リソースの実行時統計の詳細については、Administration Console オンライン ヘルプの「JMS キュー : モニタ : 統計」を参照してください。
キュー上のメッセージを管理することもできます。詳細については、「JMS メッセージの管理」を参照してください。
JMS モジュール内のトピック リソースに関する統計をモニタできます。JMS トピックでは、JMS サーバのパブリッシュ/サブスクライブの送り先タイプが定義されます。トピックは、非同期のピア通信に使用されます。トピックに配信されたメッセージは、すべてのトピック コンシューマに配信されます。
トピック リソースの実行時統計の詳細については、Administration Console オンライン ヘルプの「JMS トピック : モニタ : 統計」を参照してください。
JMS モジュール内の共通分散キュー リソースに関する統計をモニタできます。分散キューは、単一の JNDI 名でアクセスされ、クライアントからは単一の論理的な送り先に見える物理的なキューのセットです。分散送り先のメンバーは、実際にはクラスタ内の複数のサーバに分散されており、各送り先メンバーは個々の JMS サーバに属しています。
共通分散キュー リソースの実行時統計の詳細については、Administration Console オンライン ヘルプの「共通分散キュー : モニタ」を参照してください。
JMS モジュール内の共通分散トピック リソースに関する統計をモニタできます。分散トピックは、単一の JNDI 名でアクセスされ、クライアントからは単一の論理的な送り先に見える物理的なトピックのセットです。分散送り先のメンバーは、実際にはクラスタ内の複数のサーバに分散されており、各送り先メンバーは個々の JMS サーバに属しています。
共通分散トピック リソースの実行時統計の詳細については、Administration Console オンライン ヘルプの「共通分散トピック : モニタ」を参照してください。
Weblogic JMS メッセージのモニタ機能と管理機能を使用すると、新しいメッセージの作成、選択したメッセージの削除、別のキューへのメッセージの移動、別のファイルへのメッセージ コンテンツのエクスポート、別のファイルからのメッセージ コンテンツのインポート、またはキューからのすべてのメッセージの排出が行えます。
Administration Console の [JMS Message Management] ページには、モニタしているキューで使用できるメッセージの概要が表示されます。ページ内でメッセージを探したり、指定したフィルタ条件を満たすメッセージのセットを検索したりできます。メッセージの表示をカスタマイズして、必要な情報のみを表示することもできます。このページでは、コンテンツを表示するメッセージの選択、新しいメッセージの作成、1 つまたは複数のメッセージの削除、メッセージの移動、メッセージのインポートとエクスポート、キュー全体の排出が行えます。Administration Console を使用したキュー上のメッセージの管理の詳細については、Administration Console のオンライン ヘルプの「キューのメッセージの管理」を参照してください。
WebLogic Java Management Extensions (JMX) を使用すると、JMS メッセージ キュー上のメッセージを管理するための JMSMessageManagementRuntimeMBean にアクセスできます。
デフォルト設定の [JMS Message Management] ページには、キュー上の各メッセージに関する情報が、以下のカラムで構成される表形式で表示されます。
表示するカラムの順序を変更したり、どのカラムを表示してどのカラムを非表示にするかを選択したりできます。ページに表示するメッセージの数を、デフォルトの 10 から 20 または 30 に増やすこともできます。
デフォルトでは、送り先に到着した順番でメッセージが表示されます。[ID] カラムのヘッダをクリックすると、メッセージ ID の昇順または降順でメッセージをソートできます。ただし、ソート順をいったん変更すると、当初のソート順に戻すことはできません。メッセージを到着順で表示するには、[JMS システム モジュール リソース] ページに戻ってキューを選択しなおします。
[JMS Message Management] ページの上部にある [メッセージ セレクタ] フィールドを使用すると、有効な JMS メッセージ ヘッダまたはプロパティ (JMSXDeliveryCount を除く) に基づいてキュー上のメッセージをフィルタ処理できます。メッセージ セレクタはブール式であり、SQL の select 文の where 句と似た構文を持つ文字列です。
salary > 64000 and dept in ('eng','qa')
(product like 'WebLogic%' or product like '%T3')
and version > 3.0
hireyear between 1990 and 1992
or fireyear is not null
fireyear - hireyear > 4
メッセージ セレクタ構文の詳細については、javax.jms.Message の Javadoc を参照してください。
以下の条件を満たせば、ソース送り先から対象送り先にメッセージを移動できます。
注意 : 消費の休止状態の詳細については、「消費の休止と消費の再開」を参照してください。
注意 : 生成の休止状態の詳細については、「生成の休止と生成の再開」を参照してください。
メッセージを移動しても、メッセージの識別子は変更されません。移動したメッセージがすでに対象送り先に存在する場合は、同じ識別子の重複メッセージが送り先に追加されます。の数を表示できます。
以下の条件を満たせば、特定のメッセージを削除したり、すべてのメッセージをキューから排出したりできます。
注意 : 消費の休止状態の詳細については、「消費の休止と消費の再開」を参照してください。
削除処理の間は、送り先がロックされます。削除処理中に障害が発生すると、選択したメッセージの一部しか削除されない可能性があります。
送り先に送信する新しいメッセージを作成できます。新しいメッセージを作成するには、以下の情報を指定します。
PERSISTENT または NON_PERSISTENT。 JMS メッセージ プロパティの詳細については、『WebLogic JMS プログラマーズ ガイド』の「Understanding WebLogic JMS」を参照してください。
XML フォーマットのメッセージをインポートすると、指定した送り先にメッセージが作成されるか、既存のメッセージが置換されます。インポートするメッセージの対象送り先として指定できるのは、キューまたはトピック恒久サブスクライバです。送り先は、生成の休止状態である必要があります。
注意 : 生成の休止状態の詳細については、「生成の休止と生成の再開」を参照してください。
インポートしたファイルによって置換されたメッセージが JMS トランザクションに関連付けられていた場合は、インポートしたメッセージも引き続きそのトランザクションに関連付けられます。
新しいメッセージを作成する場合や、インポートしたファイルによって既存のメッセージが置換される場合は、以下の規則が適用されます。
PERSISTENT に設定されており、対象送り先にストアが存在しない場合は、配信モードが NON-PERSISTENT に変更されます。注意 : JMS メッセージのインポートは、結果だけを見ると新しい JMS メッセージの作成やパブリッシュに似ていますが、ExpirationTime が定義されている (ゼロでない) メッセージのインポート時の動作が異なります。このようなメッセージは、JMS 送り先にインポートされた直後に期限切れになります。
メッセージをエクスポートすると、JMS メッセージが XML フォーマットまたはシリアライズされたフォーマットに変換されます。ソース送り先は、生成の休止状態である必要があります。
注意 : 生成の休止状態の詳細については、「生成の休止と生成の再開」を参照してください。
一時的な送り先を使用することで、サーバ定義の送り先のコンフィグレーションと作成に伴うシステム管理のオーバーヘッドを発生させずに、必要に応じてアプリケーションで送り先を作成できます。
警告 : 通常、JMS アプリケーションでは、JMSReplyTo ヘッダ フィールドを使用してリクエストに応答を返すことができます。しかし、JMSReplyTo フィールドの情報は使用可能な送り先オブジェクトではなく、エクスポートまたはインポートの後は有効ではありません。
グローバル トランザクションの一部として生成または消費されるメッセージは、基本的にトランザクションによってロックされ、トランザクション コーディネータが JMS ブランチをコミットまたは中止するまでロックされたままになります。障害が原因でコーディネータがトランザクションの結果を JMS サーバに通信できない場合、トランザクションに関連付けられたメッセージは長時間保留されたままになります。
Administration Console から利用できる JMS サーバのトランザクション管理機能を使用すると、以下が行えます。
特定の WebLogic Server インスタンスのすべての JMS 接続を表示して、接続を保持する各プロセスのアドレスとポートの情報を取得できます。接続を終了させることもできます。Administration Console を使用して JMS サーバのトランザクションを管理する方法については、Administration Console オンライン ヘルプの「JMS サーバ : モニタ : アクティブなトランザクション」を参照してください。
JMS トランザクションの詳細については、『WebLogic JMS プログラマーズ ガイド』の「WebLogic JMS によるトランザクションの使い方」を参照してください。
|
|
|