ルートログセクション

<< Click to Display Table of Contents >>

マニュアル > サーバ作成ガイド > アクション編 > アクションリファレンス > サマリアクション(ロギング/集計/日報) > サマリアクションの設定ファイルとフォルダ構成 > サマリマスタ >

ルートログセクション

ルートログセクション プロパティ一覧

ログ機能関連

パラメータ名

(デフォルト値)

対象

必須

解説

DaysOfHoldingData

(-1)

CSV/ODBC

 

ルートログのデータ保持日数。

設定値

内容

-1

共通プロパティセクションのDaysOfHoldingDataパラメータの設定に従う

0

永久保持

1以上

保持する日数

 

<設定例>1年分保持の場合

DaysOfHoldingData =365

 

TagFieldMaster

(指定無し)

CSV/ODBC

必須

タグフィールドマスターファイルのパス。サマリフォルダからの相対パスで指定します。

 

<設定例>

TagFieldMaster=fieldmaster_tag.csv

 

TagFieldIndex

(指定無し)

CSV/ODBC

必須

タグフィールドインデックスファイルのパス。サマリフォルダからの相対パスで指定します。

 

<設定例>

TagFieldIndex=DB\index_tag.txt

 

CalculationFieldMaster

(指定無し)

CSV/ODBC

 

計算フィールドマスターファイルのパス。サマリフォルダからの相対パスで指定します。

 

<設定例>

CalculationFieldMaster=fieldmaster_calculation.csv

 

CalculationFieldIndex

(指定無し)

CSV/ODBC

 

計算フィールドインデックスファイルのパス。サマリフォルダからの相対パスで指定します。

 

<設定例>

CalculationFieldIndex=DB\index_calculation.txt

 

TimeRangeType

(TYPE1)

CSV/ODBC

 

どの時間範囲で保存するかのタイプ。タグフィールドマスタ及び計算フィールドマスタにTermOfValidityを指定した場合の時間の範囲のタイプに影響します。詳しくは、共通プロパティセクションの「TermOfValidityDefinition」を参照して下さい。

設定値

内容

TYPE1

今回正時(今回正時を含む)から次正時(次正時を除く)まで

TYPE2

今回正時(今回正時を除く)から次正時(次正時を含む)まで

 

<設定例>

TimeRangeType=TYPE2

 

InvalidValue

(指定無し)

CSV/ODBC

 

無効値です。無効値を設定すると、実際の値と無効値が一致した場合、無効値としてログされます。何も設定しないと、どんな値でもログに保存します。

 

<設定例>

InvalidValue=999999

 

CsvFileName

(指定無し)

CSV

必須

ログを保存するCSVファイル名。実際のファイル名はCsvFileUnitの設定に従い末尾に日付が付加されます。サマリフォルダからの相対パスで指定します。また、他のルートログや集計ログと同じフォルダを指定しないで下さい。

 

<設定例>

CsvFileName=DB\RAW\SMR_RAW_.csv

 

CsvFileUnit

(DAY)

CSV

 

ファイルの保存単位を指定します。

設定値

内容

DAY

日単位でファイルを作成し保存していきます。

MONTH

月単位でファイルを作成し保存していきます。

YEAR

年単位でファイルを作成し保存していきます。

 

<設定例>

CsvFileUnit=DAY

 

hint

DAYを選択すると、ファイル名に「YYYYMMDD」が付加されます。同様にMONTHを選択すると「YYYYMM」が、YEARを選択すると「YYYY」がファイル名に付加されます。

 

CsvFileMaxFields

(0)

CSV

 

1ファイルあたりの最大タグフィールド数を指定します。

設定値

内容

0

タグフィールド数によりファイルを自動分割しない

1以上

タグの数が指定した最大タグフィールド数を超えた場合、自動的にファイルを分割

 

hint

<設定例>

CsvFileName=DB\RAW\SMR_RAW_.csv

CsvFileMaxFields=255

上例の場合、例えば、タグフィールドマスターファイルに保存されたタグフィールドの数が1000個の場合、4つのファイルに分割され以下のファイル名で保存されます。

最初の255個

:SMR_RAW_0_20100101.csv

次の255個

:SMR_RAW_1_20100101.csv

次の255個

:SMR_RAW_2_20100101.csv

残りの235個

:SMR_RAW_3_20100101.csv

 

CSVファイルの実際のフィールド数は時刻フィールドが追加されるため、上例の個数に1プラスした値になります。

ファイル名の後に、分割されたファイルのインデックスが自動的に付加されます。CsvFileMaxFieldsを指定しないと、インデックス番号はファイル名に付加されません(つまりSMR_RAW_20100101.csvとなる)。

集計ログではCsvFileMaxFieldsは指定しません。集計ログの最大タグフィールド数は親となるルートログの指定に従います。

 

CsvFileFlushCount

(1)

CSV

 

CSVファイルのフラッシュ設定。

設定値

内容

0

フラッシュのタイミングは、OSやハードウェアの仕様に依存して書込

1以上

指定したレコード数毎にハードディスクの物理領域に書込

 

OdbcTable

(指定無し)

ODBC

必須

ルートログを保存するODBCデータベースのテーブル名。

 

<設定例>

OdbcTable=RAW

 

OdbcMaxFields

(0)

ODBC

 

1テーブルあたりの最大タグフィールド数を指定します。

設定値

内容

0

タグフィールド数によりテーブルを自動分割しない

1以上

タグの数が指定した最大タグフィールド数を超えた場合、自動的にテーブルを分割

 

hint

<設定例>

OdbcTable=RAW

OdbcMaxFields=500

上例の場合、タグフィールドマスターファイルに保存されたタグフィールドの数が例えば1000個の場合、2つのテーブルに分割されて保存されます。

最初の500個

:RAW0

残りの500個

:RAW1

 

実際のテーブル内のフィールド数は時刻フィールドが追加されるため、上例の個数に1プラスした値になります。

テーブル名の後に、分割されたファイルのインデックスが自動的に付加されます。OdbcMaxFieldsを指定しないと、インデックス番号はテーブル名に付加されません(つまり「RAW」というテーブルに保存される)。

集計ログではOdbcMaxFieldsは指定しません。集計ログの最大タグフィールド数は親となるルートログの指定に従います。

 

 

ルートログセクションの設定例

例)CSVファイルへ保存する場合の最小設定

[RAW]

TagFieldMaster=fieldmaster_tag.csv

TagFieldIndex=DB\index_tag.txt

CsvFileName=DB\LOG01\LOG.csv

CsvFileMaxFields=1000

 

例)ODBCデータベース(Microsoft SQL Server)へ保存する場合の最小設定

[RAW]

TagFieldMaster=fieldmaster_tag.csv

TagFieldIndex=DB\index_tag.txt

OdbcTable=RAW

OdbcMaxFields=500

 

例)計算フィールドを使用する場合の追加項目

[RAW]

  ・・・

CalculationFieldMaster=fieldmaster_calculation.csv

CalculationFieldIndex=DB\index_calculation.txt

  ・・・