サードパーティ製アプリケーションとの統合

Mercury Business Availability Center
サードパーティ製アプリケーションとの統合
Version 6.1
i
Mercury Business Availability Center, Version 6.1
サードパーティ製アプリケーションとの統合
本マニュアル，付属するソフトウェアおよびその他の文書の著作権は，米国著作権法，および各国の著作
権法によって保護されており，付属する使用許諾契約書に基づきその範囲内でのみ使用されるものとしま
す。Mercury Interactive Corporation のソフトウェア，その他の製品およびサービスの機能は次の 1 つまたは
それ以上の特許に記述があります。米国特許番号 5,511,185; 5,657,438; 5,701,139; 5,870,559; 5,958,008;
5,974,572; 6,137,782; 6,138,157; 6,144,962; 6,205,122; 6,237,006; 6,341,310; 6,360,332, 6,449,739; 6,470,383;
6,477,483; 6,549,944; 6,560,564; 6,564,342; 6,587,969; 6,631,408; 6,631,411; 6,633,912; 6,694,288; 6,738,813;
6,738,933; 6,754,701; 6,792,460 および 6,810,494。オーストラリア特許番号 763468 および 762554。その他の
特許は米国およびその他の国で申請中です。すべての権利は弊社に帰属します。
Mercury，Mercury Interactive，Mercury のロゴ，Mercury Interactive のロゴ，LoadRunner，WinRunner，
SiteScope および TestCenter は，米国およびその他の国の Mercury Interactive Corporation の商標または登録
商標です。上記の一覧に含まれていない商標についても，Mercury Interactive が当該商標の知的所有権を放
棄するものではありません。
その他の企業名，ブランド名，製品名の商標および登録商標は，各所有者に帰属します。
Mercury Interactive Corporation は，どの商標がどの企業または組織の所有に属するかを明記する責任を負い
ません。
Mercury では，補足情報を検索するため，サードパーティの Web サイトへのリンクを提供しています。サ
イトの内容および利用は予告なしに変更される場合があります。Mercury は，サイトの内容または利用に
ついて，いかなる表明や保証を行うものではありません。
Mercury Interactive Corporation
379 North Whisman Road
Mountain View, CA 94043
Tel: (650) 603-5200
Toll Free: (800) TEST-911
Customer Support: (877) TEST-HLP
Fax: (650) 603-5300
© 2005-2006 Mercury Interactive Corporation, All rights reserved
本書に関するご意見やご要望は [email protected] まで電子メールにてお送りください。
AMLIB_THRD6.1JP/01
目次
サードパーティ製のアプリケーションとの統合 ....................................... v
本書の構成................................................................................................. v
対象読者 ................................................................................................... vi
詳細情報について..................................................................................... vi
第 1 部：データ A P I での作業
第 1 章 Generic Data Engine API での作業..........................................3
Generic Data Engine API の使用...............................................................4
戻りデータ.................................................................................................6
第 2 章 OpenAPI クエリ・ビルダ ..........................................................9
OpenAPI クエリ・ビルダについて .........................................................10
OpenAPI クエリ・ビルダによるクエリの作成 .......................................11
第 3 章サンプル・クエリの作成..........................................................15
Generic Data Engine で使用するクエリ .................................................16
Generic Data Engine クエリの例 ............................................................20
従来のクエリ ...........................................................................................21
第 2 部：M e r c u r y B u s i n e s s A v a i l a b i l i t y C e n t e r
EMS アダプタを使用した作業
第4章
Mercury Business Availability Center と
EMS 統合の概要 .....................................................................37
Mercury Business Availability Center と EMS の統合について...............38
SiteScope を使用した Mercury Business Availability Center 内
の EMS アプリケーション・データの統合 .............................................38
EMS アダプタの設定...............................................................................39
iii
目次
第5章
BMC PATROL への Mercury Business Availability Center
警告の送信 ..............................................................................41
BMC PATROL への Mercury Business Availability Center 警告
の送信について ....................................................................................42
Mercury Business Availability Center SNMP アダプタの
BMC PATROL エージェントへのインストール ...................................42
インストールのトラブルシューティング ................................................43
第6章
CA Unicenter への Mercury Business Availability Center
警告の送信 ...............................................................................45
Unicenter Management サーバへ Mercury Business Availability
Center 警告を SNMP トラップとして送信する ..................................46
Mercury Business Availability Center 警告の SNMP トラップ
としての送信 ........................................................................................46
Unicenter cawto コマンドを使用して Mercury Business Availability
Center 警告を送信する........................................................................48
設定に関するトラブルシューティング....................................................50
第7章
HP Openview VantagePoint Operations への
Mercury Business Availability Center 警告の送信 ..............53
HP Openview VantagePoint Operations への Mercury Business
Availability Center 警告の送信について ..............................................54
HP OVO エージェントの存在の検証......................................................54
HP OVO エージェントのコア・サーバ・マシンへのインストール........55
opcmsg テンプレートの Mercury Business Availability Center
ホストへの割り当てと配布 ..................................................................56
HP OVO エージェントの opcmsg コマンドを使用した
Mercury Business Availability Center 警告の送信 ................................57
第8章
Tivoli TEC への Mercury Business Availability Center
警告の送信 ...............................................................................59
Mercury Business Availability Center 警告の Tivoli TEC への送信..........60
Tivoli TEC の設定 ....................................................................................60
Tivoli エンド・ポイントの postemsg コマンドによる
Mercury Business Availability Center 警告の送信 ...............................62
索引 .........................................................................................................65
iv
サードパーティ製のアプリケーションとの統合
本書では，サードパーティ製ツールやカスタム・ツールで使用するデータを
Mercury Business Availability Center から抽出する Generic Data Engine API の使用
方法について説明します。また，Mercury Business Availability Center が EMS コ
ンソールに対して生成する警告を統合する方法についても説明します。
本書の構成
本書は以下の部で構成されています。
第1部
データ API での作業
Mercury Business Availability Center の Generic Data Engine API を使用して，サー
ドパーティ製ツールやカスタム・ツールで使用するデータを Mercury Business
Availability Center から抽出する方法について説明します。
第2部
Mercury Business Availability Center EMS アダプタを使用した作業
Mercury Business Availability Center とさまざまな EMS アプリケーションを統合
して，EMS コンソールに Mercury Business Availability Center 警告を送信する方
法について説明します。
v
ようこそ
対象読者
本書は Mercury Business Availability Center の次のユーザを対象としています。
➤ Mercury Business Availability Center の管理者
➤ Mercury Business Availability Center のプラットフォーム管理者
➤ Mercury Business Availability Center のアプリケーション管理者
➤ Mercury Business Availability Center のデータ・コレクタ管理者
本書は，エンタープライズ・システムの管理に関する知識と Mercury Business
Availability Center に関する知識を前提としています。
詳細情報について
Mercury Business Availability Center 文書ライブラリの使用と更新の詳細，その他
の文書リソースの参照情報，文書ライブラリで使用している表記規則，および
Mercury Business Availability Center の配備，管理，使用に関するクイック・リ
ファレンスの詳細については，『Mercury Business Availability Center スタート
アップ・ガイド』を参照してください。
vi
第1部
データ API での作業
第1章
Generic Data Engine API での作業
Mercury Managed Services のお客様へ : Mercury Managed 環境における Generic
Data Engine API の使用方法については，Mercury Managed Services サポートまで
お問い合わせください。
本章では，サードパーティ製ツールやカスタム・ツールで使用するデータを
Mercury Business Availability Center から抽出する Generic Data Engine API を使用
する方法について説明します。
本章の内容
ページ
Generic Data Engine API の使用
4
戻りデータ
6
3
第 1 部 • データ API での作業
Generic Data Engine API の使用
注：Generic Data Engine API のユーザは，次について十分理解している必要があ
ります。
➤ SQL
➤ SOAP の仕様（Web Service を使用している場合）
➤ オブジェクト指向プログラミング言語（C++ や Java など。Web Service を使
用している場合）
➤ Mercury Business Availability Center の管理とアプリケーション
Generic Data Engine では，次の方法でクエリを送信することにより，Mercury
Business Availability Center プロファイル・データベースからデータを取得でき
ます。
➤ Web ブラウザ : 要求は HTML クエリとして送信されます。データは，Microsoft
Excel やカスタム・ツールで開くことができるよう，HTML または CSV
（Comma Separated Values）形式のファイルで返されます。
➤ Web Service : 戻りオブジェクトには，CSV 形式でデータが格納されています。
クエリの作成
Generic Data Engine に送信するクエリは，OpenAPI クエリ・ビルダを使用して
も，手作業でも作成できます。
OpenAPI クエリ・ビルダでは，グラフィカルなインタフェースを利用して，
HTML クエリを簡単に作成することができます。作成したクエリは，Web ブラ
ウザを使用して Generic Data Engine に送信できます。詳細については，第 2 章
「OpenAPI クエリ・ビルダ」を参照してください。
クエリを手作業で作成する方法，およびクエリの構文や制限の詳細について
は，第 3 章「サンプル・クエリの作成」を参照してください。
4
第 1 章 • Generic Data Engine API での作業
サンプルのメタデータの取得
クエリを作成するには，サンプルのデータ表現についての知識が必要です。使
用されることの多いクエリのサンプルについては，『参照情報』の「サンプル」
を参照してください。
特殊なレポートが必要な場合は，MBean Inspector を使用して，すべてのサンプ
ルとそのフィールドのリストを取得できます。MBean Inspector にアクセスする
には，ブラウザで次の URL を入力します。
http:// ＜サーバ＞ [:port]/jmxconsole/HtmlAdaptor?action=inspectMBean&name=Topaz%3Aservice%3DMet
a-Data+Manager
標準のポート番号は 8080 です。このポートでアクセスできない場合は，正し
いポート番号についてはシステム管理者に確認してください。
［MBean Inspector］ページで，showMetaDataDBMapping 操作の横にある
［Invoke］ボタンをクリックします。MBean Inspector により，各サンプルの
フィールドのリストが返されます。
権限
データにアクセスするには，System Viewer または Superuser のロールが必要で
す。クエリ内で渡されるユーザ名にはこれらの権限がないため，応答は認証エ
ラーとなります。
Web Service の呼び出し
Generic Data Engine Web Service では，ユーザ名，パスワード，および SQL のよ
うな select ステートメントを送信できます。このエンジンは，ステートメント
を追跡できない場合，またはクエリの実行で問題のある場合は，エラー説明を
返します。エラーのない場合は，クエリの結果が返されます。
SOAP プログラマは，次の URL で WSDL にアクセスできます。
http:// ＜サーバ＞ [:port]/topaz/gdeopenapi/services/GdeWsOpenAPI?wsdl
ポートの指定は，標準とは異なる設定でインストールされている場合のみ必要
です。正しいポート番号についてはシステム管理者に問い合わせてください。
クエリの作成の詳細については，第 3 章「サンプル・クエリの作成」を参照し
てください。
5
5
第 1 部 • データ API での作業
ブラウザによるクエリの実行
ブラウザを使用してクエリを実行する場合，次の URL で getData サービスが呼
び出されます。
http:// ＜サーバ＞
[:port]/topaz/gdeopenapi/GdeOpenApi?method=getData&user= ＜ユーザ名＞
&password= ＜パスワード＞ &query= ＜クエリ＞
または，次のように，オプションの結果タイプ・パラメータを指定しても呼び
出されます。
http:// ＜サーバ＞
[:port]/topaz/gdeopenapi/GdeOpenApi?method=getData&user= ＜ユーザ名＞
&password= ＜パスワード＞ &query= ＜クエリ＞ &resultType=csv
ポートの指定は，標準とは異なる設定でインストールされている場合のみ必要
です。正しいポート番号についてはシステム管理者に問い合わせてください。
標準のリターン型は HTML です。resultType=csv が指定されている場合は，
CSV 形式のファイルが返されます。
クエリの作成の詳細については，15 ページ「サンプル・クエリの作成」を参照
してください。
戻りデータ
要求の送信元がブラウザか Web Service かに関係なく，要求に対しては同じ
データが返されます。Web Service の場合，データは戻りオブジェクト内に存在
します。ブラウザの場合は，応答自体に含まれています。
Web Service の戻りオブジェクト
Web Service の戻りオブジェクトには，次の情報が含まれています。
➤ retval : データまたはエラー・メッセージです。
➤ errorCode : エラー・コード（int 型）です。エラー・コードの種類は次のとお
りです。
➤ 0 - 成功
6
第 1 章 • Generic Data Engine API での作業
➤ 100 - 認証エラー
➤ 101 - 処理エラー
➤ 102 - Open API が無効
➤ origRowCount : クエリが本来返すはずの実際の行数（int 型）です。返される
行数が上限を超えている場合，origRowCount フィールドは，行数が上限を超
えなかった場合にクエリが返すはずだった実際の行数にセットされます。
Web ブラウザの場合の応答
クエリがブラウザから送信される場合，応答の CSV または HTML には，デー
タが格納されるか，またはエラー・コードとメッセージが格納されます。返さ
れる行数が上限を超える場合，戻りデータの最後の行は「Returned X of Y
rows」となります。X は返された行数を，Y はクエリの条件を満たす，実際の
行数をそれぞれ表します。エンジン・レベルでエラーが存在する場合は，
HTTP の成功コードが返されますが，応答の本体は <error code>, <error message>
となります。
返される行数の上限の設定
返される行数は，Infrastructure Settings Manager で設定できます。
［管理］＞［プラッ
トフォーム］＞［セットアップと保守］＞［インフラストラクチャ設定］＞
［ファウンデーション］＞［Generic Data Engine Open API］を選択します。
7
7
第 1 部 • データ API での作業
8
第2章
OpenAPI クエリ・ビルダ
Mercury Managed Services のお客様へ：本項は，Mercury Managed Services のお
客様には適用されません。
本章では，OpenAPI クエリ・ビルダを使用して Generic Data Engine API クエリ
を作成する方法について説明します。
本章の内容
ページ
OpenAPI クエリ・ビルダについて
10
OpenAPI クエリ・ビルダによるクエリの作成
11
9
第 1 部 • データ API での作業
OpenAPI クエリ・ビルダについて
OpenAPI クエリ・ビルダは，クエリの作成を補助する Web インタフェースで
す。作成したクエリは Web ブラウザを使用して，Mercury Business Availability
Center プロファイル・データベースからデータを抽出する Generic Data Engine
に送信できます。
OpenAPI クエリ・ビルダへのアクセス
OpenAPI クエリ・ビルダは，次の Mercury Business Availability Center アプリ
ケーションの［ユーザレポート］タブからアクセスできます。
➤ サービス・レベル管理
➤ エンド・ユーザ管理
➤ システム可用性管理
上記のアプリケーションで OpenAPI クエリ・ビルダにアクセスするには，
［ユーザレポート］を選択し，［OpenAPI クエリビルダ］をクリックします。
権限
［OpenAPI クエリビルダ］ページは，ユーザに Administrator または Superuser の
権限がなければアクセスできません。
Generic Data Engine API を使用するデータにアクセスするクエリの場合，クエリ
によって渡されるユーザ名とパスワードのパラメータは，System Viewer または
Superuser のいずれかの権限を持つユーザのものでなければなりません（［権限
管理］での権限の設定に関する詳細については，『プラットフォームの管理』
の「ユーザ権限の設定」を参照してください）。OpenAPI クエリ・ビルダを使
用してクエリを作成する場合，現在のユーザのユーザ名とパスワードのパラ
メータがクエリの URL に自動的に追加されます。このため，現在のユーザが
System Viewer または Superuser ではない場合，クエリ内のログインパラメータ
を System Viewer または Superuser のものに修正する必要があります。修正しな
い場合，クエリに対する応答は認証エラーとなります。
10
第 2 章 • OpenAPI クエリ・ビルダ
OpenAPI クエリ・ビルダによるクエリの作成
ここでは，OpenAPI クエリ・ビルダを使用して，Web ブラウザから Generic
Data Engine API に送信可能なクエリを作成する方法について説明します。
1 データベースから抽出するデータについて，時間の範囲と粒度を選択します。
時間範囲セレクタ・バーを使用して，データを抽出する時間範囲を指定します。
たとえば昨日のデータを 1 時間単位でグループ化するなど，指定した粒度設定
に基づいて戻りデータをグループ化する場合は，粒度を設定し，次に［指定さ
れた粒度ごとの戻りデータ］を選択します。
時間範囲セレクタ・バーの使用方法の詳細については，
『アプリケーションを使
用した作業』の「時間範囲と精度の選択」を参照してください。
2 データベースから抽出するデータのタイプを選択します。
［サンプルタイプ］リストから，データのサンプル・タイプを選択します。使
用可能なサンプル・タイプの詳細については，『参照情報』の「サンプル」を
参照してください。
3 選択したサンプル・タイプについて，データベースから抽出するデータ・
フィールドを選択し，データに対して実行する関数を選択します。サンプル・
タイプごとの使用可能なデータ・フィールドの詳細については，『参照情報』
の「サンプル」を参照してください。
ヒント：クエリにフィールドを追加する場合は，返される出力で左から右へと
データ・カラムを表示したい順番でデータ・フィールドを選択していきます。
a［フィールド名］リストから，データ・フィールドを選択します。
b 該当する場合は，［関数］リストから，データに対して適用する関数を選択
します。たとえば，平均応答時間を返す場合，［フィールド名］リストから
［Response Time］を選択し，［関数］リストから［AVG］を選択します。
サポートされている関数の詳細については，16 ページ「サポートされてい
る SQL 構文」を参照してください。
11
11
第 1 部 • データ API での作業
c 必要な場合は，［別名］ボックスで，適用する関数に合うようフィールドの
別名を修正します。たとえば，［関数］リストから［AVG］を選択した場
合，別名を「Avg Response Time」のように修正します。
d［追加］をクリックして，クエリにデータ・フィールドを追加します。
e クエリにデータ・フィールドが追加された後，必要に応じて，［返すフィー
ルド］テーブルに示されているフィールドの別名とフィールド式を編集でき
ます。たとえば，返される応答時間の単位を「ミリ秒」ではなく，「秒」で
表示する場合は，［Response Time］のフィールド式である dResponseTime
を dResponseTime / 1000 に編集します。
f クエリを追加する各データ・フィールドについて，上記の手順を繰り返します。
g 必要に応じて［削除］ボタンをクリックし，クエリからデータ・フィールド
を削除します。
4 抽出されたデータにフィルタを適用します。
ヒント：［プレビュー］をクリックして，返された結果すべてを確認してから
フィルタを適用してください。戻り値の数を制限するには，短めの時間範囲を
選択します。
a［フィルタ］をクリックして，クエリによって抽出されるデータにフィルタ
を適用します。
b［フィールド］リストから，フィルタを適用するフィールドを選択します。
たとえば，［Profile Name］を選択して，データベース内のすべてのプロ
ファイルではなく，特定のプロファイルについてのみデータを返すようクエ
リにフィルタを適用したり，［Response Time］を選択して，すべての応答
時間ではなく，指定した応答時間より長い，または短い応答時間のみ返すよ
うクエリにフィルタを適用したりします。
12
第 2 章 • OpenAPI クエリ・ビルダ
c［オペレータ］リストで，必要な演算子を選択します。サポートされている
演算子の詳細については，16 ページ「サポートされている SQL 構文」を参
照してください。
注：LIKE 演算子は，［Profile Name］フィールドでは機能しません。
d［値］ボックスに，必要な値を入力します。たとえば，トランザクション名で
クエリをフィルタリングする場合は，特定のトランザクションを指定します。
LIKE 演算子を使用する場合，ワイルドカード文字（*）を使用して，たとえ
ば「*westcoast*」という値を指定し，
「westcoast」という文字列が名前に含
まれているすべてのトランザクションを返すようにすることができます。
注：スペースまたは特殊文字を含む文字列（例 : where bb_guid IN (a b, c)）
をフィルタとして定義する場合，文字として扱うスペースや特殊文字が含ま
れている部分の前後を引用記号で囲む必要があります（where bb_guid IN
(‘a b’, c)）。特殊文字とは，数字，アルファベット，および「_」
，「$」，
「#」
以外の文字を指します。
e［追加］をクリックして，［追加］フィルタを追加します。［OR 式の追加］
をクリックして，［Or］フィルタを追加します。
f すべてのフィルタを定義したら，［OK］をクリックします。
g 必要な場合は，OpenAPI クエリ・ビルダのメイン・ページの［すべてクリ
ア］をクリックして，フィルタ文字列をクリアします。
5 表示オプションを選択します。
➤［次のタイムゾーンの結果を返す］リストから，データの表示に使用するタ
イム・ゾーンを選択します。
➤［結果形式］リストで，返されるデータの形式を HTML または CSV から選
択します。
13
13
第 1 部 • データ API での作業
6 クエリの内容を確認します。
➤［プレビュー］をクリックして，クエリが返すデータのプレビューを確認し
ます。
➤［クエリを表示］をクリックして，クエリの URL を確認します。
➤［クリア］をクリックすると，クエリをクリアして，はじめからやり直すこ
とができます。
7 クエリを実行します。
a［クエリを表示］をクリックして，クエリの URL を確認します。
b クエリの URL をコピーし，Web ブラウザのアドレス・ボックスに貼り付け
て，クエリを実行します。
選択した結果フォーマットによって，結果のデータは，Web ブラウザの
ウィンドウに表示されるか，または CSV 形式のファイルとして返されます。
CSV 形式のファイルは必要に応じて保存できます。
ヒント：OpenAPI クエリ・ビルダを使用して作成したクエリは保存できないた
め，作成したクエリの URL をファイルに保存してください。
14
第3章
サンプル・クエリの作成
本章では，Mercury Business Availability Center プロファイル・データベースから
データを抽出する Generic Data Engine API が使用するクエリを手作業で作成す
る方法について説明します。
本章の内容
ページ
Generic Data Engine で使用するクエリ
16
Generic Data Engine クエリの例
20
従来のクエリ
21
15
第 1 部 • データ API での作業
Generic Data Engine で使用するクエリ
Generic Data Engine は，Mercury Business Availability Center のコンポーネントで，
サンプルが仮想データベース・テーブルとして表示されたり，サンプル・
フィールドが仮想データベース・テーブル・フィールドとして表示されるよ
う，サンプルのインタフェースを作成します。このコンポーネントでは，SQL
を使用してサンプルに対してクエリを実行できます。このクエリは，Web
Service と使用したり，カスタマイズした Excel レポートの作成に使用したりで
きます。
詳細については，以下を参照してください。
➤ 第 1 章「Generic Data Engine API での作業」
➤ 第 2 章「OpenAPI クエリ・ビルダ」
➤『参照情報』の「サンプル」
➤『アプリケーションを使用した作業』の「Mercury Business Availability Center へ
の Microsoft Excel レポートの統合」
サポートされている SQL 構文
サポートされている言語は，SQL のサブセットです。次のキーワード，修飾
子，演算子をサポートしています。
➤ SELECT
➤ WHERE
➤ FROM
➤ TOP
➤ HAVING
➤ AS キーワード（別名の指定）
➤ 論理演算子（OR, AND, NOT）
➤ DISTINCT 修飾子
➤ IN 演算子。IN 演算子の値を返すために内部選択を使用できます。
➤ BETWEEN 演算子
➤ IS NULL（IS NOT NULL はサポートされていません）
16
第 3 章 • サンプル・クエリの作成
➤ LIKE。ワイルドカード文字はアスタリスク（*）を使用します。パーセント記
号（%）は使用しないでください。「LIKE *」のように，アスタリスクのみを使
用することはできません。アスタリスクはほかの文字と組み合わせて使用して
ください。
➤ 比較演算子 : =，IS，!=，<>，>，>=，<，<=
➤ 関数 : MAX，MIN，SUM，COUNT，AVG，STDDEV，SUMOFSQR，LOG，
CEIL，FLOOR，MOD，SQRT，REPLACENULL，IF，および「byTime 関数」
（19 ページ）で紹介されている関数。
➤ ORDER BY および修飾子の ASC と DESC
制限事項
サービスに送信するクエリには，次の制限事項が適用されます。
➤ 括弧を使用した SELECT 句内での複合式はサポートされていません。たとえ
ば，「(a+b)/c」のようには指定できません。関数の引数における括弧の使用はサ
ポートされています（例 : max(a+b)）。
➤ 1 個のクエリで選択できるモニタ・タイプは 1 つだけです。
➤ アスタリスク（*）はワイルドカード文字としてはサポートされていません
（LIKE 演算子と組み合わせて使用する場合は除く）。アスタリスクは，乗法演
算子としてサポートされています。
➤ 内部選択と結合はサポートされていません（例外 : IN 句において値を返す内部
選択）。
➤ ORDER BY 句では，たとえば「ORDER BY 1」のように，カラム番号が必要で
す。ORDER BY カラム名はサポートされていません。
➤ Generic Data Engine では，WHERE 句による時間制限がクエリに含まれている必
要があります。
➤ GROUP BY 句はサポートされていません。Generic Data Engine では，集計関数
が含まれないすべてのフィールドが GROUP BY フィールドとして扱われるた
め，GROUP BY 句は必要ありません。
➤ スペースまたは特殊文字を含む文字列（例 : where bb_guid IN (a b, c)）をフィル
タとして定義する場合，文字として扱うスペースや特殊文字が含まれている部分
の前後を，引用記号で囲む必要があります（where bb_guid IN (‘a b’, c)）
。特殊
文字とは，数字，アルファベット，
「_」
，
「$」
，
「#」以外の文字を指します。
17
17
第 1 部 • データ API での作業
➤ 返されたデータのカラムには，Column 0，Column 1 のように，順次ラベルが
付きます。わかりやすいラベルが返されるようにするには，SQL の AS 演算子
を使用します。たとえば，「Select time_stamp as TimeStamp」のようにしま
す。この例のように AS 演算子を使用した場合，カラムのラベルは
「TimeStamp」となります。
日付・時刻の値
クエリおよび戻りデータに含まれる日時は，1970 年 1 月 1 日以降の日時が秒単位
で指定されます。日時の値を理解するには，Microsoft Excel が参考になります。
時刻は，タイム・スタンプ・フィールドでもっとも一般的に使用されています。
クエリ内で使用する GMT 時間を取得するには，日付形式のセルに日付と時刻
を入力し，標準形式の別のセルに次の式を入力します。
=(<date cell> - 25569 ) * 86400
ローカルのタイム・ゾーンを修正するには，上記の結果にタイム・ゾーンのオ
フセット時間である 3,600 秒を加算します。たとえば，中央ヨーロッパ時間
（GMT + 2）の場合は，次のようになります。
=(<date cell> - 25569 ) * 86400 + ( 2 * 3600 )
Excel を使用してクエリ結果の時間の値を GMT の日付で表示するには，セルの
形式を日付形式にして，次の式を入力します。
=<time stamp> / 86400 + 25569
ローカルのタイム・ゾーンを修正するには，タイム・ゾーンのオフセット時間
である 3,600 秒をタイム・ゾーンから減算します。たとえば，米国東部の標準
時（GMT - 3）の場合，次の式で算出します。
=(<time stamp> - ( -3 * 3600 ) )/ 86400 + 25569
18
第 3 章 • サンプル・クエリの作成
byTime 関数
Generic Data Engine SQL では，時間で区切ってグループ化されたデータを返す，
byTime 関数をサポートしています。たとえば，過去 1 日のトランザクションに
おける平均応答時間を返すクエリを作成する場合，byTime 関数を使用しない場
合は 1 個の値が返されます。byTime 関数を使用すると，過去 1 日のトランザク
ションの平均応答時間を 1 時間単位で要求することができ，この場合，過去 24
時間の 1 時間ごとに値が返されます。
関数の構文は次のとおりです。
byTime(<timefield >, <step value>, <number of step>, <offset>)
引数
説明
timefield
通常はタイム・スタンプ・フィールドです。
step value
次のいずれかになります。
-1 - 時間の設定なし
10 - 秒
20 - 分
30 - 時
40 - 日
50 - 週
60 - 月
70 - 月
80 - 年
number of step
offset
グループの単位として，step value で指定される，
単位の数です。
GMT を基準としたタイム・ゾーンのオフセット時間
（単位時）です。正の数値は，GMT の東側のタイム・
ゾーンを表します。負の数値は，GMT の西側のタイ
ム・ゾーンを表します。
たとえば，GMT から 2 時間東側に移動し，3 日ごとに 1 つの値を返すには次の
ように指定します。
byTime(time_stamp, 40, 3, 2)
19
19
第 1 部 • データ API での作業
設定
Generic Data Engine Open API のオプションは，［管理］＞［プラットフォーム］
＞［セットアップと保守］＞［インフラストラクチャ設定］＞［ファウンデー
ション］＞［Generic Data Engine Open API］を選択して表示される画面で設
定できます。返されるデータの行数の最大値を設定できます。また，Generic
Data Engine Open API の使用を無効にできます。
Generic Data Engine クエリの例
ここでは，データベースからさまざまなタイプのデータを取得するクエリ URL
の例を示します。
ss_t サンプルの例
この例は，指定された測定項目とモニタについて，SiteScope のサンプルの平均
値を取得する場合を示します。
http://myServer/topaz/gdeopenapi/GdeOpenApi?method=getData&user=admin
&password=admin&query=select szMeasurementName, szMonitorName,
avg(dValue) from ss_t where u_iStatus=1 and time_stamp > 123456 and
szMeasurementName = ‘myMeasurmentName’ and szMonitorName =
‘myMonitorName’
trans_t サンプルの例
この例は，Springfield_Location というプロファイルに含まれる
Springfield_infra_ems_login というトランザクションにおいて，指定した期間
の BPM データについて，GMT へのオフセットが +3 で，分単位でグループ化
された平均応答時間を取得する場合を示します。
http://myServer/topaz/gdeopenapi/GdeOpenApi?method=getData&user=admin
&password=admin&query=select byTime(time_stamp, 20, 1, 3.0), profile_name
as ProfileName, szTransactionName as TransactionName,
AVG(dResponseTime) from trans_t where time_stamp>=1126594800.64 and
time_stamp<1126596000.64 and profile_name='Springfield_Location' and
szTransactionName='Springfield_infra_ems_login'
20
第 3 章 • サンプル・クエリの作成
rum_server_t サンプルの例
この例は，指定したサーバに対する処理が失敗した日における，すべての
rum_server_t サンプルのリストを取得する場合を示します。
http://myServer/topaz/gdeopenapi/GdeOpenApi?method=getData&user=admin
&password=admin&query=select time_stamp, engine_name, server_name from
rum_server_t where availability=0 and total_hits > 0 and time_stamp >
1041379200 and time_stamp < 1136197020 and server_name =
‘myServerName’
rum_page_t サンプルの例
この例は，各 URL について，RUM により測定される合計サーバ時間を取得す
る場合を示します。
http://myServer/topaz/gdeopenapi/GdeOpenApi?method=getData&user=admin
&password=admin&query=select page_url, sum(tot_server_time) from
rum_page_t where time_stamp > 1041379200 and time_stamp < 1136197020
&resultType=csv
従来のクエリ
Mercury Business Availability Center version 6.0 より，サンプルに対して直接 SQL
クエリを記述できるようになりました。サンプルは仮想データベース・テーブ
ルとして機能します。詳細については，16 ページ「Generic Data Engine で使用
するクエリ」を参照してください。これまでのレポートを維持するには，本項
の情報を利用してください。
クエリの構造
クエリは OpenAPI.jsp の URL から始まります。
http:// ＜サーバ名＞ /topaz/openapi/OpenAPI.jsp
この後に，一連のクエリ（parameter=value のペア）が続きます。ペアとペア
は，アンパサンド（&）で区切ります。クエリは，必須パラメータと任意パラ
メータを使用して作成します。
フィルタ・パラメータを追加することもできます。詳細については，32 ページ
「フィルタのパラメータ」を参照してください。
21
21
第 1 部 • データ API での作業
➤ 必須パラメータ : 必ず指定する必要のあるパラメータは次のとおりです。
22
username
クエリを実行する Mercury Business Availability Center のユーザ名です。
password
クエリを実行する Mercury Business Availability Center のユーザのパ
スワードです。
function
受信するデータのタイプです。次のいずれかになります。
transactions : ビジネス・プロセス・モニタの応答時間データです。
transactions_breakdown : ビジネス・プロセス・モニタのトランザ
クション・ブレークダウン・データです。
sitescope : SiteScope の測定データです。
routings : WebTrace ルーティング・データです。
hops : WebTrace のホップ数データです。
transactions_error : ビジネス・プロセス・モニタのトランザク
ション・エラー・データです。
alerts : ビジネス・プロセス・モニタの警告データです。
components_breakdown : ビジネス・プロセス・モニタのコンポー
ネント・ブレークダウン・データです。
rowDataType
使用する集計のタイプです。次のいずれかになります。
row : 未処理のデータです。
hour : 1 時間単位の集計データです。
day : 1 日単位の集計データです。
集計のタイプは，任意パラメータである stepValueType で指定し
たものを上回る単位は指定できません。
第 3 章 • サンプル・クエリの作成
profileIds
データを取得するプロファイルの ID です。複数の ID を指定する
場合はカンマ（,）で区切ります。たとえば，「profileIds=2,7,9」の
ように指定します。
データベースからプロファイルの ID を取得するには，次の手順を
実行します。
1 Web ブラウザで
http:// ＜サーバ名＞ :8080/jmx-console/index.jsp のページを開き
ます。＜サーバ名＞は，Mercury Business Availability Center
サーバの名前を表します。
2［Topaz］リストで，［service=OAPI Services］リンクをクリッ
クします。
3 com.mercury.infra.db.tools.oapiservices.ProfileMapping
getProfiles() を呼び出して，プロファイル ID 情報を取得します。
Time range
from/to
または
lastPeriod
のいずれか
from/to を使用して期間の始まりと終わりを指定するか，
lastPeriod を使用して，クエリが呼び出されて以降の期間を指定
します。
from/to のフォーマットは dd/MM/yyyy HH:mm:ss です。
lastPeriod は次のいずれかになります。
hour
day
week
month
quarter
year
lastPeriod の単位を超える値を指定するには，lastPeriod と一緒
に numStepUnit を使用します。
➤ 任意パラメータ : 必要に応じて指定するパラメータは次のとおりです。
numStepUnit
lastPeriod と一緒に使用し，データに含まれる期間の数を示し
ます。たとえば，過去 2 日間のデータを取得するには次のよう
に指定します。
lastPeriod=day&numStepUnit=2
resultType
出力ファイルの形式です。次のいずれかになります。
html
xml
csv
標準設定は html です。
23
23
第 1 部 • データ API での作業
24
stepValueType
データをグループ化する時間の単位です。次のいずれかになり
ます。
minute
hour
day
week
month
stepValueType は，rowDataType で指定した単位よりも大き
い単位でグループ化する場合に，stepValue と組み合わせて使
用します。
stepValue
stepValueType で指定した時間単位の数です。この数でデー
タをグループ化します。たとえば，
stepValueType=hour&stepValue=8
の場合，8 時間単位でデータがグループ化されます。
標準設定は 1 です。
dateFormat
データ値出力のフォーマット，すなわちレポート内における日
付と時刻の表示形式です。たとえば，次のようになります。
MM/dd/yyyy%20HH:mm:ss
%20 はスペースを表します（スペースは ASCII 文字の番号は
32 で，これを 16 進法で表すと 20 となります）。
timeZone
タイム・ゾーンの指定です。フォーマットは &timezone=< 以
下のタイム・ゾーン・リストに示されたタイム・ゾーン値 > で
す。たとえば，次のように指定します。
&timezone=Europe/London
第 3 章 • サンプル・クエリの作成
タイム・ゾーンのリスト
ACT
Antarctica/McMurdo
Etc/GMT0
AET
Antarctica/Palmer
Etc/Greenwich
AGT
Antarctica/Rothera
Etc/UCT
ART
Antarctica/South_Pole
Etc/UTC
AST
Antarctica/Syowa
Etc/Universal
Africa/Abidjan
Antarctica/Vostok
Etc/Zulu
Africa/Accra
Arctic/Longyearbyen
Europe/Amsterdam
Africa/Addis_Ababa
Asia/Aden
Europe/Andorra
Africa/Algiers
Asia/Almaty
Europe/Athens
Africa/Asmera
Asia/Amman
Europe/Belfast
Africa/Bamako
Asia/Anadyr
Europe/Belgrade
Africa/Bangui
Asia/Aqtau
Europe/Berlin
Africa/Banjul
Asia/Aqtobe
Europe/Bratislava
Africa/Bissau
Asia/Ashgabat
Europe/Brussels
Africa/Blantyre
Asia/Ashkhabad
Europe/Bucharest
Africa/Brazzaville
Asia/Baghdad
Europe/Budapest
Africa/Bujumbura
Asia/Bahrain
Europe/Chisinau
Africa/Cairo
Asia/Baku
Europe/Copenhagen
Africa/Casablanca
Asia/Bangkok
Europe/Dublin
Africa/Ceuta
Asia/Beirut
Europe/Gibraltar
Africa/Conakry
Asia/Bishkek
Europe/Helsinki
Africa/Dakar
Asia/Brunei
Europe/Istanbul
Africa/Dar_es_Salaam
Asia/Calcutta
Europe/Kaliningrad
Africa/Djibouti
Asia/Choibalsan
Europe/Kiev
Africa/Douala
Asia/Chongqing
Europe/Lisbon
Africa/El_Aaiun
Asia/Chungking
Europe/Ljubljana
25
25
第 1 部 • データ API での作業
26
Africa/Freetown
Asia/Colombo
Europe/London
Africa/Gaborone
Asia/Dacca
Europe/Luxembourg
Africa/Harare
Asia/Damascus
Europe/Madrid
Africa/Johannesburg
Asia/Dhaka
Europe/Malta
Africa/Kampala
Asia/Dili
Europe/Minsk
Africa/Khartoum
Asia/Dubai
Europe/Monaco
Africa/Kigali
Asia/Dushanbe
Europe/Moscow
Africa/Kinshasa
Asia/Gaza
Europe/Nicosia
Africa/Lagos
Asia/Harbin
Europe/Oslo
Africa/Libreville
Asia/Hong_Kong
Europe/Paris
Africa/Lome
Asia/Hovd
Europe/Prague
Africa/Luanda
Asia/Irkutsk
Europe/Riga
Africa/Lubumbashi
Asia/Istanbul
Europe/Rome
Africa/Lusaka
Asia/Jakarta
Europe/Samara
Africa/Malabo
Asia/Jayapura
Europe/San_Marino
Africa/Maputo
Asia/Jerusalem
Europe/Sarajevo
Africa/Maseru
Asia/Kabul
Europe/Simferopol
Africa/Mbabane
Asia/Kamchatka
Europe/Skopje
Africa/Mogadishu
Asia/Karachi
Europe/Sofia
Africa/Monrovia
Asia/Kashgar
Europe/Stockholm
Africa/Nairobi
Asia/Katmandu
Europe/Tallinn
Africa/Ndjamena
Asia/Krasnoyarsk
Europe/Tirane
Africa/Niamey
Asia/Kuala_Lumpur
Europe/Tiraspol
Africa/Nouakchott
Asia/Kuching
Europe/Uzhgorod
Africa/Ouagadougou
Asia/Kuwait
Europe/Vaduz
Africa/Porto-Novo
Asia/Macao
Europe/Vatican
第 3 章 • サンプル・クエリの作成
Africa/Sao_Tome
Asia/Macau
Europe/Vienna
Africa/Timbuktu
Asia/Magadan
Europe/Vilnius
Africa/Tripoli
Asia/Makassar
Europe/Warsaw
Africa/Tunis
Asia/Manila
Europe/Zagreb
Africa/Windhoek
Asia/Muscat
Europe/Zaporozhye
America/Adak
Asia/Nicosia
Europe/Zurich
America/Anchorage
Asia/Novosibirsk
GB
America/Anguilla
Asia/Omsk
GB-Eire
America/Antigua
Asia/Oral
GMT
America/Araguaina
Asia/Phnom_Penh
GMT0
America/Aruba
Asia/Pontianak
Greenwich
America/Asuncion
Asia/Pyongyang
HST
America/Atka
Asia/Qatar
Hongkong
America/Barbados
Asia/Qyzylorda
IET
America/Belem
Asia/Rangoon
IST
America/Belize
Asia/Riyadh
Iceland
America/Boa_Vista
Asia/Riyadh87
Indian/Antananarivo
America/Bogota
Asia/Riyadh88
Indian/Chagos
America/Boise
Asia/Riyadh89
Indian/Christmas
America/Buenos_Aires
Asia/Saigon
Indian/Cocos
America/Cambridge_Bay
Asia/Sakhalin
Indian/Comoro
America/Cancun
Asia/Samarkand
Indian/Kerguelen
America/Caracas
Asia/Seoul
Indian/Mahe
America/Catamarca
Asia/Shanghai
Indian/Maldives
America/Cayenne
Asia/Singapore
Indian/Mauritius
America/Cayman
Asia/Taipei
Indian/Mayotte
27
27
第 1 部 • データ API での作業
28
America/Chicago
Asia/Tashkent
Indian/Reunion
America/Chihuahua
Asia/Tbilisi
Iran
America/Cordoba
Asia/Tehran
Israel
America/Costa_Rica
Asia/Tel_Aviv
JST
America/Cuiaba
Asia/Thimbu
Jamaica
America/Curacao
Asia/Thimphu
Japan
America/Danmarkshavn
Asia/Tokyo
Kwajalein
America/Dawson
Asia/Ujung_Pandang
Libya
America/Dawson_Creek
Asia/Ulaanbaatar
MET
America/Denver
Asia/Ulan_Bator
MIT
America/Detroit
Asia/Urumqi
MST
America/Dominica
Asia/Vientiane
MST7MDT
America/Edmonton
Asia/Vladivostok
Mexico/BajaNorte
America/Eirunepe
Asia/Yakutsk
Mexico/BajaSur
America/El_Salvador
Asia/Yekaterinburg
Mexico/General
America/Ensenada
Asia/Yerevan
Mideast/Riyadh87
America/Fort_Wayne
Atlantic/Azores
Mideast/Riyadh88
America/Fortaleza
Atlantic/Bermuda
Mideast/Riyadh89
America/Glace_Bay
Atlantic/Canary
NET
America/Godthab
Atlantic/Cape_Verde
NST
America/Goose_Bay
Atlantic/Faeroe
NZ
America/Grand_Turk
Atlantic/Jan_Mayen
NZ-CHAT
America/Grenada
Atlantic/Madeira
Navajo
America/Guadeloupe
Atlantic/Reykjavik
PLT
America/Guatemala
Atlantic/South_Georgia
PNT
America/Guayaquil
Atlantic/St_Helena
PRC
第 3 章 • サンプル・クエリの作成
America/Guyana
Atlantic/Stanley
PRT
America/Halifax
Australia/ACT
PST
America/Havana
Australia/Adelaide
PST8PDT
America/Hermosillo
Australia/Brisbane
Pacific/Apia
America/Indiana/Indianapolis Australia/Broken_Hill
Pacific/Auckland
America/Indiana/Knox
Australia/Canberra
Pacific/Chatham
America/Indiana/Marengo
Australia/Darwin
Pacific/Easter
America/Indiana/Vevay
Australia/Hobart
Pacific/Efate
America/Indianapolis
Australia/LHI
Pacific/Enderbury
America/Inuvik
Australia/Lindeman
Pacific/Fakaofo
America/Iqaluit
Australia/Lord_Howe
Pacific/Fiji
America/Jamaica
Australia/Melbourne
Pacific/Funafuti
America/Jujuy
Australia/NSW
Pacific/Galapagos
America/Juneau
Australia/North
Pacific/Gambier
America/Kentucky/Louisville Australia/Perth
Pacific/Guadalcanal
America/Kentucky/Monticello Australia/Queensland
Pacific/Guam
America/Knox_IN
Australia/South
Pacific/Honolulu
America/La_Paz
Australia/Sydney
Pacific/Johnston
America/Lima
Australia/Tasmania
Pacific/Kiritimati
America/Los_Angeles
Australia/Victoria
Pacific/Kosrae
America/Louisville
Australia/West
Pacific/Kwajalein
America/Maceio
Australia/Yancowinna
Pacific/Majuro
America/Managua
BET
Pacific/Marquesas
America/Manaus
BST
Pacific/Midway
America/Martinique
Brazil/Acre
Pacific/Nauru
America/Mazatlan
Brazil/DeNoronha
Pacific/Niue
29
29
第 1 部 • データ API での作業
30
America/Mendoza
Brazil/East
Pacific/Norfolk
America/Menominee
Brazil/West
Pacific/Noumea
America/Merida
CAT
Pacific/Pago_Pago
America/Mexico_City
CET
Pacific/Palau
America/Miquelon
CNT
Pacific/Pitcairn
America/Monterrey
CST
Pacific/Ponape
America/Montevideo
CST6CDT
Pacific/Port_Moresby
America/Montreal
CTT
Pacific/Rarotonga
America/Montserrat
Canada/Atlantic
Pacific/Saipan
America/Nassau
Canada/Central
Pacific/Samoa
America/New_York
Canada/East-Saskatchewan Pacific/Tahiti
America/Nipigon
Canada/Eastern
Pacific/Tarawa
America/Nome
Canada/Mountain
Pacific/Tongatapu
America/Noronha
Canada/Newfoundland
Pacific/Truk
America/North_Dakota/Center Canada/Pacific
Pacific/Wake
America/Panama
Canada/Saskatchewan
Pacific/Wallis
America/Pangnirtung
Canada/Yukon
Pacific/Yap
America/Paramaribo
Chile/Continental
Poland
America/Phoenix
Chile/EasterIsland
Portugal
America/Port-au-Prince
Cuba
ROK
America/Port_of_Spain
EAT
SST
America/Porto_Acre
ECT
Singapore
America/Porto_Velho
EET
SystemV/AST4
America/Puerto_Rico
EST
SystemV/AST4ADT
America/Rainy_River
EST5EDT
SystemV/CST6
America/Rankin_Inlet
Egypt
SystemV/CST6CDT
第 3 章 • サンプル・クエリの作成
America/Recife
Eire
SystemV/EST5
America/Regina
Etc/GMT
SystemV/EST5EDT
America/Rio_Branco
Etc/GMT+0
SystemV/HST10
America/Rosario
Etc/GMT+1
SystemV/MST7
America/Santiago
Etc/GMT+10
SystemV/MST7MDT
America/Santo_Domingo
Etc/GMT+11
SystemV/PST8
America/Sao_Paulo
Etc/GMT+12
SystemV/PST8PDT
America/Scoresbysund
Etc/GMT+2
SystemV/YST9
America/Shiprock
Etc/GMT+3
SystemV/YST9YDT
America/St_Johns
Etc/GMT+4
Turkey
America/St_Kitts
Etc/GMT+5
UCT
America/St_Lucia
Etc/GMT+6
US/Alaska
America/St_Thomas
Etc/GMT+7
US/Aleutian
America/St_Vincent
Etc/GMT+8
US/Arizona
America/Swift_Current
Etc/GMT+9
US/Central
America/Tegucigalpa
Etc/GMT-0
US/East-Indiana
America/Thule
Etc/GMT-1
US/Eastern
America/Thunder_Bay
Etc/GMT-10
US/Hawaii
America/Tijuana
Etc/GMT-11
US/Indiana-Starke
America/Tortola
Etc/GMT-12
US/Michigan
America/Vancouver
Etc/GMT-13
US/Mountain
America/Virgin
Etc/GMT-14
US/Pacific
America/Whitehorse
Etc/GMT-2
US/Pacific-New
America/Winnipeg
Etc/GMT-3
US/Samoa
America/Yakutat
Etc/GMT-4
UTC
America/Yellowknife
Etc/GMT-5
Universal
31
31
第 1 部 • データ API での作業
Antarctica/Casey
Etc/GMT-6
VST
Antarctica/Davis
Etc/GMT-7
W-SU
Antarctica/DumontDUrville Etc/GMT-8
WET
Antarctica/Mawson
Zulu
Etc/GMT-9
フィルタのパラメータ
クエリには 1 つの filters 句を記述できます。filters 句の記述は任意です。filters
句に複数のフィルタを指定する場合は，フィルタとフィルタをセミコロン（;）
で区切ります。
フィルタは，レポートのカラム名，フィルタ・タイプ，リストに含まれるパ
ターンの個数，およびパターンのリストで構成されます。フィルタ内の各要素
はセミコロン（;）で区切ります。
たとえば，次のように記述します。
filters=MonitorTitle;in;2;9,12;Measurement;in;1;18
は，次と同じ意味になります。
select where (MonitorTitle equals 9 or 12) and (Measurement equals 18)
次のフィルタ・パラメータを利用できます。
汎用フィルタ・タイプ
32
このタイプのフィルタは，数値カラム，テキスト・カラムのど
ちらでも使用できます。
in : パターンのリストの項目で等しいものがあれば，データが
レポートに含まれます。
not_in : パターンのリストの項目で等しいものがない場合，
データがレポートに含まれます。
第 3 章 • サンプル・クエリの作成
テキスト・フィルタ・
タイプ
このタイプのフィルタは，テキスト・カラムについて使用でき
ます。
like : パターンに一致すれば，データがレポートに含まれます。
like を使用する場合，リスト内のパターンの個数は 1 つでなけ
ればなりません。
ワイルドカード文字のアスタリスク（*）は like で使用できます。
たとえば，次のように使用します。
filters=Host Name;like;1;ServerNum*
数値フィルタ・タイプ
このタイプのフィルタは，数値カラムについて使用できます。
bigger
smaller
equals
クエリの例
例 1:
http:// ＜サーバ名＞ /topaz/openapi/OpenAPI.jsp?
username=fitzwilliam&password=darcy&function=transactions&profileIds=33&
lastPeriod=hour&rowDataType=raw&dateFormat=MM/dd/yyyy HH:mm:ss
例 2:
http:// ＜サーバ名＞ /topaz/openapi/OpenAPI.jsp?
username=fitzwilliam&password=darcy&function=transactions&profileIds=33&
from=10/12/2002 14:00:00&to=10/12/2002 15:00:00& rowDataType=raw&
dateFormat=MM/dd/yyyy%20HH:mm:ss
例 3:
http:// ＜サーバ名＞
/topaz/openapi/OpenAPI.jsp?username=fitzwilliam&password
=darcy&function=sitescope&profileIds=35&lastPeriod=day&numStepUnit=2&
&rowDataType=hour&dateFormat=MM/dd/yyyy%20HH:mm:ss&filters=
MonitorTitle;in;1;9;Measurement;in;1;18&stepValueType=hour&stepValue=6
33
33
第 1 部 • データ API での作業
34
第2部
Mercury Business Availability Center
EMS アダプタを使用した作業
第4章
Mercury Business Availability Center と EMS
統合の概要
Mercury Business Availability Center を，お使いの EMS アプリケーションと統合
する方法について説明します。警告を EMS に送信したり，EMS データをレ
ポートやダッシュボードで表示したりできます。
本章の内容
ページ
Mercury Business Availability Center と EMS の統合について
38
SiteScope を使用した Mercury Business Availability Center 内の EMS アプ
リケーション・データの統合
38
EMS アダプタの設定
39
37
第 2 部 • Mercury Business Availability Center EMS アダプタを使った作業
Mercury Business Availability Center と EMS の統合について
Mercury Business Availability Center によって，次のことが可能になります。
➤ Mercury Business Availability Center によって生成された警告を，お使いの EMS
コンソールへ統合すること。警告情報を EMS アプリケーションに送信できる
EMS 用アダプタを設定します。EMS アダプタの設定の詳細については，39
ページ「EMS アダプタの設定」を参照してください。
Mercury Managed Services のお客様へ：EMS アダプタの入手方法の詳細につい
ては，Mercury Managed Services サポートまでお問い合わせください。
➤ EMS ソフトウェアによって集められた SiteScope 内のデータを収集し，Mercury
Business Availability Center へ送信すること。SiteScope 統合の設定の詳細につい
ては，次の項を参照してください。
SiteScope を使用した Mercury Business Availability Center 内の
EMS アプリケーション・データの統合
SiteScope を使用して，お使いの EMS アプリケーションからのイベントやその
他の測定値を収集するモニタを作成します。そのデータが，SiteScope によって
Mercury Business Availability Center レポートやダッシュボードに送信されます。
統合モニタの使用の詳細については，『SiteScope モニタの設定』の「SiteScope
統合モニタの使用」を参照してください。
SiteScope モニタを実行するには，SiteScope のオプション・ライセンスが必要
になります。詳細については，Mercury カスタマー・サポートまでお問い合わ
せください。
38
第 4 章 • Mercury Business Availability Center と EMS 統合の概要
EMS アダプタの設定
本項では，お使いの環境の EMS アプリケーションに Mercury Business
Availability Center 警告を送信するための EMS アダプタの設定方法について説明
します。これらの警告は，EMS アプリケーションで使用される標準的な警告処
理プロシージャで利用できるようになります。
Mercury Business Availability Center 警告は次のアダプタを使って EMS アプリ
ケーションに送信できます。
➤ BMC PATROL アダプタ : 詳細については，第 5 章「BMC PATROL への Mercury
Business Availability Center 警告の送信」を参照してください。
➤ CA Unicenter アダプタ : 詳細については，第 6 章「CA Unicenter への Mercury
Business Availability Center 警告の送信」を参照してください。
➤ HP Openview VantagePoint Operations（OVO）アダプタ : 詳細については，第 7 章
「HP Openview VantagePoint Operations への Mercury Business Availability Center 警
告の送信」を参照してください。
➤ IBM Tivoli Enterprise Console（TEC）アダプタ : 詳細については，第 8 章「Tivoli
TEC への Mercury Business Availability Center 警告の送信」を参照してください。
注：Mercury Business Availability Center で警告を定義する際は，警告ウィザード
にアクセスします。［管理］＞［プラットフォーム］＞［警告と受信者］＞
［警告］を選択します。『プラットフォームの管理』の「警告スキームの作成」
の手順に従って，警告を作成します。
39
39
第 2 部 • Mercury Business Availability Center EMS アダプタを使った作業
40
第5章
BMC PATROL への Mercury Business
Availability Center 警告の送信
本章では，BMC PATROL に警告を送信するための Mercury Business Availability
Center の設定方法について説明します。
本章の内容
ページ
BMC PATROL への Mercury Business Availability Center 警告の送信につ
いて
42
Mercury Business Availability Center SNMP アダプタの BMC PATROL
エージェントへのインストール
42
インストールのトラブルシューティング
43
41
第 2 部 • Mercury Business Availability Center EMS アダプタを使った作業
BMC PATROL への Mercury Business Availability Center 警告の
送信について
警告の送信先となる BMC PATROL エージェントに Mercury Business Availability
Center SNMP アダプタをインストールします。次に，コア・サーバによって生
成される SNMP トラップを BMC PATROL エージェントに対して指定します。
SNMP トラップの送信の詳細については，『プラットフォームの管理』の 239
ページ「警告トリガ時の SNMP トラップの送信」を参照してください。
BMC PATROL ドメインのすべての BMC PATROL エージェントに対して SNMP
アダプタをインストールする必要はありません。ドメインに付き 1 エージェン
トで十分です。ただし，より高い可用性を得るために，必要に応じて，複数の
エージェントに SNMP アダプタをインストールすることもできます。
Mercury Business Availability Center SNMP アダプタの BMC
PATROL エージェントへのインストール
SNMP アダプタはインストールすると，Mercury Business Availability Center から
の警告（SNMP トラップの形式）を受信し，それを SNMP アダプタが動作する
BMC PATROL エージェントのイベント管理エンジンへ転送します。
Mercury Business Availability Center アダプタを BMC PATROL にインストール
するには，次の手順で行います。
1 Mercury Business Availability Center SNMP Adapter Knowledge Module
（TOPAZ_SNMP_ADAPTER.km）を，BMC PATROL コンソールおよび BMC
PATROL エージェントの両方の知識モジュールの場所にコピーします。
TOPAZ_SNMP_ADAPTER.km は，Adapter ファイルに含まれています。この
ファイルは，Mercury Business Availability Center 6.1 Japanese Documentation and
Utilities CD-ROM の \tools_and_utilities\EMS\BmcPatrol\TSA フォルダにあり
ます。いったん知識モジュールが BMC PATROL にロードされると，BMC
PATROL Developer Console から TOPAZ_SNMP_ADAPTER.km にアクセスできる
ようになります。
2 BMC PATROL Developer Console を使用して，Mercury Business Availability Center
SNMP アダプタを BMC PATROL エージェントにロードします。詳細について
は，BMC PATROL のマニュアルを参照してください。
42
第 5 章 • BMC PATROL への Mercury Business Availability Center 警告の送信
インストールのトラブルシューティング
BMC PATROL エージェントが，次のシステム・メッセージを出力する
（左側の数字は異なる場合があります）。
20040502153419 SNMP NOT ACTIVE.
SNMP トラップ・サービスが，SNMP アダプタがインストールされた BMC
PATROL エージェントで有効になっていません。そのエージェントで SNMP
Trap サービスを有効にするか，別の BMC PATROL エージェントを使用します。
BMC PATROL エージェントでの SNMP トラップ・サービスのインストールおよ
び有効化の詳細については，BMC PATROL のマニュアルを参照してください。
BMC PATROL エージェントが，次のシステム・メッセージを出力する
（左側の番号は異なる場合があります）。
20040502154044 SnmpListener, Line# 130:snmp_trap_listen:cannot
open socket for listening
20040502154044 Listen status = ERR, Errno = 94.
別の SNMP トラップ・サービスが SNMP トラップ・ポートを使用しています。
そのサービスを無効にするか，トラップの受信に使用される UDP ポートを変
更します（その場合，Mercury Business Availability Center を再設定する必要があ
ります）。
BMC PATROL エージェントが，次のシステム・メッセージを出力する
（左側の数字は異なる場合があります）
。
20040502154044 Error:Can't recognize Alert Type Id X（X は番号です）
。
Mercury Business Availability Center SNMP アダプタが，有効な Mercury Business
Availability Center 警告として認識されていない SNMP トラップを受信していま
す。これは正しい動作です。
注：テストの目的で，補助 SNMP トラップの処理を有効にする場合があります。
これを行うには，KM 環境変数 RAW_DATA を TRUE に変更してください。
43
43
第 2 部 • Mercury Business Availability Center EMS アダプタを使った作業
44
第6章
CA Unicenter への Mercury Business
Availability Center 警告の送信
本章では，警告を CA Unicenter に送信するための Mercury Business Availability
Center の設定方法について説明します。
本章の内容
ページ
CA Unicenter への Mercury Business Availability Center 警告の送信について
46
Mercury Business Availability Center 警告を SNMP トラップとして送信する
46
Unicenter cawto コマンドを使用して Mercury Business Availability Center
警告を送信する
48
設定に関するトラブルシューティング
50
45
第 2 部 • Mercury Business Availability Center EMS アダプタを使った作業
CA Unicenter への Mercury Business Availability Center 警告の
送信について
CA Unicenter アプリケーションに警告を送信するには，次のいずれかの方法で
行うことができます。
➤ Unicenter Management サーバへ Mercury Business Availability Center 警告を SNMP
トラップとして送信する
➤ Unicenter cawto コマンドを使用して Mercury Business Availability Center 警告を送
信する
SNMP トラップの指定に関する詳細については，『プラットフォームの管理』
の「警告トリガ時の SNMP トラップの送信」を参照してください。
Mercury Business Availability Center 警告を SNMP トラップと
して送信する
イベント管理ホストに送信された SNMP トラップを取り出すように Unicenter
を設定する手順について説明します。
Unicener の設定は，次の手順で行います。
1 未処理の SNMP トラップを取り出すよう，Unicenter CATrapD（SNMP トラッ
プ・デーモン）を有効にします。
2 イベント管理（メッセージ・レコードとアクション）を設定して，Mercury
Business Availability Center MIB に従ってトラップをフォーマットします。この
作業では，コア・サーバ・インストール環境に含まれる Mercury Business
Availability Center MIB の知識が必要になります。このファイルは，Mercury
Business Availability Center 6.1 Japanese Documentation and Utilities CD-ROM の
\tools_and_utilities\SNMP_MIBS\amAlerts5.mib にあります。
管理サーバのホストを設定するには，次の手順で行います。
Mercury Business Availability Center によって送信される SNMP トラップに合わせ
てメッセージ・レコードを作成する必要があります。
46
第 6 章 • CA Unicenter への Mercury Business Availability Center 警告の送信
1 [file name].def ファイルを作成し，そのファイル内に次の行を保存します。
define msgrec msgid="%CATD_I_060, SNMPTRAP:-c * 5233 * * 6 1 * *"
type="MSG" msgnode="*" desc="AM Alert Transaction Response Time"
cont='N' msgact='Y' wcsingle='?'wcmany='*' case="y" regexp="n"
2 次のコマンドを使用して，［イベント管理］内のメッセージ・レコードの一部
としてファイルを読み込みます。
cautil -f [ ファイル名 ].def
oprcmd opreload
3 Unicenter イベント・コンソールのサードパーティ製のデバイスから，SNMP ト
ラップを受け取って表示するには，SNMP トラップ・サービスを有効にしてお
く必要があります。［Unicenter Enterprise Management］＞
［Configuration］＞［Settings］の順に選択します。［SNMP Trap Server
Activated］フラグを［Yes］に変更します。
Mercury Business Availability Center を設定するには，次の手順で行います。
1 Unicenter イベント管理ホストに送信される警告を設定するには，警告ウィザー
ドにアクセスします。［管理］＞［プラットフォーム］＞［警告と受信者］＞
［警告］の順に選択します。
2『プラットフォームの管理』の 196 ページ「警告スキームの作成」に示す手順に
従って警告を作成します。
3［SNMP トラップの送信］チェック・ボックスを選択し，EMS IP を定義しま
す。詳細については，『プラットフォームの管理』の 239 ページ「警告トリガ
時の SNMP トラップの送信」を参照してください。
47
47
第 2 部 • Mercury Business Availability Center EMS アダプタを使った作業
Unicenter cawto コマンドを使用して Mercury Business
Availability Center 警告を送信する
Mercury Managed Services のお客様へ：この手順は，Mercury Managed Services
をお使いのお客様には該当しません。Mercury Managed Services をお使いのお客
様は，SiteScope コマンド・ライン・モニタを使用してください。このモニタの
使用については，Mercury Managed Services サポートにお問い合わせください。
このコマンド・ライン・ユーティリティは，Unicenter イベント管理エージェン
トを Mercury Business Availability Center マシンにインストールした後で使用可
能です。
注：cawto コマンドを使用すれば，応答を待機せずに，Windows コンソールや
システム・コンソールにメッセージを送信できます。メッセージを送信して応
答を待機する場合は，イベント管理の cawtor コマンドを使用します。
CA Unicenter コンソールを設定するには，次の手順で行います。
Unicenter イベント管理ホストを設定する必要はありません。cawto コマンド
が，このコマンドを処理する Unicenter イベント管理ノードに送信されることを
確認します。イベント管理コンソールを開いて，cawto コマンドで送信された
イベントを探します。
Mercury Business Availability Center を設定するには，次の手順で行います。
1 Unicenter イベント管理ホストに送信される警告を設定するには，警告ウィザー
ドにアクセスします。［管理］＞［プラットフォーム］＞［警告と受信者］＞
［警告］を選択します。
2『プラットフォームの管理』の「警告スキームの作成」の手順に従って，警告
を作成します。
3『プラットフォームの管理』の「警告トリガ時の実行ファイルの実行」に進ん
でください。この手順の間，［実行可能ファイルの実行］チェック・ボックス
を選択し，［警告ウィザード］で警告アクションを定義します。実行ファイル
48
第 6 章 • CA Unicenter への Mercury Business Availability Center 警告の送信
を実行するのに必要なコマンド・ラインの入力を求められる場合には，
Unicenter の cawto コマンド・ラインを使用します。
注：cawto コマンド・ラインのパラメータおよびその有効化の方法について
は，Unicenter のマニュアルを参照してください。
次の例では，Mercury Business Availability Center 警告を Unicenter に送信する
cawto コマンドの作成方法を示します。
C:\tng\bin\cawto.exe –s “” –v W –n ＜ノード＞ “Alert ＜警告名＞ for ＜プ
ロファイル名＞ was triggered because: ＜トリガの原因＞ ”
各項目について説明します。
-s ＜ソース＞：イベントのソースであるアプリケーションを特定します。上記
の例では，＜ソース＞は Mercury Business Availability Center です。
-v ＜値＞：イベントの重大度。イベントを CA メッセージ・コンソールで表示す
る場合，アイコンはイベントの左側に表示され重大度のステータスを示します。
上記の例では，＜値＞は W（警告）です。重大度の値を，次の表に示します。
情報
I
成功
S
警告
W
エラー
E
失敗
F
次のルールに従って，Mercury Business Availability Center の重大度を Unicenter
重大度に変換するよう設定できます。
Unicenter
情報
I
警告
W
49
49
第 2 部 • Mercury Business Availability Center EMS アダプタを使った作業
Unicenter
低
E
高
E
致命的
F
-n ＜ノード＞：対象ノードがユーザの使用しているノードでないときにメッ
セージの送信先となるノードを指定します。
＜警告名＞，＜プロファイル名＞，＜トリガの原因＞は Mercury Business
Availability Center 警告の変数です。
設定に関するトラブルシューティング
カスタム / サードパーティ製の MIB を持っている。それを LDMIB コマ
ンドで DSM にロードすると，何ができるようになるか ?
製品：
➤ Unicenter NSM
バージョン：3.0
OS : WIN/NT，WIN2000，HP，AIX，SUN，LINUX，SCO，SINIX，TRU64
➤ Unicenter TNG
バージョン：2.2, 2.4, 2.4.2
OS : WIN/NT，WIN2000，HP，AIX，SUN，LINUX，SCO，SINIX，TRU64
解決方法
カスタム MIB で ldmib を実行すると，次の機能が提供されます。
➤ MIB に対して objectview を実行する機能。これを行うには，objview の実行
元のマシン上の %AGENTWORKS_DIR\services\config\mibs ディレクトリ
に，MIB をコピーする必要があります。
➤ MIB に対して mibbrowse を実行する機能。
50
第 6 章 • CA Unicenter への Mercury Business Availability Center 警告の送信
MIB をロードしても，トラップは自動的には変換されません。変換には DSM
ポリシーが必要です。メッセージ・レコードおよびアクションを使用して，
EM コンソールで CATrapD メッセージを変換すれば，DSM ポリシーは必要で
はありません。これを行うには，EM 設定にアクセスし，［SNMP trap server
activated］をオンにして，CATrapD を有効にする必要があります。
イベント・コンソールで，
「%CATD_I_060, SNMPTRAP:-c public 791
172.20.0.18 mail.npc.net 2 0.」といった解読不能の形式のメッセージ
を多数受け取った。これらは何を意味しているのか？
製品：
➤ Unicenter NSM
バージョン：3.0
OS : WIN/NT，WIN2000
➤ Unicenter TNG
バージョン：2.2, 2.4, 2.4.2
OS : WIN/NT，WIN2000
解決方法
これらは CATrapD デーモンが取り出す未処理の SNMP トラップです。SNMP
対応デバイスまたはエージェントによって生成される場合もあります。
CATrapD を有効にするには，EM 設定にアクセスして，［SNMP trap server
activated］を有効にします。通常，重要なトラップは DSM によって解釈され
ますが，その他のトラップは，コンソールで個別に変換したメッセージになる
とは限りません。参照ガイドに，これらのトラップの最後に付く番号とその意
味を示します。
次のとおりです。
0
Coldstart
送信 SNMP エンティティが再初期化されました。エージェ
ントの設定が変更された可能性があります。これは，通常，
クラッシュや主要な障害による再起動です。
1
WarmStart
送信 SNMP エンティティが再初期化されましたが，エー
ジェントの設定は変更されませんでした。これは，通常，日
常的な再起動です。
2
linkDown
通信リンクが失敗しました。
51
51
第 2 部 • Mercury Business Availability Center EMS アダプタを使った作業
3
linkUp
通信リンクが発生しました。
4
Authentication
エージェントが，不正なコミュニティ名を受信しました。管
理者の失敗です。
5
EGP
NeighborLoss
EGP（外部ゲートウェイ・プロトコル）ネイバーがダウンし
ました。
6
Enterprise
企業固有のイベントが発生しました。特定するための固有ト
ラップ・タイプが必要です。
イベント・コンソールでサードパーティ製のデバイスからの SNMP ト
ラップを受信して表示するにはどうするか？
製品：
➤ Unicenter TNG
バージョン：2.1, 2.2, 2.4
OS : WIN/NT，WIN2000
解決方法
Unicenter イベント・コンソールのサードパーティ製のデバイスから，SNMP ト
ラップを受け取って表示するには，SNMP トラップ・サービスを有効にしてお
く必要があります。［Unicenter Enterprise Management］＞
［Configuration］＞［Settings］の順に選択します。［SNMP Trap Server
Activated］フラグを［Yes］に変更します。
52
第7章
HP Openview VantagePoint Operations への
Mercury Business Availability Center 警告の
送信
本章では，警告を HP Openview VantagePoint Operations に送信するための
Mercury Business Availability Center の設定方法について説明します。
本章の内容
ページ
HP Openview VantagePoint Operations への Mercury Business Availability
Center 警告の送信について
54
HP OVO エージェントの存在の検証
54
HP OVO エージェントのコア・サーバ・マシンへのインストール
55
opcmsg テンプレートの Mercury Business Availability Center ホストへの
割り当てと配布
56
HP OVO エージェントの opcmsg コマンドを使用した Mercury Business
Availability Center 警告の送信
57
53
第 2 部 • Mercury Business Availability Center EMS アダプタを使った作業
HP Openview VantagePoint Operations への Mercury Business
Availability Center 警告の送信について
警告を HP Openview VantagePoint Operations（OVO）へ送信するには，コア・
サーバに HP エージェントをインストールする必要があります。opcmsg を使
用してイベントを管理サーバに送信するようにエージェントを事前設定しま
す。HP の用語では，これは，エージェントによって opcmsg テンプレートが
割り当てられ，配備される必要があることを意味します。
HP OVO に警告を送信するには，次のことを検証します。
➤ お使いのコア・サーバのホストに HP エージェントがインストールされている
こと。詳細については，次の項を参照してください。
HP エージェントがインストールされていない場合は，これをインストールす
る必要があります。詳細については，55 ページ「HP OVO エージェントのコ
ア・サーバ・マシンへのインストール」を参照してください。
➤ HP エージェントが，opcmsg を使用してイベントを HP OVO 管理サーバに送
信するように設定されていること。詳細については，56 ページ「opcmsg テン
プレートの Mercury Business Availability Center ホストへの割り当てと配布」を
参照してください。
HP OVO エージェントの存在の検証
Mercury Business Availability Center 警告を HP OpenView 管理サーバに送信する
際は，Mercury Business Availability Center で HP の opcmsg コマンドを使用しま
す。これは HP OVO エージェントが管理サーバと通信を行うのに使用するコマ
ンドです。opcmsg を実行して，Mercury Business Availability Center サーバに
HP OVO エージェントがインストールされていることを確認します。
opcmsg コマンドの可用性を検証するには，次の手順で行います。
1 コア・サーバでコマンド・ウィンドウを開きます。
2 コマンド・ウィンドウで，opcmsg と入力し，Enter キーを押します。このコ
マンドの結果としては，次が考えられます。
➤ opcmsg が内部または外部コマンド，実行可能なプログラム，あるいは
バッチ・ファイルとして認識されていない。
54
第 7 章 • HP Openview VantagePoint Operations への Mercury Business Availability Center 警告の送信
原因と解決策 : HP OVO エージェントがマシンにインストールされていない。
55 ページ「HP OVO エージェントのコア・サーバ・マシンへのインストール」
および 56 ページ「opcmsg テンプレートの Mercury Business Availability Center
ホストへの割り当てと配布」に示す手順に従ってください。
➤ 次に示すメッセージが表示されます。
The ITO Message Command is not configured on this system.Contact
your ITO Administrator to configure it.(OpC30-913)
原因と解決策：HP OVO はマシンにインストールされているが，opcmsg
メッセージを送信するよう設定されていない。56 ページ「opcmsg テンプ
レートの Mercury Business Availability Center ホストへの割り当てと配布」に
示す手順に従ってください。
➤ 次に示すメッセージが表示されます。
The application parameter is required.(OpC30-903)
The object parameter is required.(OpC30-904)
The msg_text parameter is required.(OpC30-905)
使用方法：
opcmsg [-help] [-id] severity=normal|warning|minor|major|critical]
application= ＜アプリケーション＞ object= ＜オブジェクト＞ msg_text=
＜テキスト＞ [msg_grp= ＜メッセージ・グループ＞ ] [node= ＜ノード＞ ]
[service_id= ＜サービス ID ＞ ] [-option ＜変数＞ = ＜値＞ ]* (OpC30-900)
原因：HP OVO がマシンにインストールされていて，opcmsg メッセージを
送信するよう設定されている。
HP OVO エージェントのコア・サーバ・マシンへのインストール
コア・サーバ・マシンのホストが HP OVO のノード・グループの一部であるこ
とを確認します。確認できない場合は，警告を表示することができません。
HP OVO エージェントをインストールするには，次の手順で行います。
1 Mercury Business Availability Center サーバ上で，FTP サービスが書き込み権限で
実行されていることを確認します。
2 HP OVO 管理サーバの［HP OVO ITO Node Bank］ウィンドウでホストを探し，
それを選択します。ホストが定義されていない場合は，まずホストを定義する
必要があります。
55
55
第 2 部 • Mercury Business Availability Center EMS アダプタを使った作業
3［Actions］メニューから［Agents］，次に［Install/Update SW & Config］を選
択します。
4 Components 領域から［Agent Software］チェック・ボックスを選択します。
選択したホストが，右側のリスト・ボックスに表示され，その上の［Nodes in
list requiring update］チェック・ボックスが選択されていることを確認しま
す。［OK］をクリックします。
5 開いたウィンドウで，Mercury Business Availability Center のホストの管理権限を
持つユーザ名およびパスワードを HP OVO に付与します。
6 画面に表示されている指示に従います。ファイルの場所をポイントします。
7 Mercury Business Availability Center サーバ上で，お使いの FTP ルート・ディレク
トリの一時ディレクトリにある opc_inst.bat ファイルを手動で実行します。
opcmsg テンプレートの Mercury Business Availability Center ホ
ストへの割り当てと配布
以下では，opcmsg テンプレートを Mercury Business Availability Center ホストに
割り当てて配布する手順について説明します。この手順を実行すると，
Mercury Business Availability Center を設定して HP OVO へ警告を送信できます。
詳細については，57 ページ「HP OVO エージェントの opcmsg コマンドを使用
した Mercury Business Availability Center 警告の送信」を参照してください。
opcmsg を割り当てて配布するには，次の手順で行います。
1 HP OVO 管理サーバの［HP OVO ITO Node Bank］ウィンドウでコア・サーバの
ホストを探し，それを選択します。［Actions］＞［Agents］＞［Assign
templates］の順に選択します。
2［Add］をクリックし，プローブ・ホストが左側のリスト・ボックスに表示さ
れることを確認します。
3［Open Template Window］ボタンをクリックします。
4 テンプレート・ウィンドウで，［Default］を選択し，適切なオペレーティン
グ・システム名をダブルクリックし，opcmsg(1|3) を選択します。
5［Add Configuration］ウィンドウへ戻り，［Get template selection］をクリック
します。右側のリスト・ボックスに opcmsg(1|3) が表示されます。
6［Add Configuration and Define Configuration］ウィンドウで［OK］ボタンをク
リックします。
56
第 7 章 • HP Openview VantagePoint Operations への Mercury Business Availability Center 警告の送信
7［HP OVO ITO Node Bank］ウィンドウに戻り，［Actions］メニューから
［Agents ］＞［Install/Update SW & Config］の順に選択します。ホストが選
択されていることを確認します。
8 テンプレートのチェック・ボックスを選択し，［OK］をクリックします。
HP OVO メッセージ・ブラウザに，テンプレートがホストに正しく配布された
ことを告げるメッセージが表示されます。
HP OVO エージェントの opcmsg コマンドを使用した Mercury
Business Availability Center 警告の送信
Mercury Managed Services のお客様へ：この手順は，Mercury Managed Services
をお使いのお客様には該当しません。Mercury Managed Services をお使いのお客
様は，SiteScope コマンド・ライン・モニタを使用してください。このモニタの
使用については，Mercury Managed Services サポートにお問い合わせください。
このコマンド・ライン・ユーティリティは，HP OVO エージェントを Mercury
Business Availability Center コア・サーバ・マシンにインストールした後で使用
可能です。詳細については，55 ページ「HP OVO エージェントのコア・サー
バ・マシンへのインストール」を参照してください。
opcmsg コマンドを使用すれば，応答を待機せずに，Windows コンソールやシ
ステム・コンソールにメッセージを送信できます。
Mercury Business Availability Center 警告を設定するには，次の手順を実行します。
1 HP OVO ホストに送信される警告を設定するには，警告ウィザードにアクセス
します。［管理］＞［プラットフォーム］＞［警告と受信者］＞［警告］を選
択します。
2『プラットフォームの管理』の「警告スキームの作成」の手順に従って，警告
を作成します。
57
57
第 2 部 • Mercury Business Availability Center EMS アダプタを使った作業
3『プラットフォームの管理』の「警告トリガ時の実行ファイルの実行」に進ん
でください。この手順の間，［実行可能ファイルの実行］チェック・ボックス
を選択し，［警告ウィザード］で警告アクションを定義します。実行ファイル
を実行するのに必要なコマンド・ラインの入力を求められる場合には，HP
OVO エージェントの cawto コマンド・ラインを使用します。
opcmsg [-help] [-id] severity=normal|warning|minor|major|critical]
application= ＜アプリケーション＞ object= ＜オブジェクト＞ msg_text=
＜テキスト＞
[msg_grp= ＜メッセージ・グループ＞ ] [node= ＜ノード＞ ] [service_id=
＜サービス ID ＞ ]
[-option ＜変数＞ = ＜値＞ ]* (OpC30-900)
opcmsg コマンドは，オブジェクト，アプリケーション，およびメッセージ・
テキストの 3 つの必須パラメータを定義します。さらに，次のパラメータを使
用できます。
severity : 通常，警告，低，高，または緊急のいずれかの重大度
msg_grp：HP OVO で定義されたメッセージ・グループの名前
node：この警告の送信元のノードを定義するのに使用される
service_id：この警告を特定の HP Service Navigator サービスに割り当てるのに
使用される
-option ＜変数＞ = ＜値＞：OVO の自動およびオペレータ実行アクションに
よって使用される 1 つ以上の主要な値のペア
58
第8章
Tivoli TEC への Mercury Business
Availability Center 警告の送信
本章では，警告を Tivoli TEC に送信するための Mercury Business Availability
Center の設定方法について説明します。
本章の内容
ページ
Mercury Business Availability Center 警告の Tivoli TEC への送信
60
Tivoli TEC の設定
60
Tivoli エンド・ポイントの postemsg コマンドによる Mercury Business
Availability Center 警告の送信
62
59
第 2 部 • Mercury Business Availability Center EMS アダプタを使った作業
Mercury Business Availability Center 警告の Tivoli TEC への送信
IBM Tivoli Enterprise Console（TEC）アプリケーションを使用して警告を統合で
きます。
警告を Tivoli TEC 管理サーバに送信するためには，Mercury Business Availability
Center で Tivoli の postemsg コマンドを使用します。これは，管理サーバと通
信するために管理下のノードによって使用されるコマンドです。したがって，
Mercury Business Availability Center サーバは Tivoli エンド・ポイントでなければ
なりません（つまり，Tivoli ソフトウェア・エージェントがマシンにインス
トールされていなければなりません）。postemsg コマンドは，run_exe コマ
ンドから呼び出されます。
Tivoli TEC の設定
Tivoli TEC に警告を送信するためには，次のことを検証する必要があります。
➤ 次のアプリケーションがインストールされていること。
➤ Tivoli Enterprise console EIF（Event Integration facility）
➤ Tivoli Enterprise Console Adapter Configuration Facility
➤ コア・サーバのホスト上の Tivoli エンド・ポイント
➤ ACP プロファイルが，コア・サービス・サーバのホスト上の Tivoli エンド・ポ
イントに配備されていること。
➤ postemsg が次のディレクトリの下にあること。
＜ドライブ＞ :\Program Files\Tivoli\lcf\bin\ ＜プラットフォーム＞ \bin\
次を実行することで，postemsg が存在するかどうかを確認できます。
使用法：postemsg { -S ＜サーバ＞ | -f ＜設定ファイル＞ } [-r ＜重大度＞ ]
[-m ＜メッセージ＞ ] [ ＜スロット名 = 値＞ , ...] ＜クラス＞＜ソース＞
Tivoli TEC に警告を送信するには，次の手順で行います。
1 警告のイベント・クラスを説明する baroc ファイルを作成します。baroc ファ
イル形式の詳細については，Tivoli TEC のマニュアルを参照してください。
2 コマンド・ウィンドウを開き，Tivoli TEC に baroc ファイルを配備します。
60
第 8 章 • Tivoli TEC への Mercury Business Availability Center 警告の送信
➤ baroc ファイルをアクティブなルール・ベースに追加するには，次の手順で
行います。
Wrb -imprbclass ＜ baroc ファイル＞＜ルール・ベース＞
➤ コンパイルします。
Wrb -comprules ＜ルール・ベース＞
➤ 再ロードします。
Wrb -loadrb ＜ルール・ベース＞
➤ TEC を再起動します。
Wstopesvr
wstartesvr
3 Mercury Business Availability Center サーバに，Tivoli エンド・ポイントをインス
トールします。エンド・ポイントとともに postemsg 実行ファイルがインス
トールされます。
4 Tivoli conf ファイルを作成，編集します。
➤ TEC サーバ名を挿入します。
ServerLocation= ＜ TEC サーバ名＞
➤ TEC サーバ・ポート番号を挿入します。
ServerPort= ＜ TEC サーバのポート番号＞
➤ このファイルを任意の場所に保存します。
61
61
第 2 部 • Mercury Business Availability Center EMS アダプタを使った作業
5 postemsg を使用して，適切なコマンド・ラインを作成します。例を次に示し
ます。
postemsg -f topaz.conf -r CRITICAL description=" ＜警告の説明＞ "
triggerCause=" ＜トリガの原因＞ " hostname="cookie"
topazProfileName=" ＜プロファイル名＞ " Topaz_Alert Topaz
Tivoli エンド・ポイントの postemsg コマンドによる Mercury
Business Availability Center 警告の送信
Mercury Managed Services のお客様へ：この手順は，Mercury Managed Services
をお使いのお客様には該当しません。Mercury Managed Services をお使いのお客
様は，SiteScope コマンド・ライン・モニタを使用してください。このモニタの
使用については，Mercury Managed Services サポートにお問い合わせください。
このコマンド・ライン・ユーティリティは，Tivoli エンド・ポイントを Mercury
Business Availability Center コア・サーバ・マシンにインストールした後で使用
可能です。
postemsg コマンドを使用すれば，応答を待機せずに，Windows コンソールや
システム・コンソールにメッセージを送信できます。
Mercury Business Availability Center を設定するには，次の手順を実行します。
1 Tivoli TEC ホストに送信される警告を設定するには，警告ウィザードにアクセ
スします。［管理］＞［プラットフォーム］＞［警告と受信者］＞［警告］を
選択します。
2『プラットフォームの管理』の「警告スキームの作成」の手順に従って，警告
を作成します。
3『プラットフォームの管理』の「警告トリガ時の実行ファイルの実行」に進ん
でください。この手順の間，［実行可能ファイルの実行］チェック・ボックス
を選択し，［警告ウィザード］で警告アクションを定義します。実行ファイル
62
第 8 章 • Tivoli TEC への Mercury Business Availability Center 警告の送信
を実行するのに必要なコマンド・ラインの入力を求められる場合には，Tivoli
エンド・ポイントの postemsg コマンド・ラインを使用します。
postemsg { -S ＜サーバ＞ | -f ＜設定ファイル＞ } [-r ＜重大度＞ ]
[-m ＜メッセージ＞ ] [ ＜スロット名 = 値＞ , ...] ＜クラス＞＜クラス＞
63
63
第 2 部 • Mercury Business Availability Center EMS アダプタを使った作業
64
索引
A
E
API 3
byTime 関数 19
OpenAPI クエリ・ビルダ 9
Web サービス，呼び出し 5
Web ブラウザの場合の応答 7
返される行数の上限，設定 7
クエリ
作成 15
従来のデータ 21
クエリの作成 4
クエリの例 20
権限 5
サポートされている SQL 構文 16
サンプルのメタデータ 5
設定 20
日時のフォーマット 18
ブラウザによるクエリの実行 6
戻りデータ 6
EMS アダプタ
Mercury Business Availability Center との
統合 37, 38
SiteScope を使用した Mercury Business
Availability Center との統合 38
設定 39
Excel レポート
クエリ
作成 15
B
BMC PATROL
SNMP アダプタのインストール 42
インストールのトラブル
シューティング 43
～へ警告の送信 41
C
CA Unicenter
SNMP トラップとしての警告の送信 46
Unicenter cawto コマンドの SNMP
トラップとしての警告の送信 48
設定に関するトラブルシューティング
50
～へ警告の送信 45
G
Generic Data Engine API 3
H
HP OVO VantagePoint Operations
HP OVO エージェントのコア・サーバ・
マシンへのインストール 55
HP OVO エージェントの存在の検証 54
opcmsg コマンドによる Mercury
Business Availability Center 警告の
送信 57
opcmsg テンプレートの配布 56
～へ警告の送信 53
O
OpenAPI 3
OpenAPI クエリ・ビルダ 9
T
Tivoli TEC
postemsg コマンドによる Mercury
Business Availability Center 警告の
送信 62
セットアップ 60
～へ警告の送信 59
65
索引
W
Web サービス
Generic Data Engine 3
Generic Data Engine API，クエリ 15
Generic Data Engine API，戻りデータ 6
け
警告
BMC PATROL への送信 41
CA Unicenter への送信 46
HP OVO VantagePoint Operations への
送信 54
Tivoli TEC への送信 60
れ
レポート，Generic Data Engine 3
66

Download Report