6.3.17 Collecting condition definition file
The collecting condition definition file contains definitions of the resource collection status.
- Organization of this subsection
(1) Format
The following shows the format of the collecting condition definition file.
(2) Details of the collection target server definition
Write as many definitions as the number of collection target servers. This definition requires one or more definitions for the collected resource.
The following table shows the contents of the definition for the collection target server.
Key name |
Explanation |
---|---|
server |
Enter the collection target server name. Specify a server name, host name or IP address within 255 bytes. If you specify an IP address, use the IPv4 address or IPv6 address format. |
(3) Details of the collected resource definition
After the collection target server definition, write as many collected resource definitions as the number of resources to be collected by target server. You must write fields in the definition file in the order in which they are listed in the table below.
The following table shows the contents of the definition regarding collected resources.
Key name |
Explanation |
---|---|
rscid |
Specify the collection target resource ID. For details of the resource ID, see E. Resource IDs. |
stime |
Specify the collection start time for the resource. Specify this in the same format as the -stime option of the ssocolstart command. When the specification is omitted, or the specified collection start time has already passed, the collection will be started when the command is executed. |
ptime |
Specify the collection end time for the resource. Specify this in the same format as the -ptime option of the ssocolstart command. When both this key and the period key are omitted, this indicates that the resource collection condition will be collected indefinitely. Also, this key cannot be specified at the same time as the period key. |
period |
Specifies the resource collection end time, by the amount of time passed since the collection start time. Specify this in the same format as the -period option of the ssocolset command. When both this key and the ptime key are omitted, this indicates that the resource collection conditions will be collected indefinitely. Also, this key cannot be specified at the same time as the period key. |
stat_term_id <<1>> ((1 to 10)) |
Specify the time zone ID of the time zone for which to calculate the initial value of the statistical threshold. When collection starts, an initial value is calculated for the same time zone ID as that of regular calculation. For other time zone IDs, an initial value is calculated for a specific time zone ID when the time zone ID of regular calculation is switched to the same one as that of the specific time zone ID. Specify this definition item for each resource ID. |
stat_dbname |
Specify the name of a master database or collection database. |
stat_logfile |
Specify an absolute path as the file name.# |
stat_masterlog |
Specify the key name when you specify the master database on the local host. |
stat_stime ((1980.01.01.00.00.00 to 2099.12.31.23.59.59)) |
Specify the start time of the statistical period. When this key is omitted, the start time is the same as the start time specified for the collection database. You cannot specify the same time as that specified in stat_ptime. |
stat_ptime ((1980.01.01.00.00.00 to 2099.12.31.23.59.59)) |
Specify the end time of the statistical period. You cannot specify the same time as or an earlier time than the time specified in stat_ptime. |
stat_time_zone start time ((00:00:00 to 23:59:59)) end time ((00:00:01 to 24:00:00)) |
Specify the start time and end time of the time zone. Delimit each value with a semicolon (;). You can specify the start and end times for up to five time zones. When this key is omitted, no time zone is set and data will be extracted regardless of the time. An error occurs in the following cases:
|
Note the following for the definition concerning the initial value of the statistical threshold:
-
When omitting a definition item, omit the whole definition item, including the key name.
(4) Example
The following shows an example of a collecting condition definition file.
- Example of collection conditions definition file (defining the initial value calculation for a statistical threshold)