6.11 ahfscope

ahfscopeコマンドを使用して、AHFスコープを管理します。

構文

ahfscope [flags] [parameters]
-f name
-i
-q value[,value]
	minutes
	clob
	psec
-C
-D item[,item]
	feed
	db
	input
	probes
	rootcause
	topology
	unit

パラメータ

表6-8 ahfscopeコマンドのパラメータ

パラメータ 説明

-f name

ファイルから読み取るように指定します。

ファイル拡張子を指定しない場合、AHFスコープはファイル拡張子として.mdbを想定します。

-i

ahfscopeを対話モードで実行するように指定します(推奨)。このオプションを使用すると、GUIから使用できない追加コマンドを入力できます。

ahfscope -iこのオプションで開始すると、オペレーティング・システム端末にcha>コマンドライン・プロンプトが表示されます。これは、グラフィカル・パネルで使用できない端末コマンドを入力するために使用できます。これらのコマンドは、プロンプトでhelpと入力することで列挙されます。

-q value[,value]

GIMRで実行される接続および問合せを構成するように指定します。このオプションは-fオプションとともに使用しないでください。

オプション・パラメータには、スペースなしでカンマ区切りリストを指定します。
  • minutes: 時間を分単位で問い合せるように指定します。デフォルト: 60分、最小: 2分。
  • clob: sql.clobを使用するように指定します。
  • psec: 問合せを秒単位で延期するように指定します。デフォルト: サンプリング期間。最小: 1秒

オプション-q minutesは、最初の問合せの時間に基づいてデータの量を設定します。サンプリング・レートは5秒であるため、60分のデフォルト・データ・セットには720データ・ポイントが含まれます。-qオプションを使用してより長い時間を選択すると、特に、監視対象の構成に多数のノードとデータベースがある場合、起動プロセスの時間がかなり長くなることがあります。このオプションの最大分数は、画面の幅(ピクセル数)を1分当たりのサンプル数で除算した値(サンプル間隔が5秒の場合は12)によって決まります。たとえば、水平ピクセルが1920の標準FHDモニターでは、分数は160 (2時間40分)に制限されます。

オプション-q psecondsは、問合せ内の時間と問合せの時間の間の遅延を調整します。問合せの時間は、問合せ内の時間の後になる必要があります。遅延が小さいほど、表示がリアルタイムに近い状態になります。デフォルトの遅延は、1サンプリング期間(5秒)です。遅延に関係なく、サンプルは常に5秒間のデータを提供します。たとえば、-qp10の場合、10:20から10:25の期間の5秒間のデータに対する問合せが10:35以降に呼び出されます。このオプションは、CHAが遅すぎてAHFスコープのトランザクションを期限内にコミットできないことがわかっている場合に使用します。このような場合、データのランダムなギャップが示されることがあります。高速なシステムでは、-qp1を使用しても悪影響はありません。

オプション-q clobは、データベースからCLOBを取得する代替パスを使用するようにAHFスコープに指示します。一部のバージョンのOracle Databaseでは、SQL問合せからCLOBを直接取得すると、データベースの断片化が発生します。ユーザーがこのオプション-qcを入力すると、AHFスコープは明示的な破棄コマンドを使用して、2ステップのプロセスを使用してCLOBを取得します。すべての問合せの経過時間が長くなります。

-C

選択したデータを.mdbファイルからJSON形式で抽出するように指定します。このオプションは、-fオプションと一緒にのみ使用してください。

-D item[,item]

デバッグ・モードを設定するように指定します。

このオプションを使用して、管理データベースの後に.mdbファイルというファイルに格納されているAHFスコープで受信したデータの完全なコピーを取得します。このファイルは、-f fileオプションで引数として使用できます。

オプション・パラメータには、スペースなしでカンマ区切りリストを指定します。
  • feed: すべてのデータ問合せのタイミングを表示するように指定します。
  • db: alter session set event 10046をアクティブにするように指定します。
  • input: 入力データ(CLOB)をログ・ファイルにコピーするように指定します。
  • probes: 内部プローブ名を使用するように指定します。
  • rootcause: 根本原因の開始および停止について通知する場合に指定します
  • topology: エンティティのセット(トポロジ)の変更を表示する場合に指定します。
  • unit: 単位の暗黙的な設定に関する警告を表示するように指定します。

ノート:

Microsoft Windowsシステムでは、すべてのカンマ区切りの引数を二重引用符で囲みます。

例: "-Dprobes,input"、または短い"-Dp,i"。

AHFスコープのモード

AHFスコープは、複数のモードで動作できます。
  • GIMRデータベースへのデフォルト接続あり
  • 監視データを含むテキスト・ファイルを読み取ります(オプション-f)。
  • データを含むテキスト・ファイルを解析し、問合せの診断に似た情報を含むJSONオブジェクトを生成します(オプション-C)。

デフォルト接続はライブ・セッションを開始し、リアルタイムの監視を提供します。GIMRデータベースへの接続は、Oracle JDBC thinドライバを使用してJDBC経由で確立されます。

MDBファイルをパラメータ(オプション-f)として使用すると、AHFスコープは、GIMRから抽出されたテキスト・データまたはライブ・セッション中に収集されたデータを分析します。このデータは、*.mdbファイルに保持されます。*.mdbファイルは、コマンドchactl export repositoryを使用してGIMRから生成できます。1時間分のデータを取得する例:
host:/dir> chactl export repository -format mdb -start '2018-11-22 09:30:00' -end '2018-11-22 10:30:00'
successfully dumped the CHA statistics to location "/hostname/trc/chad/cha_dump_20181122_093000_20181122_103000.mdb"

オプション -Cを使用すると、GUIフロントエンドなしでAHFスコープが開始されます。AHFスコープは、mdbファイルのみを解析し、chadiagで生成されたファイルと同様のJSONファイルを生成します。このデータは、他のツールで使用して、CHAが問題を診断した期間を示すことができます。

AHFスコープをコマンドライン・オプションを指定せずに呼び出すと、AHFスコープはJDBCを使用してGIMRデータベースに接続し、アクティブ・モニターとしてリアルタイム・モードで動作します。接続資格証明は、Oracle Walletまたはログイン・コンソールの手動入力から取得されます。接続が確立されると、AHFスコープは最新のN分間のデータを含むデータ・セットを取得します。AHFスコープの最初の呼出しでは、オプション-qを使用しないかぎり、データ・セットには60分が含まれます。後続の呼出しでは、データ・セットの分数は、ユーザーが選択したウィンドウの幅に対応します。

親トピック: 問題の根本原因の分析