プライマリ・コンテンツに移動
Oracle® Fusion Middleware Oracle WebLogic Server診断フレームワークの構成と使用
12
c
(12.2.1.3.0)
E90355-03
次
目次
タイトルおよび著作権情報
はじめに
ドキュメントのアクセシビリティ
表記規則
1
概要とロードマップ
WebLogic診断フレームワークとは
ドキュメントのスコープと対象読者
このドキュメントの手引き
関連ドキュメント
サンプルとチュートリアル
Avitek Medical Recordsアプリケーション(MedRec)とチュートリアル
ダウンロードのために利用可能なWLDF例
このガイドで説明する新機能
2
WLDFアーキテクチャの概要
WebLogic診断フレームワークの概要
データの作成、収集、およびインストゥルメンテーション
アーカイブ
ポリシーとアクション
データ・アクセサ
監視ダッシュボードおよびリクエスト・パフォーマンス・ページ
監視ダッシュボード
診断リクエスト・パフォーマンス・ページ
診断イメージ・キャプチャ
全体の構成
マルチテナンシのWLDFサポート
3
組込み診断システム・モジュールの使用
概要
組込み診断システム・モジュールのタイプ
組込み診断システム・モジュールにより収集されるデータ
組込み診断モジュールの構成
組込み診断システム・モジュールにより収集されたデータへのアクセス
監視ダッシュボードの使用
管理コンソールでのメトリック・ログ表の使用
組込みに基づいたカスタム診断システム・モジュールの作成
4
Javaフライト・レコーダと連携したWLDFの使用
Javaフライト・レコーダについて
Oracle HotSpotと連携したJavaフライト・レコーダの使用
Javaフライト・レコーダとのWLDF統合の主な機能
Javaフライト・レコーダのユース・ケース
クリティカル障害の診断 — 「ブラック・ボックス」
パフォーマンス・テストまたは本番の場合のプロファイリング
リアルタイム・アプリケーション診断および報告
フライト記録ファイルの取得
Javaフライト・レコーダ・データの分析
Javaフライト・レコーダ・グラフィカル・ユーザー・インタフェース
実行フローの分析 — サンプル・ウォークスルー
製品サブコンポーネントのイベント・データの表示
詳細を示すためのイベント・ログの表示
操作セットの分析による実行フローのトラキング
操作セットの展開および相関診断データの表示
一時JFRファイルの場所の変更
5
WLDF構成の理解
構成MBeanとXML
WLDFの構成用ツール
WLDF構成の区分
サーバー・レベルの構成
アプリケーション・レベルの構成
診断イメージ・キャプチャと診断アーカイブの構成
Javaフライト・レコーダの診断イメージ・キャプチャの構成
診断システム・モジュールの構成
リソース記述子について
WLDFランタイム・コントロール
構成済リソース記述子に基づいた診断システム・モジュールの作成
外部リソース記述子に基づいた診断システム・モジュールの作成
サーバーまたはクラスタを診断システム・モジュールのターゲットとして指定
診断システム・モジュールの動的アクティブ化または非アクティブ化
WLSTを使用した診断システム・モジュールのアクティブ化および非アクティブ化
例
診断システム・モジュールの構成の詳細
アプリケーション用の診断モジュールの構成
WLDF構成MBeanとXML要素へのマッピング
6
診断イメージの構成とキャプチャ
イメージ・キャプチャの開始方法
診断イメージ・キャプチャの構成
WLDF診断ボリュームの構成
Lowボリューム設定
Mediumボリューム設定
Highボリューム設定
イメージ・キャプチャ生成用のWLSTコマンド
サーバーの構成における診断イメージ・キャプチャの永続化
キャプチャされたイメージ・ファイルの内容
診断イメージ・キャプチャ・ファイルに含まれるデータ
診断イメージ・キャプチャのダウンロード用のWLSTオンライン・コマンド
7
診断アーカイブの構成
アーカイブの構成
ファイル・ベースのストアの構成
JDBCベースのストアの構成
データベースでのWLDF表の作成
Apache Derby
Oracleデータベース
MySQL
WLDF用のJDBCリソースの構成
アーカイブのデータのリタイア
サーバー・レベルでのデータ廃棄の構成
診断アーカイブに対する期間に基づいたデータ・リタイアメント・ポリシーの構成
サンプル構成
8
メトリック収集用のハーベスタの構成
メトリック収集、収集可能データ、および収集対象データ
様々な収集可能エンティティからのデータ収集
ハーベスタの構成
ハーベスタのサンプリング期間の構成
収集するデータの種類の構成
WebLogic Server MBeanとカスタムMBeanの型名の指定
ドメイン・ランタイムMBeanサーバーからの収集
構成設定を検証するタイミング
様々な収集可能な型の構成のサンプル
ハーベスタのパフォーマンスの考慮事項
9
ポリシーとアクションの構成
ポリシーとアクション
ポリシーおよびアクションの構成の概要
ポリシーおよびアクションの構成のサンプル
10
ポリシーの構成
ポリシーの構成方法
ルール・タイプ
式言語
ポリシー式
アクション
ポリシー・スケジュール
アラーム・オプション
重大度オプション
有効化オプション
スケジュール済ポリシーの構成
カレンダ・ベース・ポリシーの構成
スマート・ルール・ベース・ポリシーの構成
スマート・ルールが評価する診断データの種類
スマート・ルールの例
ポリシーのチェーン
ログ・ポリシーの構成
インストゥルメンテーション・ポリシーの構成
WLDF Java ELの拡張機能を使用した複雑なポリシー式の作成
Beanを使用した収集対象メトリック・ポリシー式の記述
収集対象メトリックのMBeanデータへのアクセス
複雑なMBean属性の操作
MBeanの収集対象メトリックの一括問合せの実行
関数を使用した収集対象メトリック・ポリシー式の記述
時間経過に伴うメトリック値の傾向の調査
ポリシー式による収集対象メトリックの抽出と調査
データ収集のライフサイクル
11
アクションの構成
アクションの概要
アクションの種類
カスタマイズ可能なアクションの変数
アクション・タイムアウト
JMXアクションの構成
JMSアクションの構成
SNMPアクションの構成
ログ・アクションの構成
RESTアクションの構成
SMTPアクションの構成
イメージ・アクションの構成
エラスティック・アクションの構成
エラスティック・スケーリング操作は開始後に取り消すことはできない
スケール・ダウン操作中のサーバー停止時間の制限
スクリプト・アクションの構成
ヒープ・ダンプ・アクションの構成
スレッド・ダンプ・アクションの構成
12
インストゥルメンテーションの構成
概念と用語
インストゥルメンテーションのスコープ
構成とデプロイメント
ジョインポイント、ポイントカット、診断ロケーション
診断モニターのタイプ
診断アクション
インストゥルメンテーション構成ファイル
インストゥルメンテーションに使用するXML要素
<Instrumentation> XML要素
<wldf-instrumentation-monitor> XML要素
各モニター・タイプへの<wldf-instrumentation-monitor>のXML要素のマッピング
サーバー・スコープのインストゥルメンテーションの構成
アプリケーション・スコープのインストゥルメンテーションの構成
システム・スコープのインストゥルメンテーションとアプリケーション・スコープのインストゥルメンテーションの比較
アプリケーションのインストゥルメントに必要なステップの概要
委任モニターの記述子ファイルの作成
カスタム・モニターの記述子ファイルの作成
カスタム・モニターのポイントカットの定義
アノテーション・ベースのポイントカット
リクエスト・パフォーマンス・データの作成
13
診断コンテキストを管理するためのDyeInjectionモニターの構成
診断コンテキストの内容、ライフサイクル、構成
コンテキストのライフ・サイクルとコンテキストID
仕分け、仕分けフラグ、仕分けベクトル
診断コンテキストが構成される場所
プロセスの概要
DyeInjectionモニターを介した仕分けベクトルの構成
DyeInjectionモニターでサポートされる仕分け
PROTOCOL仕分けフラグ
THROTTLE仕分けフラグ
診断コンテキストの作成条件
仕分けフィルタを使用するための委任モニターの構成
仕分けマスクによるモニターへ渡すリクエストのフィルタ方法
仕分けフィルタの例
インストゥルメンテーション・イベントの量を制御するスロットル機能の使用
THROTTLE仕分けの構成
委任モニター、カスタム・モニターでのスロットル機能の処理方法
weblogic.diagnostics.contextの使用
14
データ・アクセサを使用した診断データへのアクセス
データ・アクセサのアクセス対象のデータ・ストア
診断データへのオンライン・アクセス
管理コンソールを使用してデータへのアクセス
ランタイムMBeanを使用してプログラム的にデータへのアクセス
WLSTを使用してオンラインで診断データへのアクセス
データ・アクセサでWLDF問合せ言語の使用
診断データへのオフライン・アクセス
診断データへのプログラム的なアクセス
システム・クロックをリセットすることによるデータのアーカイブおよび取得に対する影響
15
WLDFアプリケーション・モジュールのデプロイメント
診断モジュールのアプリケーション・スコープ・リソースとしてのデプロイ
インストゥルメンテーション構成を動的に制御するためのデプロイメント・プランの使用
デプロイメント・プランの使用:概要
weblogic.PlanGeneratorによるデプロイメント・プランの作成
診断用のデプロイメント・プランのサンプル
Javaホットスワップの有効化
デプロイメント・プランによるアプリケーションのデプロイ
変更したプランによるアプリケーションの更新
16
監視ダッシュボードの使用
監視ダッシュボードの実行
表示される診断情報の範囲
監視ダッシュボードのインタフェースについて
ビュー・リスト
メトリック・ブラウザ
ビューの表示のパネル
メトリックの収集と表示の方法の理解
メトリックおよびチャート・タイプについて
現在時間範囲チャート
カスタム時間範囲チャート
メトリック・データが表示される順序
メトリック・データ保存に関するノート
チャートの構成要素
17
WLDFのプログラム的な構成と使用
WLDFによるデータの生成と取得
BeanおよびパッケージへのWLDFコンポーネントのマッピング
プログラミング・ツール
構成APIと実行時API
構成API
実行時API
WLDFパッケージ
WLDFプログラミング:サンプル
サンプル: DiagnosticContextExample.java
サンプル: HarvesterMonitor.java
通知リスナー
HarvesterMonitor.java
サンプル: JMXAccessorExample.java
18
デバッグ・パッチの使用
デバッグ・パッチの動的適用
デバッグ・パッチ・ディレクトリの指定
WLDFデバッグ・パッチ・エージェントの構成
デバッグ・パッチのWLSTコマンド
デバッグ・パッチの動的なアクティブ化
デバッグ・パッチの動的な非アクティブ化
A
スマート・ルールのリファレンス
スマート・ルールに指定するパラメータについて
クラスタ・スコープ・スマート・ルール
ClusterLowThroughput
ClusterHighProcessCpuLoadAverage
ClusterHighThroughput
ClusterLowPendingUserRequests
ClusterHighStuckThreads
ClusterLowQueueLength
ClusterHighPendingUserRequests
ClusterLowProcessCpuLoadAverage
ClusterHighIdleThreads
ClusterLowSystemLoadAverage
ClusterHighQueueLength
ClusterLowHeapFreePercent
ClusterHighSystemLoadAverage
ClusterHighHeapFreePercent
ClusterLowSystemCpuLoadAverage
ClusterLowIdleThreads
ClusterGenericMetricRule
ClusterHighSystemCpuLoadAverage
サーバー・スコープ・スマート・ルール
ServerLowIdleThreads
ServerHighThroughput
ServerGenericMetricRule
ServerLowPendingUserRequests
ServerLowProcessCpuLoadAverage
ServerHighSystemLoadAverage
ServerLowQueueLength
ServerLowThroughput
ServerHighQueueLength
ServerHighSystemCpuLoadAverage
ServerHighPendingUserRequests
ServerLowSystemCpuLoadAverage
ServerHighHeapFreePercent
ServerHighStuckThreads
ServerHighProcessCpuLoadAverage
ServerLowSystemLoadAverage
ServerLowHeapFreePercent
ServerHighIdleThreads
B
WLDF Beanおよび関数のリファレンス
WLDF Beanのリファレンス
clusterRuntime
domainRuntime
instrumentationEvent
log
partition
platform
resource
runtime
関数のリファレンス
wls:tableChanges
wls:tableAverages
wls:extract
wls:average
wls:changes
wls:aliveServersCount
C
WLDF問合せ言語
問合せ式の構成要素
サポートされる演算子
演算子の優先順位
String型の列でサポートされる数値の比較演算
サポートされる数値定数と文字列リテラル
式内の変数について
ポリシー式の作成
ログ・イベントのポリシー式の作成
インストゥルメンテーション・イベントのポリシー式の作成
ハーベスタのポリシー式の作成
データ・アクセサ問合せの作成
データ・ストアの論理名
データ・ストアの列名
ログ・フィルタ式の作成
複雑な式の作成
D
WLDFインストゥルメンテーション・ライブラリ
診断モニター・ライブラリ
診断アクション・ライブラリ
TraceAction
DisplayArgumentsAction
TraceElapsedTimeAction
TraceMemoryAllocationAction
StackDumpAction
ThreadDumpAction
MethodInvocationStatisticsAction
MethodInvocationStatisticsActionを使用したアプリケーションのインストゥルメントと結果に対する問合せ
MethodInvocationStatisticsActionを使用するためのカスタム・モニターの構成
WLSTを使用したメソッドのパフォーマンス統計への問合せ
MethodInvocationStatisticsActionデータを収集するためのハーベスタの構成
MethodInvocationStatisticsメトリックに基づくポリシーの構成
JMXによるデータの収集
MemoryAllocationStatisticsAction
E
式でのワイルドカードの使用
ハーベスタ・インスタンス名でのワイルドカードの使用
例
ハーベスタの複合属性およびネストされた属性の指定
例
収集された複合属性またはネストされた属性に関するアクセサの使用
ポリシー・インスタンス名でのワイルドカードの使用
ハーベスタのポリシーでの複合属性の指定
F
WebLogic Scripting Toolのサンプル
診断用のWLSTコマンド
サンプル: DyeInjectionモニターの動的な作成
例: ポリシーとJMXアクションの構成
サンプル: JMXWatchNotificationListenerクラスの記述
サンプル:収集用のMBeanと属性の登録
例: WLDF診断ボリュームの設定
例: 診断イメージのキャプチャ
例: 診断イメージ・キャプチャからのJFRファイルの取得
G
WLDF問合せ言語ベースのポリシー
ポリシーのタイプ
ポリシーの構成オプション
WLDF問合せ言語を使用したハーベスタ・ポリシーの構成
WLDF問合せ言語を使用したログ・ポリシーの構成
WLDF問合せ言語を使用したインストゥルメンテーション・ポリシーの構成
用語集