サービス レスポンス モニタ › テスト管理 › カスタム スクリプトを使用したテストの作成

カスタム スクリプトを使用したテストの作成

カスタム スクリプトを作成すると、SRM に対し、ローカル システム上でカスタム テストを実行するよう指示することができます。

カスタム テストを作成するためのガイドライン

カスタム テストを作成する場合は、以下を考慮してください。

• カスタム テストにおいて、名前解決時間、接続時間、またはトランザクション時間に対して 0 以下の値が戻された場合、テストの可用性は「0」に設定されます。
• カスタム スクリプトによって報告される時間の単位は、ミリ秒です。
• 正常なカスタム スクリプトであれば、整数値のみが返されます。
• 正常なスクリプトでは、終了コードとして「0」が戻されます。 「0」以外の値であれば、カスタム スクリプトは失敗しています。
• 結果コードは、テストの MIB 内の結果フィールドに配置されます。

スクリプトを作成するためのガイドライン

スクリプトは、バイナリ実行ファイルとして、または UNIX のシェルや Perl などのスクリプト言語で作成することができます。 カスタム レスポンス モジュールは、SystemEDGE エージェント拡張オブジェクトと非常によく似た動作をします。 SystemEDGE 拡張オブジェクトの詳細については、「SystemEDGE ユーザ ガイド」を参照してください。 SRM では、カスタム スクリプトの出力は 3 個以上（6 個以下）の値に続いて改行を含む単一の行であることが求められます。

作成するスクリプトは、以下の情報をこの順序で戻す必要があります。

1. DNS 解決時間（必須）
2. 接続時間（必須）
3. トランザクション時間（必須）
4. 結果コード（オプション）
5. 受信バイト数（オプション）
6. 送信バイト数（オプション）

SRM は、受信バイト数および送信バイト数についてスクリプトが戻すデータに基づいて、スループットを計算します。 したがって、スクリプトが受信バイト数を提供する場合は、送信バイト数も提供する必要があります（逆の場合も同様です）。 スクリプトからの正しい出力は、以下の 3 つのオプションのいずれかである必要があります。

オプション A：

1. DNS 解決時間
2. 接続時間
3. トランザクション時間

オプション B：

1. DNS 解決時間
2. 接続時間
3. トランザクション時間
4. 結果コード

オプション C：

1. DNS 解決時間
2. 接続時間
3. トランザクション時間
4. 結果コード
5. バイト数（イン）
6. バイト数（アウト）

オプションと引数

カスタム テストには、以下のテスト固有のオプションと引数が必要です。

スクリプトのパス - 実行するカスタム スクリプトの完全パスおよびファイル名。

注： パス名を指定するときは、テストを実行するオペレーティング システムについて正しいタイプのスラッシュを必ず使用してください。UNIX システム上で実行するテストのディレクトリを指定するときはスラッシュ（/）、Windows システム上で実行するテストのディレクトリを指定するときはバックスラッシュ（¥）を使用します。

カスタム テストにタイムアウト値を指定する場合は、スクリプトの実行に十分な時間が提供されていることを確認してください。 スクリプトの実行に十分な時間が与えられていない場合は、SRM によってスクリプトが終了されます。スクリプトがそれ自身の子プロセスのクリーンアップを行わない場合、それらの子プロセスは実行を続けるため、最終的にシステムがハングアップする可能性があります。

このオプションまたは引数は、テストを作成または変更するときに指定します。

例

この例を使用して、/local/bin/custom_Test.pl にあるスクリプトを実行するのに必要な時間をモニタリングするテストを作成します。 このエントリは、エージェントに 120 秒（2 分）ごとに 1 度サービスをテストし、正常に応答するまで最大 20 秒待機するように指示します。 エージェントは最後の 3600 秒間（6 時間）の統計を算出します。

［新しいテストの作成］ページで以下を実行します。

1. ［一般オプション］の隣で［詳細］を選択します。
2. ［テスト タイプ］リストで［カスタム］を選択します。
3. ［テスト名］フィールドに「custom_Test.pl」を指定します。
4. ［説明］フィールドで「Test Custom Service」を指定します。
5. ［テスト間隔］フィールドに「120」を指定します。
6. ［テスト タイムアウト］フィールドに「20」を指定します。
7. ［間隔当たりのサンプル数］フィールドに「1」を指定します。
8. ［統計ウィンドウ］フィールドに「3600」を指定します。
9. ［スクリプトのパス］フィールドに「/local/bin/custom_Test.pl」を指定します。
10. ［テストの保存］をクリックします。

変更をコミットすると、SRM によって以下のようなエントリが svcrsp.cf ファイルに追加されます。

{
index=99 
type=custom
desc="Test custom service" 
dest="/local/bin/custom_Test.pl" 
interval=120 
samples=1 
timeout=20 
window=3600 
tos=0 
limit=0 
status=active 
name="Custom Service Test"
class=""
context=""
flags="1"
loglevel=1
}

カスタム テストの実行中に表示されるエラーに関する詳細については、「カスタム テスト エラー コード」を参照してください。