svcwatch add sql コマンド -- SQL テストを追加する

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

svcwatch add sql コマンド -- SQL テストを追加する

svcwatch add sql コマンドは、指定されたホストの SRM に SQL テストを追加します。詳細と前提条件については、このガイドの「SQL クエリテスト」を参照してください。

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

svcwatch [options] -o add index descr sql 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

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

sql

SQL サービスタイプを指定します。

destination

テスト用のデータベースサーバおよびポート（server:port）を指定します。デフォルトポート： 1433（SQL Server）、1521（Oracle）

username

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

password

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

args

サービス引数を指定します。引数はそれぞれキーワードと値のペア（キー=値）にします。複数の引数はアンパサンド（&）で連結して区切ります。引数の文字列全体を引用符で囲みます。

引数用の一般的な構文： "key1=value1[&key2=value2& ...]"

query=query - SQL クエリを指定します。

qtype=query|stored|update - （オプション）クエリタイプを指定します（デフォルト： query）

dbtype=oracle|mssql|other - データベースタイプを指定します。

dbname=name - （oracle および mssql のみ）データベース名を指定します。「other」を選択する場合は、接続文字列にデータベース名を指定します。

driver=driver - （other のみ）クエリに使用する JDBC ドライバ。

url=string - （other のみ）データベースの接続文字列。データベースタイプにより異なります。接続文字列の詳細については、データベースのマニュアルを参照してください。

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

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 （すべてのメッセージを記録）

例

SQL Server テストを追加します。

svcwatch -p 161 -c admin -o add 1360758 "TestSqlServer" sql 
"192.168.100.100:1433" "sa" "AdminLvl1" "query=select * from 
vas_system&dbtype=mssql&dbname=vasdb" 30 3 30 60 0 0 0x100 
"TestSQL" "" ""

SQL Server の JDBC ドライバテストを追加します。

svcwatch -p 161 -c admin -o add 1360761 "TestSqlServerJDBCDriver"
sql "192.168.100.100:1433" "sa" "AdminLvl1" "query=select * from 
my_system&dbtype=other&driver=com.microsoft.sqlserver.jdbc.SQLServerDriver
&url=jdbc:sqlserver://hostnameValue:portValue;databaseName=vasdb;
user=unameValue;password=pwdValue" 30 3 30 60 0 0 0x100 
"TestSqlServerJDBCDriver" "" ""

Oracle テストを追加します。

svcwatch -p 161 -c admin -o add 1360759 "TestOracle" sql 
"192.168.101.101:1521" "joe" "AdminLvl1" "query=select * from big_system
&dbtype=oracle&dbname=bigdb" 30 3 30 60 0 0 0x100 "TestOracle" "" ""

Oracle JDBC Thin ドライバテストを追加します。

svcwatch -p 161 -c admin -o add 1360762 "TestOracleJDBCThinDriver" sql 
"192.168.101.101:1521" "joe" "AdminLvl1" "query=select table_name from 
user_tables&dbtype=other&driver=oracle.jdbc.OracleDriver
&url=jdbc:oracle:thin:unameValue/pwdValue@hostnameValue:portValue:orcl" 
30 3 30 60 0 0 0x100 "TestOracleThin" "" ""