Oracle® Fusion Middleware Oracle WebLogic Server 診断フレームワークのコンフィグレーションと使い方 11g リリース 1 (10.3.1) B55523-01 |
|
![]() 戻る |
![]() 次へ |
WebLogic 診断フレームワーク (WLDF) のアーカイブ コンポーネントは、サーバ インスタンスおよびそのサーバ インスタンスで実行されているアプリケーションから WLDF によって収集されたすべてのデータ イベント、ログ レコード、およびメトリックをキャプチャし、永続化します。オンライン モードで (つまり実行中のサーバで) アーカイブされた診断データにアクセスできます。また、オフライン モードでも、WebLogic Scripting Tool (WLST) を使用して、アーカイブされたデータにアクセスすることが可能です。
以下の節で説明するように、ファイル ストアまたは Java Database Connectivity (JDBC) データ ソースに診断データをアーカイブするように WLDF をコンフィグレーションできます。
また、次の節で説明するように、古いデータをアーカイブから削除する時期や条件を指定することもできます。
診断アーカイブをサーバごとにコンフィグレーションします。コンフィグレーションはドメインの config.xml ファイルで永続化されます (サーバの <server-diagnostic-config> 要素内)。ファイルベースのストアのコンフィグレーションの例をコード リスト 5-1、JDBC ベースのストアの例をコード リスト 5-3 に示します。
注意 : 診断データがアーカイブに書き込まれている際にシステム クロックをリセットすると、予期しない結果が生じることがあります。詳細については、「システム クロックをリセットすることによるデータのアーカイブおよび取得に対する影響」を参照してください。 |
ファイルベースのストアの場合、WLDF ではアーカイブされた情報を格納するためのファイルが作成されます。WLDF のファイルベースのアーカイブで指定可能なコンフィグレーション オプションは、このテキスト ファイルを作成および保持するディレクトリのみです。デフォルトのディレクトリは DOMAIN_NAME/servers/SERVER_NAME/data/store/diagnostics です。DOMAIN_NAME はドメインのホーム ディレクトリ、SERVER_NAME はサーバ インスタンスのホーム ディレクトリです。
ファイルベースのストアに保存する場合、WLDF は WebLogic Server 永続ストアを使用します。詳細については、『Oracle Fusion Middleware Oracle WebLogic Server 環境のコンフィグレーション』の「WebLogic 永続ストアの使い方」を参照してください。
コード リスト 5-1 に、ファイルベースのストアのコンフィグレーションの例を示します。
コード リスト 5-1 ファイルベースの診断アーカイブのコンフィグレーションのサンプル (config.xml 内)
<domain> <!-- 他のドメインのコンフィグレーション要素 --> <server> <name>myserver</name> <server-diagnostic-config> <diagnostic-store-dir>data/store/diagnostics</diagnostic-store-dir> <diagnostic-data-archive-type>FileStoreArchive </diagnostic-data-archive-type> </server-diagnostic-config> </server> <!-- このドメインの他のサーバ コンフィグレーション --> </domain>
JDBC ストアを使用するには、データベースに適切なテーブルがあり、そのデータベースに接続するように JDBC がコンフィグレーションされている必要があります。Administration Console を使用することでどう JDBC をコンフィグレーションするかについては、『Oracle Fusion Middleware Oracle WebLogic Server Administration Console ヘルプ』の「データベース接続のコンフィグレーション」を参照してください。JDBC コンフィグレーションの詳細については、『Oracle Fusion Middleware Oracle WebLogic Server JDBC のコンフィグレーションと管理』を参照してください。
WLDF で使用するデータベース テーブルがない場合は、JDBC ベースのストアにデータを保存するテーブルを作成する必要があります。2 つのテーブルが必要です。
wls_events テーブルには、WLDF インスツルメンテーション イベントから生成されるデータが格納されます。
wls_hvst テーブルには、WLDF ハーベスタ コンポーネントから生成されるデータが格納されます。
テーブルの作成に使用する SQL のデータ定義言語 (Data Definition Language: DDL) は、データベースでサポートされている SQL の種類によって、データベースごとに異なる可能性があります。以下のコード リストでは、PointBase データベースに WLDF テーブルを作成する場合に使用可能な DDL を示します。
コード リスト 5-2 PointBase データベース用 WLDF テーブルの DDL の定義
-- インスツルメンテーション イベント用に wls_events テーブルを作成するための DDL DROP TABLE wls_events; CREATE TABLE wls_events ( RECORDID INTEGER IDENTITY, TIMESTAMP NUMERIC default NULL, CONTEXTID varchar(128) default NULL, TXID varchar(32) default NULL, USERID varchar(32) default NULL, TYPE varchar(64) default NULL, DOMAIN varchar(64) default NULL, SERVER varchar(64) default NULL, SCOPE varchar(64) default NULL, MODULE varchar(64) default NULL, MONITOR varchar(64) default NULL, FILENAME varchar(64) default NULL, LINENUM INTEGER default NULL, CLASSNAME varchar(250) default NULL, METHODNAME varchar(64) default NULL, METHODDSC varchar(4000) default NULL, ARGUMENTS clob(100000) default NULL, RETVAL varchar(4000) default NULL, PAYLOAD blob(100000), CTXPAYLOAD VARCHAR(4000), DYES NUMERIC default NULL, THREADNAME varchar(128) default NULL ); -- インスツルメンテーション イベント用に wls_events テーブルを作成するための DDL DROP TABLE wls_hvst; CREATE TABLE wls_hvst ( RECORDID INTEGER IDENTITY, TIMESTAMP NUMERIC default NULL, DOMAIN varchar(64) default NULL, SERVER varchar(64) default NULL, TYPE varchar(64) default NULL, NAME varchar(250) default NULL, ATTRNAME varchar(64) default NULL, ATTRTYPE INTEGER default NULL, ATTRVALUE VARCHAR(4000) ); COMMIT;
実際に使用しているデータベース用にこれらのテーブルを作成する具体的な手順については、データベースのマニュアルを参照するか、データベース管理者に問い合わせてください。
データベースにテーブルを作成したら、そのテーブルにアクセスするように JDBC をコンフィグレーションする必要があります(『Oracle Fusion Middleware Oracle WebLogic Server JDBC のコンフィグレーションと管理』を参照してください)。次に、サーバ コンフィグレーションの中で、サーバのアーカイブに使用するデータ ストアとしてその JDBC リソースを指定します。
コード リスト 5-3 に、JDBC ベースのストアのコンフィグレーションの例を示します。
コード リスト 5-3 JDBC ベースの診断アーカイブのコンフィグレーションのサンプル (config.xml 内)
<domain> <!-- 他のドメインのコンフィグレーション要素 --> <server> <name>myserver</name> <server-diagnostic-config> <diagnostic-data-archive-type>JDBCArchive </diagnostic-data-archive-type> <diagnostic-jdbc-resource>JDBCResource</diagnostic-jdbc-resource> <server-diagnostic-config> </server> <!-- このドメインの他のサーバ コンフィグレーション --> </domain>
JDBC リソースを指定していて、そのコンフィグレーションが正しくない場合、または、必要なテーブルがデータベースに存在しない場合、WLDF はデフォルトのファイルベースの永続ストアを使用します。
WLDF にはデータ廃棄機能があります。コンフィグレーションを行うことによって、アーカイブから古い診断データを定期的に削除できます。以下の節で説明するように、サーバ レベルではサイズに基づいたデータ廃棄を、個々のアーカイブ レベルでは期間に基づいたデータ廃棄をコンフィグレーションできます。
サーバ インスタンスに対して、以下のデータ廃棄オプションを設定できます。
サーバ インスタンスのデータ ストアの望ましい最大サイズ (<preferred-store-size-limit>) と、そのサイズを超過しているかどうかを正時にチェックする間隔 (<store-size-check-period>)。
ストア サイズが最大サイズを超過していることが検出されると、適切な数のレコードが古いものから削除され、指定されたしきい値を下回るようにサイズが縮小されます。これを「サイズに基づいたデータ廃棄」と呼びます。
注意 : サイズに基づいたデータ廃棄は、ファイルベースのストアに対してのみ使用できます。上記のオプションは、データベースベースのストアでは無視されます。 |
サーバ インスタンスでのデータ廃棄の有効化または無効化。
ファイルベースの診断ストアの場合は、この設定により、前述のサイズに基づいたデータ廃棄のオプションが有効化または無効化されます。ファイルベースのストアとデータベースベースのストアが混在している場合は、この設定により、ストア内の個々のアーカイブに対する期間に基づいたデータ廃棄ポリシーも有効化または無効化されます。「診断アーカイブに対する期間に基づいたデータ廃棄ポリシーのコンフィグレーション」を参照してください。
サーバ インスタンスのデータ ストアには、以下のタイプの診断データ アーカイブを格納できます (それらのアーカイブのレコードはデータ廃棄機能を使用して廃棄できます)。
収集された メトリック データ (論理名 : HarvestedDataArchive)
インスツルメンテーション イベント データ (論理名 : EventsDataArchive)
カスタム データ (ユーザ定義の名前)
注意 : WebLogic Server ログ ファイルは、サーバ レベルとドメイン レベルの両方で保持されます。データは、ログ ローテーション機能に基づく現在のログから廃棄されます。『Oracle Fusion Middleware Oracle WebLogic Server ログ ファイルのコンフィグレーションとログ メッセージのフィルタ処理』の「WebLogic ロギング サービスのコンフィグレーション」を参照してください。 |
期間に基づいたポリシーは、個々のアーカイブに適用されます。サーバ インスタンスのデータ ストアでは、期間に基づいたポリシーを、HarvestedDataArchive、EventsDataArchive、および各カスタム アーカイブに対して 1 つずつ指定できます。
指定された期間が経過すると、アーカイブのレコードは削除されます。
データ廃棄のコンフィグレーション設定は、サーバのドメインの config.xml コンフィグレーション ファイルに保持されます。コード リスト 5-4 を参照してください。
コード リスト 5-4 config.xml のデータ廃棄のコンフィグレーション設定
<domain> <!-- 他のドメインコンフィグレーション設定 --> <server> <name>MedRecServer</name> <!-- 他のサーバコンフィグレーション設定 --> <server-diagnostic-config> <diagnostic-store-dir>data/store/diagnostics</diagnostic-store-dir> <diagnostic-data-archive-type>FileStoreArchive </diagnostic-data-archive-type> <data-retirement-enabled>true</data-retirement-enabled> <preferred-store-size-limit>120</preferred-store-size-limit> <store-size-check-period>1</store-size-check-period> <wldf-data-retirement-by-age> <name>HarvestedDataRetirementPolicy</name> <enabled>true</enabled> <archive-name>HarvestedDataArchive</archive-name> <retirement-time>1</retirement-time> <retirement-period>24</retirement-period> <retirement-age>45</retirement-age> </wldf-data-retirement-by-age> <wldf-data-retirement-by-age> <name>EventsDataRetirementPolicy</name> <enabled>true</enabled> <archive-name>EventsDataArchive</archive-name> <retirement-time>10</retirement-time> <retirement-period>24</retirement-period> <retirement-age>72</retirement-age> </wldf-data-retirement-by-age> </server-diagnostic-config> </server> </domain>