目次

タイトルおよび著作権情報

はじめに

• ドキュメントのアクセシビリティについて
• 表記規則

1 概要とロードマップ

• WebLogic診断フレームワークとは
• ドキュメントのスコープと対象読者
• このドキュメントの手引き
• 関連ドキュメント
• サンプルとチュートリアル
  • Avitek Medical Recordsアプリケーション(MedRec)とチュートリアル
  • ダウンロードのために利用可能なWLDF例
• このガイドで説明する新機能

2 WLDFアーキテクチャの概要

• WebLogic診断フレームワークの概要
• データの作成、収集、およびインストゥルメンテーション
• アーカイブ
• ポリシーとアクション
• データ・アクセサ
• 監視ダッシュボードおよびリクエスト・パフォーマンス・ページ
  • 監視ダッシュボード
  • 診断リクエスト・パフォーマンス・ページ
• 診断イメージ・キャプチャ
• 全体の構成

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 ポリシーの構成

• ポリシーの構成方法
  • ルール・タイプ
  • 式言語
  • ポリシー式
  • アクション
  • ポリシー・スケジュール
  • アラーム・オプション
  • 重大度オプション
  • 有効化オプション
• スケジュール済ポリシーの構成
  • カレンダ・ベース・ポリシーの構成
  • スマート・ルール・ベース・ポリシーの構成
    • スマート・ルールが評価する診断データの種類
    • スマート・ルールの例
  • 収集対象メトリック・ベース・ポリシーの構成
    • Beanの使用
    • 関数の使用
  • ポリシーのチェーン
• ログ・ポリシーの構成
• インストゥルメンテーション・ポリシーの構成

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問合せ言語を使用したインストゥルメンテーション・ポリシーの構成

用語集