ページの先頭行へ戻る
Systemwalker Service Quality CoordinatorV15.2.3 使用手引書
FUJITSU Software

6.3 ユーザーデータのPDBへの格納

ユーザーデータをPDBに格納します。

sqcPDBcloadの詳細については、リファレンスマニュアル「sqcPDBcload(ユーザーデータ入力コマンド)」を参照してください。

注意

ユーザーデータのしきい値監視を行う場合は、sqcPDBcloadコマンドでPDBにユーザーデータを取り込んだタイミングで、監視項目の値が定義値を超えていたときに、アラームを通知します。


■記述形式

Windows版】

<インストールディレクトリ>\bin\sqcPDBcload.exe -u udata-file -i conv-file

UNIX版】

/opt/FJSVssqc/bin/sqcPDBcload.sh -u udata-file -i conv-file


オプション

-u udata-file

PDBに格納するユーザーデータファイル(CSVファイル)を指定します。

-i conv-file

データ変換定義ファイル(iniファイル形式)を指定します。データ変換定義ファイルとは、ユーザーデータをPDBへ格納するレコード形式に変換する際の変換ルールが記述された以下のようなファイルです。

[USERDATA]

consol_flag=2

record_id=1

col_resource_id=2,5

col_start_date_time=6

col_data_num1=10

col_data_num2=9

col_data_text1=4


【データ変換定義ファイル(conv-file)】

生成されるレコードの形式については、リファレンスマニュアル「データフォーマット」を参照してください。

consol_flag

データの種別を指定します。データの種別には、以下があります。それぞれ表示機能と保持期間が異なっています。解説書「Manager」を参照して、どのデータ種別で格納するかを設計してください。

・0 : サマリデータ
・1 : リソースデータ(10分)
・2 : リソースデータ(1時間)
・3 : リソースデータ(1日)

0 を指定すると、「SUM_UDATA_n」レコードが生成されます。
1~3 を指定すると、「UDATA_n」レコードが生成されます。

record_id

生成するレコード「SUM_UDATA_1~20」または「UDATA_1~20」の内、どれを生成するかを1~20の値で指定します。

col_resource_id

リソースIDとするユーザーデータファイルのフィールドの番号を指定します。リソースIDとは、そのレコードを一意に識別する識別子です。
例えば、プロセス情報なら、プロセス名がリソースIDになります。
なお、複数のフィールドをつなげてリソースIDにすることもできます。その場合は、col_resource_id=2,5とすることで、フィールド2と5を1つにつなげるという意味になります。

col_start_date_time

収集開始時刻となるフィールドの番号を指定します。
なお、格納するデータの形式は、以下のとおりです。

‘YYYY-MM-DD [hh[:mm[:ss]]]’
(YYYY:西暦、MM:月、DD:日、hh:時間、mm:分、ss:秒)

col_data_num1 ~ 14

フィールド「smudndata1~7」または「udndata1~14」に格納する、ユーザーデータファイルのデータ(数値)のフィールド番号を指定します。

Record ID

指定できるフィールド番号

データが格納されるフィールド

SUM_UDATA_1 ~ 20

col_data_num1 ~ 7

smudndata1 ~ 7

UDATA_1、2、3、6、7、8、11、12、13、16、17、18

col_data_num1 ~ 7

udndata1 ~ 7

UDATA_4、5、9、10、
14、15、19、20

col_data_num1 ~ 14

udndata1 ~ 14

データ(数値)は1つ以上指定してください(col_data_num1は必ず指定してください)。

col_data_text1 ~ 5

フィールド「smudntxt1」または「udntxt1~5」に格納する、ユーザーデータファイルのデータ(テキスト)のフィールド番号を指定します。


【データ変換定義ファイル指定と生成されるレコードの例】

データ変換定義ファイル指定

生成されるレコード

補足

Record ID

Field Name

consol_flag=0

record_id=1

col_data_num3=9

SUM_UDATA_1

smud1data3

consol_flagに0を指定することで、SUM_UDATA_n のレコードが生成される。

record_idに1を指定することで、SUM_UDATA_1のレコードが生成される。

col_data_num39を指定することで、sumud1data3のフィールドには、CSVファイルの9番目のフィールドが格納される。

consol_flag=1

record_id=1

col_data_num3=9

UDATA_1

ud1data3

consol_flagに1~3を指定することで、UDATA_n のレコードが生成される。

record_idに1を指定することで、UDATA_1のレコードが生成される。

col_data_num39を指定することで、ud1data3のフィールドには、CSVファイルの9番目のフィールドが格納される。

consol_flag=3

record_id=2

col_data_num3=9

UDATA_2

ud2data3

consol_flagに1~3を指定することで、UDATA_n のレコードが生成される。

record_idに2を指定することで、UDATA_2のレコードが生成される。

col_data_num39を指定することで、ud2data3のフィールドには、CSVファイルの9番目のフィールドが格納される。


■使用例

【Windows版】

C:\>cd C:\Program Files\Fujitsu\SystemwalkerSQC\bin

C:\Program Files\Fujitsu\SystemwalkerSQC\bin>sqcPDBcload -u C:\temp\udata.csv -i C:\temp\conv.ini

sqcPDBcload succeeded

【UNIX版】

# cd /opt/FJSVssqc/bin/

# ./sqcPDBcload.sh -u /var/tmp/udata.csv -i /var/tmp/conv.ini

sqcPDBcload succeeded.


この時、udata.csvの内容は以下のとおり。

20xx-09-09 10:00:00,kaminaka,2,octets,data,767872,28856,22400


また、conv.iniの内容は以下のとおり。

[USERDATA]

consol_flag=2

record_id=1

col_resource_id=2,3

col_start_date_time=1

col_data_num1=6

col_data_num2=7

col_data_text1=4