| Oracle® Fusion Middleware Oracle Coherenceのマネージメント 12c (12.2.1) E69906-01 |
|
 前 |
 次 |
この章では、クラスタ・メンバーでJMX管理を構成する方法と、Java VisualVMやJConsoleなどのツールを使用してOracle Coherence MBeanにアクセスする方法について説明します。
この章には次の項が含まれます:
JMX管理は、tangosol-coherence-override.xmlファイルの<management-config要素内で、または起動時に管理用のシステム・プロパティを設定することで構成します。<management-config要素の詳細は、『Oracle Coherenceでのアプリケーションの開発』を参照してください。
この項の内容は次のとおりです。
Coherenceを構成して、動的管理モードで起動します。動的管理モードは、自動的に上位のクラスタ・メンバーをJMXクラスタ・メンバーとして選択します。JMXクラスタ・メンバーは、すべてのクラスタメンバーから管理情報を集計するMBeanサーバーをホストします。JMXクラスタ・メンバーが操作的ではない場合、次に最も上位のクラスタ・メンバーがJMXクラスタ・メンバーとして自動的に選択されます。
すべてのクラスタ・メンバーが、JMXクラスタ・メンバーとして選択される可能性があります。JMXメンバーとして選択される対象からクラスタ・メンバーを除外するには、<managed-nodes>要素をnoneに設定します。次に例を示します。
<?xml version='1.0'?>
<coherence xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://xmlns.oracle.com/coherence/coherence-operational-config"
xsi:schemaLocation="http://xmlns.oracle.com/coherence/
coherence-operational-config coherence-operational-config.xsd">
<management-config>
<managed-nodes system-property="coherence.management">none
</managed-nodes>
</management-config>
</coherence>
何も値が指定されない場合、デフォルト値はdynamicで、クラスタ・メンバーがJMXクラスタ・メンバーになることを示します。
coherence.managementシステム・プロパティも、クラスタ・メンバーをJMXクラスタ・メンバーの選択から除外します。次に例を示します。
-Dcoherence.management=none
1つ以上のクラスタ・メンバーを明示的に構成して、すべてのクラスタ・メンバーの管理対象オブジェクトを処理するMBeanサーバーをホストできます。これらのクラスタ・メンバーのMBeanサーバーにアクセスすることで、すべてのクラスタ・メンバーの管理情報が表示されます。専用のJMXクラスタ・メンバーを使用するのは一般的な方法です。なぜなら、それによりJMXソフトウェアを1つずつクラスタ・メンバーにロードする必要もなくなり、しかも1つのJMXメンバーに問題が発生してもフォルト・トレランスは維持されるためです。
小規模のクラスタでは、2つの既存クラスタ・メンバーに対して複数の専用のJMX JVMを用意するのがフォルト・トレランスを確保するための一般的な方法です。非常に大規模なクラスタでは、JMX専用の2台のコンピュータを用意するほうが現実的な場合が多いですが、必ずしもその必要はありません。
クラスタ・メンバーに対するリモートJMX管理を有効にするには、<managed-nodes>要素をallまたはremote-onlyに設定します。次に例を示します。
<?xml version='1.0'?>
<coherence xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://xmlns.oracle.com/coherence/coherence-operational-config"
xsi:schemaLocation="http://xmlns.oracle.com/coherence/
coherence-operational-config coherence-operational-config.xsd">
<management-config>
<managed-nodes system-property="coherence.management">all
</managed-nodes>
</management-config>
</coherence>
remote-only設定では、リモートMBeanのみを管理するMBeanサーバーが起動されます。all設定では、リモートMBeanおよびローカル(同一JVM上の)MBeanを管理するMBeanサーバーが起動されます。
coherence.managementシステム・プロパティによりリモートJMX管理を有効にすることもできます。次に例を示します。
-Dcoherence.management=all
|
注意: JMXクラスタ・メンバーとして構成されていないクラスタ・メンバーは、JMXクラスタ・メンバーとして動的に選択されることから明示的に無効化される必要があります。詳細は、「JMX管理の無効化」を参照してください。 |
ローカルJMX管理では、MBeanサーバーの管理対象がクラスタ・メンバーのローカル(同一JVM上の)MBeanに制約されます。クラスタ・メンバーのMBeanサーバーにアクセスしても、ローカル管理情報しか表示されません。しかし、そのクラスタ・メンバーのMBeanは、リモートJMX管理が有効化されたクラスタ・メンバーによって引き続き管理できます。ローカルJMX管理は一般的に、拡張クライアントまたは一時的なクラスタ・クライアントで使用されます。
クラスタ・メンバーでのローカルJMX管理を有効化するには、<managed-nodes>要素をlocal-onlyに設定します。次に例を示します。
<?xml version='1.0'?>
<coherence xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://xmlns.oracle.com/coherence/coherence-operational-config"
xsi:schemaLocation="http://xmlns.oracle.com/coherence/
coherence-operational-config coherence-operational-config.xsd">
<management-config>
<managed-nodes system-property="coherence.management">local-only
</managed-nodes>
</management-config>
</coherence>
coherence.managementシステム・プロパティによりローカルJMX管理を有効にすることもできます。次に例を示します。
-Dcoherence.management=local-only
便宜上の理由により、COHERENCE_HOME/bin/cache-serverおよびCOHERENCE_HOME/bin/coherenceの起動スクリプトには、クラスタ・メンバーでのJMX管理を有効にする-jmx引数が含まれます。次に例を示します。
cache-server -jmx
この引数は、スクリプト内で必要に応じて変更できる管理用のシステム・プロパティを自動的に設定します。デフォルトの設定は、次のようになります。
-Dcoherence.management=all -Dcoherence.management.remote=true
デフォルトでは、すべてのクラスタ・メンバーのMBeanで、リモートMBeanサーバーによる管理が許可されています。メンバーのMBeanのリモート管理を制限するには、<allow-remote-management>要素をfalseに設定します。次に例を示します。
<?xml version='1.0'?>
<coherence xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://xmlns.oracle.com/coherence/coherence-operational-config"
xsi:schemaLocation="http://xmlns.oracle.com/coherence/
coherence-operational-config coherence-operational-config.xsd">
<management-config>
<allow-remote-management
system-property="coherence.management.remote">false
</allow-remote-management>
</management-config>
</coherence>
coherence.management.remoteシステム・プロパティによりリモート管理を無効にすることもできます。次に例を示します。
-Dcoherence.management.remote=false
クラスタ・メンバーでのJMX管理を無効化するには、<managed-nodes>要素をnoneに設定します。次に例を示します。
<?xml version='1.0'?>
<coherence xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://xmlns.oracle.com/coherence/coherence-operational-config"
xsi:schemaLocation="http://xmlns.oracle.com/coherence/
coherence-operational-config coherence-operational-config.xsd">
<management-config>
<managed-nodes system-property="coherence.management">none
</managed-nodes>
</management-config>
</coherence>
メンバーのJMX管理を無効にしても、そのメンバーのリモート管理は停止されません。<allow-remote-management>もfalseに設定する必要があります。次の例では、JMX管理を無効化してメンバーのリモート管理を停止します。
<?xml version='1.0'?>
<coherence xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://xmlns.oracle.com/coherence/coherence-operational-config"
xsi:schemaLocation="http://xmlns.oracle.com/coherence/
coherence-operational-config coherence-operational-config.xsd">
<management-config>
<managed-nodes system-property="coherence.management">none
</managed-nodes>
<allow-remote-management
system-property="coherence.management.remote">false
</allow-remote-management>
</management-config>
</coherence>
Oracle Coherence管理フレームワークでは、MBeanをMBeanサーバーに登録する前にそれらのMBeanをフィルタできます。即時利用可能なMBeanフィルタが提供されており、カスタムのフィルタを必要に応じて作成することもできます。付属のMBeanフィルタ(com.tagosol.net.management.ObjectNameExcludeFilter)は、標準的な正規表現パターンを使用するJMXオブジェクト名に基づいて、MBeanを登録から除外します。たとえば、パターン.*type=Service,name=Management,.*によって、type=Serviceおよびname=ManagementのMBeanが除外されます。初期状態の構成では、このフィルタによっていくつかのプラットフォームMBeanが管理フレームワークに登録されないように除外されます。MBeanフィルタは、<mbean-filter>要素を使用して定義します。
次の例は、初期状態の構成を示しています。
...
<mbean-filter>
<class-name>com.tangosol.net.management.ObjectNameExcludeFilter</class-name>
<init-params>
<init-param>
<param-type>string</param-type>
<param-value system-property="coherence.management.exclude">
.*type=Service,name=Management,.*
.*type=Platform,Domain=java.lang,subType=ClassLoading,.*
.*type=Platform,Domain=java.lang,subType=Compilation,.*
.*type=Platform,Domain=java.lang,subType=MemoryManager,.*
.*type=Platform,Domain=java.lang,subType=Threading,.*
</param-value>
</init-param>
</init-params>
</mbean-filter>
...
管理サービスまたはプラットフォームMBeanを有効化するには、<param-value>要素の名前のリストから対応するオブジェクト名を削除します。特定のMBeanを登録されないように除外するには、そのMBeanオブジェクト名をリストに追加します。
coherence.management.excludeシステム・プロパティによりMBeanをフィルタリングすることもできます。次に例を示します。
-Dcoherence.management.exclude=.*type=Service,name=Management,.*
<refresh-expiry>、<refresh-policy>および<refresh-timeout>の各要素は、管理情報の待機時間を制御します。次の例では、これらの各設定を構成しています。詳細は、例の後に説明します。
<?xml version='1.0'?>
<coherence xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://xmlns.oracle.com/coherence/coherence-operational-config"
xsi:schemaLocation="http://xmlns.oracle.com/coherence/
coherence-operational-config coherence-operational-config.xsd">
<management-config>
<refresh-policy
system-property="coherence.management.refresh.policy">
refresh-ahead</refresh-policy>
<refresh-expiry
system-property="coherence.management.refresh.expiry">1s
</refresh-expiry>
<refresh-timeout
system-property="coherence.management.refresh.timeout">300ms
</refresh-timeout>
</management-config>
</coherence>
<refresh-expiry>要素は、リモート・メンバーの管理情報をリモートで取得する最小間隔を指定します。この要素の値は、次の形式で指定する必要があります。
(\d)+((.)(\d)+)?[MS|ms|S|s|M|m|H|h|D|d]?
前述の文字は(左から右へ)それぞれ、次の時間間隔の単位を示しています。
MSまたはms(ミリ秒)
Sまたはs(秒)
Mまたはm(分)
Hまたはh(時)
Dまたはd(日数)
値に単位が含まれていない場合は、ミリ秒が単位として適用されます。デフォルト値は1sです。
coherence.management.refresh.expiryシステム・プロパティにより失効を設定することもできます。次に例を示します。
-Dcoherence.management.refresh.expiry=2s
<refresh-policy>要素は、リモート管理情報のリフレッシュ方法を指定します。それぞれのポリシーでは、指定したMBeanの使用パターンの待機時間を短縮する様々なリフレッシュ・アルゴリズムが使用されます。表2-1は、各ポリシーを説明しています。
表2-1 リフレッシュ・ポリシー
| 設定 | 説明 |
|---|---|
|
|
失効遅延が経過した後、リクエストされる前に、MBeanを前の使用パターンに基づいてリフレッシュします。この設定は、ネットワーク消費量を多少増加させることで管理情報の待機時間を低減します。この設定は、MBeanが反復的(またはプログラム的)なパターンでアクセスされる場合に最良です。 |
|
|
データにアクセスした後、それぞれのMBeanをリフレッシュします。この方法では最適なレスポンス・タイムが確保されます。ただし返される情報は、最後のリフレッシュ時刻からのオフセットになります。 |
|
|
MBeanがアクセスされ、最後のリフレッシュから失効遅延が経過すると、それぞれのMBeanをリモート・メンバーからリフレッシュします。この設定は、MBeanがランダムなパターンでアクセスされる場合に最適です。 |
coherence.management.refresh.policyシステム・プロパティによりポリシーを設定することもできます。次に例を示します。
-Dcoherence.management.refresh.policy=refresh-expired
<refresh-timeout>要素は、MBean情報のリフレッシュ時に管理メンバーがリモート・メンバーからのレスポンスを待つ期間を指定します。この値は<refresh-expiry>値より小さくする必要があります。この要素の値は、次の形式で指定する必要があります。
(\d)+((.)(\d)+)?[MS|ms|S|s|M|m|H|h|D|d]?
前述の文字は(左から右へ)それぞれ、次の時間間隔の単位を示しています。
MSまたはms(ミリ秒)
Sまたはs(秒)
Mまたはm(分)
Hまたはh(時)
Dまたはd(日数)
値に単位が含まれていない場合は、ミリ秒が単位として適用されます。デフォルト値は250msです。
coherence.management.refresh.timeoutシステム・プロパティによりタイムアウトを設定することもできます。次に例を示します。
-Dcoherence.management.refresh.timeout=300ms
Oracle Coherence管理フレームワークでは、既存のMBeanサーバーを使用してOracle Coherence MBeanを公開できます。MBeanサーバーは、クラスタ・メンバーと同一のJVMプロセス内にある必要があります。また、そのクラスタ・メンバーでは、JMX管理が有効化されている必要があります。
既存のMBeanサーバーを使用するには、<default-domain-name>要素を使用してMBeanサーバーのドメイン名を入力します。入力したドメイン名のMBeanサーバーが見つからないと、MBean登録に失敗します。次の例では、MyDomainNameドメイン名の既存のMBeanサーバーを指定します。
<?xml version='1.0'?>
<coherence xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://xmlns.oracle.com/coherence/coherence-operational-config"
xsi:schemaLocation="http://xmlns.oracle.com/coherence/
coherence-operational-config coherence-operational-config.xsd">
<management-config>
<managed-nodes system-property="coherence.management">all
</managed-nodes>
<default-domain-name>MyDomainName</default-domain-name>
</management-config>
</coherence>
com.tangosol.net.management.MBeanServerFinderインタフェースを実装して、Oracle Coherence管理フレームワークによるMBeanサーバーの検出方法をカスタマイズします。<server-factory>要素内の<class-name>要素を使用して、実装クラスの完全修飾された名前を追加します。また、<init-params>要素を使用して、初期化パラメータを含めます。<default-domain-name>要素を使用して、クラスをインスタンス化する際に使用する既存のMBeanサーバー・ドメイン名を指定します。
次の例では、MyMBeanServerFinder実装クラスを指定して、その実装クラスにMyDomainNameドメイン名を渡します。
<?xml version='1.0'?>
<coherence xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://xmlns.oracle.com/coherence/coherence-operational-config"
xsi:schemaLocation="http://xmlns.oracle.com/coherence/
coherence-operational-config coherence-operational-config.xsd">
<management-config>
<managed-nodes system-property="coherence.management">all
</managed-nodes>
<default-domain-name>MyDomainName</default-domain-name>
<server-factory>
<class-name
system-property="coherence.management.serverfactory">
package.MyMBeanServerFinder</class-name>
<init-params>
<init-param>
<param-type>int</param-type>
<param-value>0</param-value>
</init-param>
</init-params>
</server-factory>
</management-config>
</coherence>
coherence.management.serverfactoryシステム・プロパティにより実装クラスを指定することもできます。次に例を示します。
-Dcoherence.management.serverfactory=package.MyMBeanServerFinder
Oracle Coherence MBeanにアクセスする前に、JMX管理をクラスタ・メンバーで有効にする必要があります。「JMX管理の構成」を参照してください。この項の例では、Oracle Coherence起動スクリプトの-jmx引数を使用してJMX管理を有効化します。
この項の内容は次のとおりです。
Java VisualVMは、JDK (JDK_HOME\bin\jvisualvm)に含まれる管理ユーティリティで、MBeanの表示およびMBeanとのやり取りの機能が提供されます。MBean機能がJava VisualVMに対するプラグインとして提供されています。このプラグインをJava VisualVM Plugins Centerからインストールする必要があります。ツールから、「ツール」 -> 「プラグイン」オプションを使用してVisualVM-MBeansプラグインをインストールします。
Java VisualVMユーティリティを使用してCoherence MBeanにローカルでアクセスする手順は次のとおりです。
COHERENCE_HOME\bin\cache-serverスクリプトを使用してキャッシュ・サーバーを起動し、-jmx引数を指定してそのメンバーに対する管理を有効化します。次に例を示します。
COHERENCE_HOME\bin\cache-server -jmx
JDK_HOME\bin\jvisualvmを起動します。Java VisualVMウィンドウが表示されます。
「Applications」ツリーで、「Local」をクリックして展開し、クラスタ・メンバーのプロセスをダブルクリックします。プロセス情報は、このウィンドウの右側にあるプロセス・タブに表示されます。
選択したプロセス・タブで「MBeans」タブをクリックし、Coherenceノードを展開してMBeanにアクセスします。
JConsoleは、JDK (JDK_HOME\bin\jconsole)に含まれる管理ユーティリティで、MBeanの表示およびMBeanとのやり取りの機能が提供されます。
JConsoleユーティリティを使用してMBeanにローカルでアクセスする手順は次のとおりです。
COHERENCE_HOME\bin\cache-serverスクリプトを使用してキャッシュ・サーバーを起動し、-jmx引数を指定してそのメンバーに対する管理を有効化します。次に例を示します。
COHERENCE_HOME\bin\cache-server -jmx
JDK_HOME\bin\jconsoleを起動します。Java Monitoring & Management Consoleウィンドウが表示され、「JConsole: 新規接続」ダイアログ・ボックスが表示されます。
「JConsole: 新規接続」ダイアログ・ボックスで「ローカル・プロセス:」オプションを選択し、クラスタ・メンバーのプロセスを選択します。次に例を示します。
「接続」をクリックします。
Java Monitoring & Management Consoleウィンドウで「MBeans」タブを選択し、Coherenceノードを展開してMBeanにアクセスします。
リモートJMX管理では、リモート・コンピュータ上のJMXクライアントでOracle Coherence MBeanにアクセスすることが可能です。システム・プロパティはリモート・アクセスを構成するためのもので、多くの場合、MBeanサーバーをホスティングするJVMを起動する際に設定されます。つまり、そのクラスタのMBeanサーバーをホスティングするクラスタ・メンバーを起動する際にシステム・プロパティは設定されます。次の記述では、最低限の構成要件のみが説明されています。JMX管理の構成方法の詳細は、JMXドキュメントを参照してください。
http://download.oracle.com/javase/7/docs/technotes/guides/management/agent.html
セキュリティを有効化せずにOracle Coherence MBeanへのリモート・アクセスを許可するには、次のシステム・プロパティをクラスタ・メンバーの起動時に設定します。システム・プロパティを簡単に使用できるように、Oracle Coherence起動スクリプトのシステム・プロパティが-jmx引数の使用時に自動的に設定されるようにしておきます。
-Dcom.sun.management.jmxremote.port=port
-Dcom.sun.management.jmxremote.authenticate=false
-Dcom.sun.management.jmxremote.ssl=false
com.sun.management.jmxremote.port値を、クラスタ・メンバーの使用可能なポートのいずれかに設定します。JMXクライアント(例: JConsole)のホストとポートを、リモートMBeanサーバーへ接続するときに指定します。
場合によっては(仮想環境またはネットワーク・アドレス変換を使用する場合)、コンピュータのホスト名が誤って識別されたり、JMXクライアントに送信するRMIスタブでデフォルト値(127.0.0.1)が返されたりすることがあります。その結果、JMXクライアントによるMBeanサーバーへの接続が失敗します。RMIスタブに正しいIPアドレスを含めるには、java.rmi.server.hostnameシステム・プロパティを使用してホストのIPアドレスを明示的に設定します。次に例を示します。
-Djava.rmi.server.hostname=IP_Address
RMIプロパティの詳細は、次のRMIドキュメントを参照してください。
http://download.oracle.com/javase/7/docs/technotes/guides/rmi/javarmiproperties.html
HTMLアダプタWebアプリケーションでは、キャッシュ・クライアントのOracle Coherence MBeanへのリモート・アクセスが可能で、JMXリファレンス実装の一部として同梱されているHTMLアダプタ(HtmlAdaptorServer)を使用します。このアダプタでは、jmxri.jarとjmxtools.jarライブラリを両方ともクラスパスに含める必要があります。JMXリファレンス実装は、次のサイトから入手できます。
http://www.oracle.com/technetwork/java/javase/tech/download-jsp-141676.html
HTMLアダプタを使用してMBeanにアクセスする手順は次のとおりです。
COHERENCE_HOME\bin\coherenceスクリプトを編集して、クラスパスにjmxri.jarとjmxtools.jarを含めます。たとえば、Windowsの場合は次のようにします。
-cp "jmxri-1.2.1.jar;jmxtools-1.2.1.jar;%coherence_home%\lib\coherence.jar"
スクリプトを使用してキャッシュ・ファクトリ・インスタンスを起動し、-jmx引数を指定してメンバー管理を有効化します。次に例を示します。
COHERENCE_HOME\bin\coherence -jmx
キャッシュ・ファクトリ・インスタンスが起動したら、コマンド・プロンプトでjmx 8082と入力します。これにより、クラスタ・メンバーのポート8082でHTTPアダプタが起動します。
Webブラウザで、アダプタにアクセスします。次の画面で示すように、ホスト名とポート8082からなるアドレスを使用します。
Oracle Coherenceには、クラスタ・メンバーを専用のMBeanサーバー・ホストとして起動するためのプログラムが用意されています。このプログラムでは、Oracle Coherence MBeanへのリモート・アクセスがJMXリモートAPIのRMI、またはJMXリファレンス実装で提供されるHTTPサーバーを使用して実現されます。必要に応じてRMIとHTTPのポート設定を構成して、ファイアウォールを介したアクセスを許可します。次のコマンドを使用して、サーバーを起動します。
java -Dcoherence.management=all
-Dcom.sun.management.jmxremote.ssl=false
-Dcom.sun.management.jmxremote.authenticate=false
-cp coherence.jar;jmxri.jar;jmxtools.jar
com.tangosol.net.management.MBeanConnector [-http -rmi]
JMX RMIを使用したアクセスを許可するには、-rmi引数を含めます。HTTPおよびWebブラウザを使用したアクセスを許可するには、-http引数を含めます。これらの引数を両方とも含めることはできますが、メンバーを起動するには少なくと1つの引数を指定する必要があります。
表2-2は、JMX RMI構成のオプションのプロパティについて説明しています。
表2-2 JMX RMIの構成に使用できるオプションのプロパティ
| プロパティ | 説明 |
|---|---|
|
|
JMXサーバーがバインドされているホスト。デフォルト値は |
|
|
JMX RMIのレジストリに使用するポート。デフォルト値は |
|
|
JMX RMI接続に使用するポート。デフォルト値は |
表2-3は、HTTPの構成に使用できるオプションのプロパティについて説明しています。
表2-3 HTTPの構成に使用できるオプションのプロパティ
| プロパティ | 説明 |
|---|---|
|
|
HTTPの接続に使用するポート。デフォルト値は |
JConsoleを使用してデフォルト設定でMBeanサーバーに接続するには、次のコマンドを使用します。
jconsole service:jmx:rmi://localhost:3000/jndi/rmi://localhost:9000/server
HTTPを使用してデフォルト設定でMBeanサーバーに接続するには、次のURLにアクセスします。
http://localhost:8888
|
注意: 認証およびSecure Socket Layer (SSL)を使用したセキュアなアクセスを設定するには、次のJMXエージェントのドキュメントを参照してください。
|
Coherence-JVisualVMプラグインによって、JDK (JDK_HOME\bin\jvisualvm)に含まれるJava VisualVM管理ユーティリティを使用したCoherenceクラスタのモニターが可能になります。プラグインは、Coherence MBeanデータを集約し、単一のCoherenceクラスタの簡潔な運用ビューを表示します。一定期間の管理情報が表示されるため、リアルタイム分析およびトラブルシューティングが可能になります。
|
注意: Coherence-JVisualVMプラグインは、開発およびテスト時に単一のCoherenceクラスタをモニターすることを目的とした設計時ツールです。本番環境でのモニタリング、管理およびアラート生成には、エンタープライズ・レベルの管理製品(Oracle Enterprise Managerなど)を使用する必要があります。 |
この項の内容は次のとおりです。
Coherence-JVisualVMプラグイン・ファイル(coherence-jvisualvm.nbm)は、COHERENCE_HOME\plugins\jvisualvmディレクトリにあります。Java VisualVMプラグイン・ツールを使用してプラグインをインストールします。Coherence-JVisualVMプラグインは、JDK 1.7 update 40以上でサポートされています。
Coherence-JVisualVMプラグインをインストールするには、次の手順を実行します。
JDK_HOME\bin\jvisualvmファイルを実行します。「Java VisualVM」ウィンドウが表示されます。
「ツール」メニューから、「プラグイン」を選択します。「プラグイン」画面が表示されます。
「ダウンロード済」タブを選択し、「プラグインの追加...」をクリックします。「プラグインの追加」」ダイアログ・ボックスを使用して、COHERENCE_HOME\plugins\jvisualvm\coherence-jvisualvm.nbmファイルを検索します。
「開く」をクリックします。Coherence-JVisualVMプラグインはツールにインポートされ、ダウンロードされたプラグインのリストに表示されます。
プラグインのリストから、Coherence-JVisualVMを選択し、「インストール」をクリックします。プラグイン・インストーラが表示されます。オンラインの指示に従ってプラグインをインストールします。
「インストール済」タブを選択し、プラグインがインストールされアクティブ化されていることを確認します。
「閉じる」をクリックし、「プラグイン」画面を終了します。
Coherenceクラスタは、Coherenceクラスタ・メンバーであるJVMプロセスに接続し、「Oracle Coherence」タブを使用することによって、Java VisualVMツールでモニターされます。管理データにアクセスする前に、Coherence JMX管理をクラスタ・メンバーで有効にする必要があります(「JMX管理の構成」を参照してください)。
Coherence-JVisualVMプラグインを使用してCoherenceクラスタをモニターするには、次の手順を実行します。
Coherenceクラスタを起動します。
「Java VisualVMアプリケーション」ツリーから、「ローカル」をクリックして展開し、MBeanサーバー(JMX管理対応メンバー)をホストするCoherenceクラスタ・メンバー・プロセスをダブルクリックします。プロセス情報は、「Java VisualVM」ウィンドウの右側にあるプロセス・タブに表示されます。
選択したプロセス・タブから、Oracle Coherenceをクリックし、次に示すCoherence-JVisualVMプラグインを使用してCoherenceクラスタをモニターします。
|
注意: すべてのデータを表示するために、「Java VisualVM」ウィンドウを1280x800以上に拡大します。 |
表2-4に、使用可能なタブの概要を示します。
表2-4 Coherence-JVisualVMプラグインのタブの説明
| タブ | 説明 |
|---|---|
|
クラスタの概要 |
クラスタ名、バージョン、メンバー数および高可用性ステータスを含むクラスタの概要情報が表示されます。他のタブからサマリー・グラフが集計され、使用可能および使用済の合計クラスタ・メモリー、クラスタ・マシンの平均負荷、パケット・パブリッシャおよびパケット・レシーバの成功率が表示されます。 「クラスタの概要」タブを使用して、クラスタの動作を示す簡単なスナップショットを採取し、発生する可能性のあるパフォーマンスの問題および高可用性の問題を識別します。 |
|
マシン |
クラスタ内の物理サーバーのリストが表示され、このリストには各サーバーのメモリー・プロファイルが含まれます。サマリー・グラフには、これらのサーバーの平均負荷が表示されます。 「マシン」タブを使用して、各サーバーの負荷をモニターし、使用可能なメモリーをすべて使用する危険のあるサーバーを識別します。 |
|
Members |
すべてのクラスタ・メンバー、そのアドレスおよびクラスタでのロールのリストが表示され、そのリストにはパブリッシャとレシーバの両方の成功率、ヒープ・メモリー使用量および送信キュー・サイズが含まれます。サマリー・グラフには、使用可能および使用済の合計クラスタ・メモリーが表示されます。メンバー行を右クリックして、「詳細の表示」を選択して統計の完全なリストを表示する、または「ノードの状態をレポート」を選択してノードのスレッドのフル・ダンプを取得します。 「メンバー」タブを使用して、クラスタのメンバーシップをモニターし、メンバーおよびクラスタ全体の両方で発生する可能性のあるメモリーの問題を識別および診断します。 |
|
サービス |
サービス・パーティション数およびstatusHA値を含むクラスタ・サービスの情報が表示されます。サービスを選択し、サービスの各ノードの詳細なスレッド情報と、次のデータをリフレッシュした後でその情報のグラフを確認します。サービスを右クリックして、サービス・パーティション統計を表示します。 サービス・スレッドのパフォーマンスを示すRAWデータは、グラフに左端に表示されます。ノード行を右クリックして、「詳細の表示」を選択し、統計の完全なリストを表示します。 「サービス」タブを使用して、クラスタ内のサービスをモニターし、サービス・スレッドで発生する可能性のあるパフォーマンスの問題を識別します。 |
|
キャッシュ |
サイズおよびメモリー使用量を含むクラスタ・キャッシュの情報が表示されます。メモリー使用量について正しい情報を表示するには、バイナリ単位換算カリキュレータを使用するようにキャッシュのバッキング・マップ・スキームを構成する必要があります。これは、単位換算カリキュレータが定義されていない場合のデフォルトの単位換算カリキュレータです。キャッシュを選択し、次のデータ・リフレッシュの詳細情報を確認します。ニア・キャッシュが選択されている場合、フロント・キャッシュで追加の統計が使用可能です。ノード行を右クリックして、「詳細の表示」を選択し、キャッシュ・サイズとアクセス統計、またはキャッシュ・ストレージ統計のいずれか(どのタブがアクティブであるかによります)の完全なリストを表示します。 「キャッシュ」タブを使用して、キャッシュ統計の詳細ビューを取得し、キャッシュ問合せで発生する可能性のあるパフォーマンスの問題を識別します。 |
|
フェデレーション |
フェデレーテッド・サービスの現在の参加者クラスタのコンテキスト内でのフェデレーテッド・サービスの情報を表示します。現在の参加者クラスタが接続されている各参加者クラスタのリストが表示されます。クラスタ参加者を選択して、現在のクラスタ参加者のメンバーに関連するパフォーマンス統計を表示します。現在の参加者を構成してデータを送信、受信または送受信するかに応じて、送信および受信統計の両方が提供されます。特定のクラスタ・メンバーを選択して、帯域幅使用量およびレプリケーション統計を表示します。 「フェデレーション」タブを使用して、フェデレーテッド参加者を監視し、フェデレーテッド参加者間で発生する可能性のあるパフォーマンスの問題を特定します。 「フェデレーション」タブは、フェデレーション操作をサポートしています。クラスタ参加者を右クリックして、選択可能な操作のリストを表示します。 |
|
永続性 |
使用可能および使用中のストレージ、永続性操作で提供される待機時間およびキャッシュ・スナップショットの数を含むキャッシュ永続性に関する情報を表示します。パフォーマンス統計は、アクティブな永続性モードにのみ適用されます。 「永続性」タブを使用して、アクティブな永続性の詳細な表示を取得し、発生する可能性のあるパフォーマンスおよび領域の消費に関する問題を特定します。 「永続性」タブは、永続性操作の実行をサポートしています。サービスを右クリックして、選択可能な操作のリストを表示します。 |
|
エラスティック・データ |
RAMおよびフラッシュのジャーナルのメモリー使用量の情報が表示されます。それぞれの進行状況バーを選択して、RAMおよびフラッシュのジャーナルの詳細を表示します。ジャーナル統計には、フェデレーテッドキャッシュ機能に必要なエラスティック・データの内部使用量が含まれます。 「エラスティック・データ」タブを使用して、エラスティック・データのメモリー使用量を監視し、いつメモリーが使い果たされる可能性があるか特定します。 |
|
プロキシ・サーバー |
各プロキシ・サーバーをまたぐ接続数および送受信された合計メッセージを含む、クラスタ内のプロキシ・サーバーの情報が表示されます。サマリー・グラフには、プロキシ・サーバー接続の合計数が表示されます。 「プロキシ・サーバー」タブを使用して、プロキシに接続しているCoherence*Extendクライアントをモニターし、プロキシで発生する可能性のあるパフォーマンスの問題を識別します。 注意: このタブは、クラスタでプロキシ・サーバーが構成されている場合のみ使用可能です。また、他のCoherence JVMプロセスの後プロキシ・サーバーが起動した場合は、Coherence JVMプロセスに再接続する必要がある可能性があります。 |
|
Coherence*Web |
デプロイされているアプリケーションの数、格納されるHTTPセッションの数、セッション・リープに関するその他の情報を含む、クラスタ内のHTTPセッション・ストレージに関する情報が表示されます。 「Coherence*Web」タブを使用して、HTTPセッション・ストレージをモニターし、セッション・ストレージで発生する可能性のあるパフォーマンスの問題を識別します。 注意: このタブは、HTTPセッション・ストレージでCoherenceクラスタが使用されている場合のみ使用可能です。 |
|
JCache |
JCacheキャッシュの構成情報およびパフォーマンス統計情報を表示します。 JCacheタブを使用して、構成およびパフォーマンスの問題をトラブルシューティングします。 注意: このタブはCoherenceクラスタがJCacheキャッシュの格納に使用されている場合にのみ使用できます。 |
Coherence-JVisualVMプラグインを使用して、WebLogic Serverドメインで管理されるCoherenceクラスタをモニターできます。1つの管理対象Coherenceサーバーを管理プロキシとして構成する必要があり、すべての管理対象Coherenceサーバーを再起動する必要があります。WebLogic Serverドメインの実行時MBeanサーバーは、JMX情報を管理プロキシから収集します。管理プロキシの構成の詳細は、『Oracle WebLogic Serverクラスタの管理』を参照してください。
|
注意: WebLogic Serverマルチテナント・ドメインに接続している場合、Coherence-JVisualVMプラグインはWebLogicドメイン管理者として接続された場合にのみ表示されます。マルチテナント・ドメインには、パーティション管理者として接続できません。WebLogic Serverドメイン管理の場合、すべてのドメイン・パーティションにアクセスできます。サービス、キャッシュおよび永続性操作を実行する際は、正しいパーティションを選択するようにしてください。 |
Java VisualVMを使用してドメインの実行時MBeanサーバーに接続するには、次の手順を実行します。
wlserver\server\bin\setWLSEnvスクリプトを実行して、WebLogic Server環境のソースを指定します。
Java VisualVMを起動し、クラスパスに次のWebLogic Serverライブラリを含めます。また、次のオプションを含め、MBeanチェックが無効であることを確認します。
jvisualvm --cp WLS_HOME\server\lib\wljmxclient.jar; WLS_HOME\server\lib\weblogic.jar -J-Djmx.remote.protocol.provider.pkgs= weblogic.management.remote -J-Dcom.oracle.coherence.jvisualvm.disable.mbean.check=true
「Java VisualVMアプリケーション」ツリーから、「ローカル」を右クリックし、「JMX接続の追加」を選択します。「JMX接続の追加」ダイアログ・ボックスが表示されます。
次の接続URLを入力し、hostnameおよびportをWebLogic Serverのホスト名およびポートに置き換えます。
service:jmx:iiop://hostname:port/jndi/weblogic.management.mbeanservers. domainruntime
「セキュリティ資格証明を使用」をクリックし、WebLogic Serverのユーザー名およびパスワードを入力します。
「OK」をクリックします。
新規接続をダブルクリックします。
選択したプロセス・タブから、「Oracle Coherence」をクリックし、Coherenceクラスタをモニターします。
Coherence-JVisualVMプラグインは、デフォルトの30秒ごとにCoherence MBeanサーバーのデータをリフレッシュするように設定されています。ほとんどのタブ(「サービス」タブ、「キャッシュ」タブ、「フェデレーション」タブなど)の詳細セクション上のデータは、別のタブが選択されると瞬時に削除され、次のリフレッシュ・サイクル時にリフレッシュされます。
リフレッシュ設定を変更するには、Java VisualVMを起動するときに次のシステム・プロパティを使用します。
jvisualvm -J-Dcom.oracle.coherence.jvisualvm.refreshtime=10
管理データをリフレッシュするとパフォーマンスに影響が出る場合(特に、大規模クラスタの場合)、プラグインのリフレッシュ間隔はデフォルトのままにし、デフォルトのCoherence管理リフレッシュ有効期限を1秒から高い値に変更することを検討してください。値は、オペレーション・オーバーライド・ファイルまたはシステム・プロパティを使用して指定できます。リフレッシュ有効期限の変更の詳細は、「管理リフレッシュの構成」を参照してください。
