Cisco Prime Performance Manager 1.0 統合開発者ガイド

レポート XML の主要要素

cpu.xml レポートには、7 つの主要セクションがあります。

• コメント ：cpu.xml ファイルの先頭には、ポーリングされる MIB を示すコメントが記述されます。なお、コメントは、XML ファイル内の任意の場所に配置できます。

すべてのレポート セクションは、PollerList と呼ばれる 1 つの XML セクション内に指定されます。PollerList セクションの最初の行は、「http://cisco.com/mwtm.poller」を指定します。サンプル レポートで指定されているように、必ずこれを含めます。Poll セクションは、複数指定できます。

Poll セクションは、XML ファイルの主要要素であり、4 つのセクションをカプセル化します。

Poll は、 EventPoller.xsd スキーマ ファイル内で Processor 要素内に定義された要素が含まれる複合要素型です。

• Criteria セクション ： SystemCability.xml ファイルまたは UserCapability.xml ファイルに定義されている機能値を指定します。

「MIB 基準の指定（Criteria セクション）」を参照してください。

• PollDefinition セクション ：ポーリング結果を保管するための仮想テーブルを作成するレポート マクロを呼び出します。

「ポール名とレポート名の指定（Poll 要素）」を参照してください。

• ProcessPollResult セクション ：レポーティング マクロを呼び出し、計算式または他の方法を使用してポーリング データを修正または整形する操作を実行します。

「ポール処理結果の指定（ProcessPollResult セクション）」を参照してください。

• ProcessDBSummary セクション ：レポート用のポーリングされたデータを保持する仮想テーブルに対し、テーブルと行の形式をセットアップおよび操作します。定義された処理間隔が終了するたびに、システムがその処理間隔のテーブル データをゲートウェイ上の物理データベースに書き込みます。

「データベース スキーマへのデータの割り当て（ProcessDBSummary セクション）」を参照してください。

最後の 2 つのセクションは、ユーザ レポートの外観と形式を指定します。

• CSV ：ユーザが CSV ビュー オプションを選択したときに作成される CSV ファイルのレイアウトを指定します。

「CSV 出力ファイルと形式の指定（CSV セクション）」を参照してください。

• WebReport ：ユーザがグラフ ビュー オプションを選択したときに表示されるグラフィカル レポートの属性を指定します。WebReport セクションには次が含まれます。

– 属性 ：Prime Performance Manager のメニュー内で使用されるこのレポートの名前、レポート ツリー内でこのレポートが表示される場所、このレポート データの取得元、この Web レポートのプロパティ ファイルなどを指定します。

「WebReport セクションの属性の指定」を参照してください。

– GraphView ：ユーザがグラフ ビュー オプションを選択したときに表示されるグラフ ビューの属性を指定します。

「GraphView セクションのコーディング」を参照してください。

– TableView ：ユーザがテーブル ビュー オプションを選択したときに表示されるテーブル ビューの属性を指定します。

「TableView セクションのコーディング」を参照してください。

レポーティング マクロ

Prime Performance Manager ゲートウェイと一緒に提供されるレポート マクロを自分の XML コード内で使用できます。一部のレポート マクロは、XML の特定のセクション内でのみ使用できます。レポート マクロのリファレンス情報については、「レポート マクロ リファレンス」を参照してください。

レポートに使用される MIB を示すコメントの追加

レポートの先頭に、レポート用にポーリングされる MIB を示したコメントを含めます。cpu.xml ファイルでは、次のコメントが含まれています。

MIB 基準の指定（Criteria セクション）

このセクションでは、レポート コーディングにおける高度な内容が処理されます。レポート用に MIB を処理する際に使用される基準を指定します。

SystemCapability.xml により、Prime Performance Manager レポートのデフォルトの MIB 処理基準が指定されます。 SystemCapability.xml ファイルは編集しないでください。MIB 処理基準を修正する必要がある場合は、UserCapability.xml ファイルを編集し、そこに独自の処理基準を指定します。

ポール名とレポート名の指定（Poll 要素）

Poll 要素：

• 次のように、ポーラーの名前とレポート ID を指定します。

ポーラーとレポート ID には一意の名前を割り当てる必要があります。

たとえば、cpu.xml ファイルを /user ディレクトリ内の別の XML ファイルにコピーする場合は、 /opt/CSCOppm-gw/etc/pollers/system ディレクトリ内や /opt/CSCOppm-gw/etc/pollers/user ディレクトリ内で重複しない新しい名前をポーラーとレポート ID に与えます。

• ポーリングおよびポーリング結果の処理をセットアップする下位の主要 XML セクションが含まれる複合 XML 要素です。

ポーリングする MIB 変数の指定（PollDefinition セクション）

ここでは、サンプル レポート コードの重要な部分である PollDefinition セクションについて見ていきます。このセクションでは、レポート用に実際に行われるポーリングをセットアップし、ポーリングされたデータを、Prime Performance Manager がレポートの生成に使用する内部データベース テーブルに割り当てます。

例 2-2 に、今回の cpu.xml レポートの PollDefinition セクションを示します。

例 2-2 PollDefinition セクション

このセクションでは、 CISCO-PROCESS-MIB.my の特定の変数がポーリングされ、それらが 2 つのテーブルに保管されます。

• cpmCPMTotalTable

• cpmCPUThresholdTable

これらの MIB オブジェクトは、CPU ロード モニタリングを提供する CISCO-PROCESS-MIB 内の標準オブジェクトです。その他の情報およびコメントについては、 CISCO-PROCESS-MIB.my ファイルを参照してください。

POLL マクロ

実際のポーリングは、POLL マクロを使用して行われます。このマクロの構文は次のとおりです。

POLL( arg1 , arg2 ... argn )

ここで、引数はポーリングされる MIB 変数のリストであり、引用符で囲まれます。

FILTER マクロ

次に、PollDefinition セクションは、PollDefinition オブジェクトに対して定義されるマクロ、FILTER マクロを呼び出します。

FILTER マクロの構文は次のとおりです。

FILTER( object , arg1 )

ここで、 object はマクロに渡されるテーブル オブジェクトです。 arg1 はフィルタリング基準を指定します。ここでは、cpmCPUThreshold クラスに基づいてフィルタリングしています。テーブル内で cpmCPUThresholdClass 値が 1 のオブジェクトの CPU データは保持され、それに一致しないオブジェクトおよびそれらのデータはテーブルから削除されます。

ここまでで、cpmCPUTotalTable と cpmCPUThresholdTable の 2 つのテーブルができます。処理効率を最大限に高めるために、これら 2 つのテーブルを 1 つの仮想テーブルに結合します。PollDefinition セクションの次の行でそれが行われています。

(cpmCPUTotalTable.cpmCPUTotalIndex == cpmCPUThresholdTable.cpmCPUTotalIndex))

これは、LEFTJOIN マクロを呼び出すことで行われます。このマクロは、cpmCPUThresholdTable と cpmCPUTotalTable を照らし合わせ、インデックス値が同じならば、2 つのテーブルの行を 1 つのテーブルに結合します。

これで、すべての処理対象データが含まれる 1 つのテーブルができました。

LEFTJOIN マクロ

LEFTJOIN マクロの構文は次のとおりです。

LEFTJOIN ( object , arg1 , arg2 )

ここで、 object と arg1 はテーブルです。 arg2 は各行の一致条件です。

このマクロは、 object と arg1 の結合結果のテーブルを返します。

object の行と arg1 の行は条件（ arg2 ）が真の場合に結合されますが、object の各行は、 arg1 に指定されたオブジェクトのどの行とも一致しなくても、結果として得られるテーブルに保持されます。

ポール処理結果の指定（ProcessPollResult セクション）

ProcessPollResult セクションは、CPU レポートに表示する情報を取得するために、データを操作し、それを処理する変数をセットアップします。

例 2-3 に、cpu.xml ファイルの ProcessPollResult セクションを示します。

例 2-3 ProcessPollResult セクション

次のことを行う必要があります。

1. CISCO-PROCESS-MIB に定義されている 2 つの時間間隔での CPU 平均使用率についてパーセント値を計算します。cpmCPUTotal5minRev は 5 分間隔、cpmCPUTotal1minRev は 1 分間隔です。

2. さらに、CPU 平均ピーク使用率についてパーセント値を計算します。この数値の計算に使用されるデータは、cpmCPURisingThresholdValue 値と cpmCPUFallingThresholdValue 値に保管されています。

3. SETCPUINFO マクロを呼び出すことから始めます。このマクロは、インデックスの指定がなければ、テーブル内にデータが返される CPU ごとに、CPU の説明、CPU 番号、および CPU スロットを単純に設定します。

CPU 平均使用率と CPU 平均ピーク使用率の決定に使用されるパーセント値は、各 MIB 変数のデータを 100 で割ることにより計算されます。

これで、Prime Performance Manager レポートに表示するデータが得られました。

次に、計算された値を Prime Performance Manager ゲートウェイのデータベースに割り当てます。これは、XML コードの次のセクション（ProcessDBSummary セクション）で行われます。

データベース スキーマへのデータの割り当て（ProcessDBSummary セクション）

ProcessDBSummary セクションは、レポートに表示される順序でデータが並ぶテーブル行を仮想データ テーブル内にセットアップします。

例 2-4 に、cpu.xml レポートの ProcessDBSummary セクションを示します。

例 2-4 ProcessDBSummary セクション

ProcessDBSummary セクションの最初の行は、ポールの名前とレポートの名前を指定します。

ProcessDBSummary セクション内の残りのコードは、基本的に、仮想データベースの各行にセットアップされるカラムをセットアップします。

今回の cpu.xml レポートで使用されるコードは、実際には process.xml ファイルに定義されている「ボイラープレート」ProcessDBSummary セクションをモデルにしています。 process.xml ファイルのコードを他のレポート内にコピーして CPU プロセス情報を表示することはできますが、 process.xml ファイルを修正することはしないでください。

一部のテーブル カラムの操作変数で指定されている操作は、 EventPoller.xsd スキーマ ファイルに定義されています。

このコードは、カラムをセットアップする変数でテーブル カラムをセットアップします。たとえば、このセクションの最初の 3 行は、CPU スロット番号、CPU 番号、CPU の説明をセットアップします。

レポートの [Average Utilization] パートと [Peak Utilization] パートに使用される 2 つのカラムには、平均値と最大値の計算が必要です。これらは、次のように operation="Max" や operation = "Avg" が含まれる行で指定されます。

ポーリング データおよびそのデータから計算された値は、ユーザが Prime Performance Manager ユーザ インターフェイスで選択する任意の CPU レポートで使用できるように、メモリ内の仮想テーブルに保持されます。

定義されたポーリング間隔が終了するたびに、その指定されたポーリング間隔でセットアップされた仮想テーブルのデータが Prime Performance Manager ゲートウェイ上の物理データベースに書き込まれます。

ここまでで、各ポーリング対象デバイスをレポートするための、MIB のポーリングされた変数からのデータの抽出、データの操作、およびテーブルのセットアップが完了しました。

次に、レポートの形式について指定することができます。これは、次の 2 つのセクション（CSV セクションと WebReport セクション）で行われます。

CSV 出力ファイルと形式の指定（CSV セクション）

CSV セクションは、ユーザが CSV レポート オプションを選択した際にデータがカンマ区切り値（CSV）ファイルに書き込まれるときのデータのレイアウトを指定します。

例 2-5 に、cpu.xml レポートの CSV セクションを示します。

例 2-5 CSV セクション

CSV セクションの最初の行は、3 つの値を指定します。

• レポートの名前。

• レポートの場所（この例では、Prime Performance Manager ゲートウェイ）および listen 変数（使用されるポーラー）。

CSV セクションの残りの行は、テキスト文字列またはデータベース カラム データを単純に指定します。

これで、Web レポートをセットアップする準備が整いました。

Web レポートのセットアップ（WebReport セクションと TableView セクション）

WebReport セクション（XML 要素）には次のものが含まれます。

• 属性 ：Prime Performance Manager のメニュー内で使用されるこのレポートの名前、レポート ツリー内でこのレポートが表示される場所、このレポート データの取得元、この Web レポートのプロパティ ファイルなどを指定します。

• GraphView セクション ：レポートのグラフ ビューをセットアップします。

• TableView セクション ：レポートのテーブル ビューをセットアップします。

WebReport セクションの属性の指定

WebReport セクションの属性は、レポートが表示される場所と使用するデータを決める重要な情報を指定します。

各属性は、XML レポートのプロパティ ファイルで指定されている値を設定します。cpu.xml レポートのプロパティ ファイルの詳細については、「WebReport セクションの属性の指定」を参照してください。

例 2-6 に、cpu.xml ファイルの WebReport セクションに指定されている属性を示します。

例 2-6 WebReport の属性

例 2-6 に示されているコードは、次の属性を設定しています。

• name ：一意の名前を指定します。これは、プロパティ ファイル（cpu.properties）で指定されます。Prime Performance Manager のメニューに表示されるレポート名になります。

• category ：Prime Performance Manager のレポート ツリー内でこのレポートが表示される場所を指定します。

category="level1Resources,level2CPU" の行は、この CPU レポートが [Resources] レポート カテゴリの下に表示され、テキスト「CPU」で識別されることを指定しています。

• context ：レポートで使用可能なドリルダウン オプションと、レポートを表示できる場所を指定します。

• textProps ：使用するプロパティ ファイルの名前を指定します（cpu.properties）。

• sortWeight ：割り当てられたカテゴリ内でのレポートのソート順序を指定します。

sortWeight=2 の行は、この CPU レポートが [Resources] メニュー上で 2 番目のレポートであることを指定しています。

プロパティ ファイルの使用方法

プロパティ ファイルの目的は 1 つだけです。それは、Web GUI に表示されるテキスト文字列を保持する変数をセットアップすることであり、これらの変数は、ユーザがグラフ ビューまたはテーブル ビューを選択した際に使用されます。

例 2-7 に、cpu.xml レポートのプロパティ ファイルを示します。

例 2-7 cpu.properties ファイル

GraphView セクションのコーディング

GraphView セクションは、レポートのグラフ ビューをセットアップします。これには、次のものが含まれます。

• レポート ツリー内でレポートが表示されるレベル

• レポート ID

• レポートを表示可能なコンテキスト

• レポート内のテキスト表示

• マスター レポート リスト内でのレポートの順序

表示されるテキストは、例 2-8 に示されているように、レポートのプロパティ ファイルに定義された変数を使用して指定する必要があります。

例 2-8 に、cpu.xml レポートの GraphView セクションを示します。

例 2-8 GraphView セクション

GraphsSummary 要素は、Prime Performance Manager GUI でレポート グラフの上に表示されるタイトルを指定します。

この場合、タイトルは、プロパティ ファイル内の gstCPUUtil 変数で指定されたもの（「CPU Utilization」）になります。

最初のレポート表示時のサマリー テーブルの非表示化

レポートが初めて表示されるときにサマリー テーブルを非表示にする場合は、minimized 属性を次の例のように使用できます。

（注） Prime Performance Manager 1.0.2 では、ユーザ単位でサマリー タイトルの表示を変更できます。

Graph セクションのコーディング

GraphView セクション内の Graph セクションは、グラフ ビューに表示されたグラフを識別するテキスト文字列を指定します。この CPU レポートでは、2 つのグラフがプロパティ ファイルの定義に従って識別されます。識別されるグラフは、CPU Average Utilization と CPU Average Peak Utilization です。

Graph セクション内では、次のことができます。

• Column 要素をコーディングすることにより、データベースの値を「そのまま」表示できます。

• Util 要素をコーディングすることにより、データに対して操作を実行できます。

cpu.xml レポートの Graph セクション内のコードは、基準値の 100 倍の Util 値を指定しています。

LeafGraph セクションのコーディング

レポートのセットアップがサブレポートを使用して最低レベルにまでドリルダウンしたとき、レポート対象のオブジェクトのインスタンスが 1 つしか残っていなければ、そのオブジェクトのさまざまなデータ メトリックを 1 つのグラフに合成できます。これは、LeafGraph セクションをコーディングして行います。

たとえば、CPU レポートの場合、ユーザは、各プロセッサの [CPU Description] カラム内にあるテキストをクリックして、CPU Average and Peak Utilization レポートと呼ばれる合成されたレポートを表示できます。このようなサブレポートは、LeafGraph セクションで定義されます。

CPU レポートの LeafGraph セクションは、次のように指定されています。

LeafGraph セクションの title 属性は、プロパティ ファイルの変数（ gtCPUUtil ）を指定しています。この変数は、リーフ レポートのタイトル「CPU Average and Peak Utilization」を指定しています。

Util セクションは、リーフ レポート「Peak Utilization and Average Utilization」の上部のテーブルに表示される 2 つのレポート項目のタイトルを指定しています。Util 変数は、表示されるテーブル データを指定しています。

TableView セクションのコーディング

cpu.xml レポートの最後のセクションは、レポートのテーブル ビューの形式を設定します。

例 2-9 に、cpu.xml レポートの TableView セクションを示します。

例 2-9 TableView セクション

図 2-1 に、CPU レポートのテーブル ビューを示します。

図 2-1 テーブル ビューの例

TableView セクション内のコードは、テーブルのレイアウトをセットアップする属性を指定します。

• 図 2-1 に示されているように、見出しには、2 つの副見出しを持つものがあります。たとえば、[5 Min Util] には [Avg] と [Peak] の副見出しがあり、[Threshold] には [Rising] と [Falling] の副見出しがあります。

これらは、3 つの Label セクションで指定されます。

colSpans 属性は、主見出しが 2 つのサブカラムにわたることを指定しています。name 属性は、プロパティ ファイルの指定に従って見出しのテキストを定義する変数を指定します。たとえば、cpuUtil5Min は、5 Min Util という文字列を指定しています。

• いくつかのレポート カラムには、他の項目へのリンクが含まれています。たとえば、[CPU Description] カラムには、選択された CPU のレポートを表示するリンクが含まれています。また、[CPU Description] カラムには、選択されたノードのレポートを表示するリンクが含まれています。

これらのリンクは、次のように Link セクションで定義されます。

各 Link セクションの name 属性は、項目を説明する文字列（プロパティ ファイル内の変数で定義される）を指定します。たとえば、slot ならば「Slot」が指定されます。context 属性は、ProcessDBSummary セクション内のカラムを指定します。たとえば、slot の場合、CPUSlot のデータ カラムが表示されます。

Time セクションは、時間範囲レポートごとのデータが含まれる DBSummary テーブルのカラムと、サブカラムの見出しを指定します。たとえば、[Threshold] カラムの [Rising] サブカラムに対し、このコードは Util 値を指定しています。

Util 操作をデータに適用したくない場合は、代わりに Column 要素をコーディングできます。この場合、データは変更されずに表示されます。

オンライン ヘルプ ファイルの手動生成

システムによって生成されるオンライン ヘルプ ファイルを手動で生成する場合は、ゲートウェイのコマンド ラインから次を入力します。

/system ディレクトリ内のファイルを編集しない

/opt/CSCOppm-gw/etc/pollers/system ディレクトリ内のファイルを編集してはなりません。既存のレポート ファイルとそれに関連したプロパティ ファイルを新規のカスタマイズされたレポートのひな形として使用する場合は、それらのファイルを /opt/CSCOppm-gw/etc/pollers/user ディレクトリにコピーし、その場所でそれらを編集します。

SystemCapability.xml ファイルを編集しない

SystemCapability.xml ファイルを編集してはなりません。このファイルは、 /opt/CSCOppm-gw/etc ディレクトリにあります。独自のレポートに使用される機能を修正するには、必要に応じて UserCapability.xml ファイルを編集します。このファイルも /opt/CSCOppm-gw/etc ディレクトリにあります。

新しい .xml ファイルと .properties ファイルは /user ディレクトリに追加

新しい .xml ファイルまたは .properties ファイルを追加する必要がある場合は、それらのファイルを /opt/CSCOppm-gw/etc/pollers/user ディレクトリに追加し、編集します。

既存のレポートで使用されるスキーマを修正する際は注意すること

レポートのコードを作成するとき、以前に作成されたレポートで使用されるスキーマを修正する際は注意してください。内部スキーマを、それに影響を及ぼす既存のコーディングを考慮せずに修正すると、内部データベースが不安定になって、データベースの再初期化が必要になる場合があります。

レポートには一意のポーラー名、レポート ID、およびデータベース テーブル名を使用

レポートには常に一意のポーラー名、レポート ID、およびデータベース テーブル名を使用してください。既存の名前を使用すると、重大なシステムの問題が発生する可能性があります。

プロパティ ファイルを使用して共通の設定を指定

レポートの XML ファイルに関連付けられた .properties ファイルを使用して、レポートの複数のセクションで使用される設定や複数のレポート間で使用される設定を指定します。これにより、処理の一貫性が保証され、同じ変数を複数回コーディングすることにより発生する可能性のある誤りも排除できます。

データベースに保管するためのデータ計算を最適化

レポートを作成するとき、レポートで使用されるデータ計算を最適化します。これにより、システムの処理時間が短縮されます。

5 分のレポートのイネーブル化

5 分のレポートは、デフォルトではイネーブルになっていません。5 分のレポーティングをイネーブルにするには、レポートに対応する XML レポート定義ファイルを編集します。ProcessDBSummary セクションと WebReport セクションに interval 属性を追加する必要があります。

ここでは、cpu.xml レポート定義ファイル内で、interval 属性を CPU 使用率レポートに追加して 5 分のレポーティングをイネーブルにする例を示します。

5 分の間隔は、 interval="Min5Min15MinHourlyDaily" で定義されています。この属性は、デフォルトでは定義されません。定義されていなければ、15 分、毎時、および毎日のレポートがデフォルトとして設定されます。

5 分のレポーティングは、グローバルにイネーブルにすることも必要です。これは、管理ユーザが Web UI を介して [Reports Settings] ページ上で行います。5 分のレポートが取得されるデバイスの SNMP ポーリング間隔は、管理者が Web UI の [SNMP] タブ上で設定する必要があります（ここにそのページへの参照を追加）。

（注） 5 分のレポートをイネーブルにすると、PPM ユニットに必要なリソース量が大幅に増加します。

テーブルとビューのドロップ

レポートの作成中、テーブルが破損したり、テーブルの定義が変更されたりする可能性があります。そのため、データベース テーブルを削除することが必要になる場合があります。さらに、SQL ビュー全体をドロップすることが必要になる場合もあります。

Cisco Prime Performance Manager では、SQL コマンドを使用して、テーブルやビューをドロップできます。

ゲートウェイ上でテーブルとビューをドロップするには、次の手順を実行します。

ステップ 1 http://< machine_name >:4440/ppm/jsp/dbquery.jsp にアクセスして次の SQL コマンドを実行します。

ステップ 2 ユニット デバイス上で、 http://< machine_name >:5440/ppm/jsp/dbquery.jsp にアクセスして次の SQL コマンドを実行します。

既存のレポートへの新しいカラムの追加

新しいカラムを既存のレポートに追加するには、次の手順を実行します。

ステップ 1 「テーブルとビューのドロップ」の手順にあるステップを実行します。

ステップ 2 必要な MIB 属性が PollDefinition セクションでポーリングされていない場合は、ポーリング定義を修正します。

ステップ 3 「ProcessPollResult セクションの修正」の説明に従って必要な計算式を含めます。

ステップ 4 <ProcessDBSummary> 要素内で Var 要素を使用して、データベース テーブルに変数を追加します（「ProcessDBSummary セクションの修正」を参照）。

ステップ 5 変更内容を保存し、ゲートウェイとユニットを再起動します。

ProcessDBSummary セクションの修正

ProcessDBSummary セクションに変数を追加するには、次の手順を実行します。

ステップ 1 必要な MIB 属性が PollDefinition セクションでポーリングされていない場合は、ポーリング定義を修正します（「ポール定義の修正」を参照）。

ステップ 2 計算式が必要な場合は、ProcessPollResult セクションにその計算式を追加します（「ProcessPollResult セクションの修正」を参照）。

ステップ 3 次の例のように、 Var を使用して変数を追加します。

例 1 ：式の計算を必要としない変数の場合、ProcessDBSummary セクションでコードを次のように追加します。

例 2 ：式の計算を必要とする変数の場合、次のように、計算式を ProcessPollResult セクションに追加し（ 「ProcessPollResult セクションの修正」 を参照）、その結果を ProcessDBSummary セクションに追加します。

ポール定義の修正

ポール定義を修正するには、次の手順を実行します。

ステップ 1 MIB 属性のポーリング対象となる MIB テーブル名を MIBLevel セクションに含めます。

例：

ここで、CISCO_PROCESS_MIB は MIB テーブル名です。

ステップ 2 次のように、poll 関数を PollDefinition セクションに含めます。

ここで、cpmCPUTotalIndex と cpmCPUTotal5minRev は、CISCO_PROCESS_MIB の MIB 属性です。

ProcessPollResult セクションの修正

ProcessPollResult セクションを修正するには、次の手順を実行します。

ステップ 1 必要な MIB 属性が PollDefinition セクションでポーリングされていない場合は、「ポール定義の修正」を参照してください。

ステップ 2 計算式を記述し、それを変数に代入します。

たとえば、cpu.xml の場合、cpmCPUTotal5minRev はポーリングされた変数であり、計算される式は cpmCPUTotal5minRev / 100 です。

ステップ 3 次のように、計算式を <ProcessPollResult> セクションに含めます。

fiveMinUtil は、ユーザによって与えられた意味のある名前です。これは、ProcessDBSummary セクションなどの他の XML セクション内で使用できます。

Cisco Prime Network 内でのレポートの相互起動のセットアップ

Cisco Prime Performance Manager を Cisco Prime Network（Cisco Active Network Abstraction）と組み合わせて使用する場合、Cisco ANA NetworkVision のデバイス ショートカット メニューからの Prime Performance Manager レポートの相互起動をセットアップできます。

これを行うには、次の 2 つの方法があります。

• Prime Performance Manager GUI の使用

• ppm crosslaunch CLI コマンドの使用

Prime Performance Manager GUI の使用

Prime Performance Manager GUI を使用して相互起動をセットアップするには、次の手順を実行します。

ステップ 1 メニュー ツリーから [Administrative] を選択します。

ステップ 2 [Prime Network] タブをクリックします。

[Prime Network Gateway] ページが表示されます。

ステップ 3 [Prime Network Gateway] ページ上で、Prime Network ゲートウェイにログインするためのパラメータを入力します。

ステップ 4 [Install Cross Launch] アイコンをクリックします。

Prime Performance Manager ゲートウェイは、Prime Network ゲートウェイと通信し、Cisco Prime Performance Manager レポートのメニュー選択をデバイス ショートカット メニューに追加する BQL スクリプトを自動的にインストールします。

図 2-2 に例を示します。

図 2-2 相互起動のメニュー選択のあるデバイス ショートカット メニュー

このプロセスは、[Performance] > [Device Reports] のメニュー選択を ANA のデバイス ショートカット メニューに追加します。

これで、ANA ユーザは、インストールされたレポートをサポートするノードまたはインターフェイスからノード レベルまたはインターフェイス レベルのレポートを起動できるようになりました。

コマンド ラインの使用

Prime Performance Manager CLI を使用して相互起動をセットアップするには、ゲートウェイ上で次のコマンドを入力します。

独自レポートの相互起動の追加

Prime Performance Manager ゲートウェイ上の CSCOpm-gw/etc/bql/xl ディレクトリには、ANA 内の相互起動ポイントを設定および削除するための BQL 例がいくつか含まれています。

相互起動ポイントを設定する BQL スクリプトすべてに、それぞれの相互起動を削除するための BQL ファイルが用意されていることに注意してください。

次の例では、Cisco ANA 内にノード レベルの相互起動ポイントを追加する相互起動 BQL を示します。

例 2-10 に、Prime Performance Manager レポートをノード レベルで起動するための [Performance] > [Device Reports] メニュー選択をユーザに提供して、相互起動ポイントを追加する方法を示します。

例 2-10 node.bql ファイル

例 2-11 に、この相互起動ポイントを削除するためのサンプル BQL を示します。

例 2-11 node-remove.bql ファイル

独自のレポートを作成した後は、付属の BQL サンプルを修正し、相互起動をイネーブルにすることで、Cisco ANA 内に相互起動ポイントを追加できます。