|
|
WebLogic 診断フレームワーク (WLDF) の診断イメージ キャプチャ コンポーネントを使用すると、キャプチャ時のサーバ内部の実行時状態について診断スナップショット (ダンプ) を作成できます。この情報は、サポート担当者がサーバの障害の原因を分析するのに役に立ちます。
以下の節では、診断イメージ キャプチャ コンポーネントについて説明します。
診断イメージ キャプチャは、以下のいずれかによって開始されます。
診断イメージ キャプチャは、主に障害発生後の解析ツールとして利用するものなので、どのような情報をキャプチャするかについては限られた権限しか与えられていません。診断イメージ キャプチャで指定可能なコンフィグレーション オプションは次のとおりです。
他の WLDF コンポーネントと同様に、診断イメージ キャプチャは、Administration Console (Administration Console オンライン ヘルプの「診断イメージのコンフィグレーションとキャプチャ」を参照) や WebLogic Scripting Tool (WLST) を使用して、またはプログラム的にコンフィグレーションできます。
コード リスト 4-1 では、イメージ キャプチャを生成するための WLST コマンドの例を示します。
url='t3://localhost:7001'
username='system'
password='gumby1234'
server='myserver'
timeout=120
connect(username, password, url)
serverRuntime()
cd('WLDFRuntime/WLDFRuntime/WLDFImageRuntime/Image')
argTypes = jarray.array(['java.lang.Integer'],java.lang.String)
argValues = jarray.array([timeout],java.lang.Object)
invoke('captureImage', argValues, argTypes)
| 注意 : | 多くの場合、サーバ障害の発生時に診断イメージ キャプチャを生成するのが有効です。そのためには、サーバの状態が FAILED に変更されたときに true に評価されるように監視ルールを設定し、監視にイメージ通知を関連付けます。 |
| 注意 : | 監視ルールは以下のとおりです。 |
| 注意 : | (${[weblogic.management.runtime.ServerRuntimeMBean]//State} = 'FAILED') |
| 注意 : | 詳細については、「ハーベスタ監視のコンフィグレーション」および「イメージ通知のコンフィグレーション」を参照してください。また、Administration Console オンライン ヘルプの「監視および通知のコンフィグレーション」も参照してください。 |
診断イメージ キャプチャのコンフィグレーションはドメインの config.xml ファイルで永続化されます (サーバの <server> 要素の <server-diagnostic-config> 要素内)。コード リスト 4-2 を参照してください。
<domain>
<!-- 他のドメインのコンフィグレーション要素 -->
<server>
<name>myserver</name>
<server-diagnostic-config>
<image-dir>logs\diagnostic_images</image-dir>
<image-timeout>2</image-timeout>
</server-diagnostic-config>
<!-- このサーバの他のコンフィグレーションの詳細 -->
</server>
<!-- このドメインの他のサーバ コンフィグレーション -->
</domain>
| 注意 : | config.xml ファイルは直接編集しないことをお勧めします。 |
診断イメージ キャプチャでは、以下のようなサーバの状態の最も一般的な情報がキャプチャされます。
診断イメージ キャプチャ コンポーネントは、さまざまなサーバ サブシステムによって生成されたイメージをキャプチャおよび結合して、単一の ZIP ファイルにします。サーバ状態の最も一般的な情報をキャプチャするだけでなく、このコンポーネントは、たとえば JMS、JDBC、EJB、および JNDI サブシステムによって生成されたイメージなど、すべてのサーバ サブシステムからイメージをキャプチャします。
| 注意 : | 診断イメージは、重大な障害を診断するためにサーバ レベルの状態ダンプとして利用できる、サイズの大きなアーティファクトです。診断イメージは、構造化されたフォーマットで重要なデータを大量にキャプチャできるので、サポート部門のスタッフによる問題の分析に役立てることができます。 |
各イメージは、サーバ全体で 1 つのファイルとしてキャプチャされます。デフォルトの場所は SERVER\logs\diagnostic_images です。各イメージ インスタンスには、次のようにユニークな名前が付けられます。
diagnostic_image_DOMAIN_SERVER_YYYY_MM_DD_HH_MM_SS.zip
図 4-1 では、イメージ ファイルの内容を示します。この ZIP ファイル内のほとんどのファイルは、テキスト エディタで開いて内容を確認できます。
  
|
