svcwatch add tcpconnect コマンド -- TCP 接続テストを追加する

サービスレスポンスモニタ › サービスレスポンスモニタの CLI コマンド › svcwatch add tcpconnect コマンド -- TCP 接続テストを追加する

svcwatch add tcpconnect コマンド -- TCP 接続テストを追加する

svcwatch add tcpconnect コマンドは、指定されたホストの SRM に TCP 接続テストを追加します。

このコマンドの形式は、以下のとおりです。

svcwatch [options] -o add index descr tcpconnect destination 
username password args interval samples timeout winsiz tos 
limit flags name class contextInfo logLevel

add コマンドは次のパラメータを使用します。

オプション

このコマンドで使用できるオプションを指定します。

-h hostname | -h ipAddr

（オプション） SystemEDGE ホストを指定します。

デフォルト： localhost

-p port

（オプション） SystemEDGE SNMP ポートを指定します。

デフォルト： 161

-c community

（オプション） SNMP バージョン 1 および 2c の SNMP コミュニティ文字列を指定します。

デフォルト： public

-v snmpVersion

（オプション）SNMP バージョンを指定します。設定可能な値は以下のとおりです。

1
2c
3
デフォルト： 1

-u secName

（オプション）SNMPv3 セキュアユーザの名前を指定します。

-u secLevel

（オプション）SNMPv3 のセキュリティレベルを指定します。設定可能な値は以下のとおりです。

1 - noAuthNoPriv
2 - AuthNoPriv
3 - AuthPriv

-n contextName

（オプション）MIBMuxed エージェントのインスタンス名を指定します。

-a authPassword

（オプション）SNMPv3 のセキュリティに AuthNoPriv または AuthPriv が選択された場合に必要な認証パスワードを識別します。

-A authProtocol

（オプション）認証プロトコルを指定します。設定可能な値は以下のとおりです。

MD5 - 認証プロトコル HMAC-MD5
SHA - 認証プロトコル HMAC-SHA
デフォルト： MD5

-x privPassword

（オプション）SNMPv3 のセキュリティレベルが 3 （AuthPriv）である場合のプライバシー（暗号化）パスワードを指定します。

-X encryptProtocol

（オプション）プライバシーに使用する暗号化プロトコルを指定します。設定可能な値は以下のとおりです。

DES - データ暗号化標準
AES - 128 ビットの暗号化キーを使用した高度暗号化標準（AES128）
3DES - トリプルデータ暗号化標準

-m FIPSmode

（オプション）FIPS モードを指定します。設定可能な値は以下のとおりです。

0 - 非 FIPS
1 - FIPS 共存
2 - FIPS のみ
デフォルト： 0

-t timeout

（オプション） SNMP コマンドタイムアウトを指定します。

デフォルト： 10 秒

-d logLevel

（オプション） SNMP メッセージのログレベルを指定します。設定可能な値は以下のとおりです。

0 - 致命的なメッセージを記録する
1 - 重大なメッセージを記録する
2 - 警告メッセージを記録する
3 - 情報メッセージを記録する
4 - すべてのメッセージを記録する
5 - デバッグメッセージを含むすべてのメッセージを記録する
デフォルト： 0

-f logFile

（オプション）ログファイルの名前を指定します。

デフォルト： sysedge_utility.log

-L

（オプション）コンソールの現在のロケールと、利用可能な場合は言語カタログを検出します。言語カタログが見つからない場合は、デフォルト言語の英語が使用されます。

-o add testparams

SRM に新しいテストを追加します。

testparams

新しいテストのパラメータを指定します。

index

svcRspTable のインデックスを指定します。

descr

テストの説明を引用符で囲んで指定します。引用符内に空文字列 "" を使用すると、説明を指定しません。

tcpconnect

TCP 接続サービスタイプを指定します。

destination

テスト用のリモートホストおよびポート（server:port）を指定します。

username

認証用のユーザ名を引用符で囲んで指定します。引用符内に空文字列 "" を使用すると、ユーザ名を指定しません。

password

認証用のパスワードを引用符で囲んで指定します。引用符内に空文字列 "" を使用すると、パスワードを指定しません。

args

DHCP サービスタイプで利用可能な引数はありません。引用符内に空文字列 "" を使用すると、引数を指定しません。

注：各サービスタイプの特定の引数の詳細については、「テストのキーワード」を参照してください。

interval

テスト間隔を秒数で指定します。

制限： 30 秒の倍数

samples

間隔ごとのサンプルを指定します。

timeout

タイムアウトを秒数で指定します。

winsiz

統計ウィンドウサイズを秒数で指定します。

tos

IP Type of Service または Differentiated Services Code を指定します。通常のサービスには 0 （ゼロ）を使用します。 RFC 1349 も参照してください。

limit

このテストの合計レスポンス時間に対して許容されるパフォーマンスの限度（しきい値）を指定します。この値はレポートで使用されます。

flags

以下のフラグを指定します。

0x001 = パフォーマンスキューブの収集

0x100 = 要求時にのみ実行（一度のみ実行）

name

サービスタイプごとに一意の名前を指定します。引用符 "" 内の文字列を空にすると、テスト名は指定されません。

class

クラス名を指定します。引用符 "" 内の文字列を空にすると、クラス名は指定されません。

contextInfo

コンテキスト情報を指定します。引用符 "" 内の文字列を空にすると、コンテキスト情報は指定されません。

logLevel

テスト実行コードのログレベルを指定します。設定可能な値は以下のとおりです。

-2 = SRM グローバルログレベルを使用（デフォルト）

-1 = 記録しない

0 = 致命的なエラー（最も重要なメッセージのみ）

1 = 重大なエラー

...

7 = デバッグ 3 （すべてのメッセージを記録）

例

TCP 接続テストを追加します。

svcwatch -p 161 -c admin -o add 1360763 "Test" tcpconnect 
"192.168.90.10:1433" "" "" "" 60 5 30 60 0 0 0X100 
"Testtcpconnect" "" "" 1

ここでホストを指定しない場合、デフォルトは localhost です。ポート番号は 161 です。「add」により SRM に新しいテストが追加されます。 svcRspTable の一意のインデックス番号は 2013 です。「Test」はこのテストの説明です。 tcpconnect は TCP 接続サービスタイプを指定します。テストされるリモートホストとポートの詳細は、192.168.90.10:1433 です。

引用符（""）の 2 つの空文字列は、認証に使用されるユーザ名およびパスワードを指定していないことを示します。 "" は tcpconnect サービスタイプで利用可能な引数を指定していないことを示します。テスト間隔は 60 秒に指定されています。 1 つの間隔ごとにテストされるサンプルの数は 5 です。タイムアウトは 30 秒です。統計ウィンドウサイズは 60 秒です。 0（ゼロ）は通常のサービスであることを指定します（IP Type of Service または Differentiated Services ではありません）

0（ゼロ）は、このテストの合計レスポンス時間に対して許容されるパフォーマンスの限度（しきい値）を指定します。このテストは、フラグが 0x100 に設定されたリクエストのみで 1 度だけ実行されます。サービスタイプごとに一意の名前（Testtcpconnect）を指定します。 "" はクラス名およびコンテキスト情報を指定していないことを示します。ログレベルを重大（'1'）に設定してテストを実行します。