Hitachi

JP1 Version 12 JP1/SNMP System Observer Description, Operator's Guide and Reference


6.3.19 Threshold verification definition file

In the threshold verification definition file, define the conditions for verifying thresholds.

Organization of this subsection

(1) Format

In a threshold verification definition file, you can write verification conditions for fixed and statistical thresholds together. The following shows the format of the threshold verification definition file.

[Figure]

(2) Details of resource definition

The table below describes the contents of the definitions concerning resources in the threshold verification definition file. You must write fields in the definition file in the order in which they are listed in the following table.

Key name

Value

rscid

Specify the resource ID of the verification object. If you specify multiple resource IDs, define all the necessary keys as separate key definitions.

stime

Specify the start time of verification object based on the information extracted from the database. Specifiable parameters are year, month, day, hour, minute, and second. If this key is omitted, the start time is the earliest time recorded among the extracted data.

ptime

Specify the end time of verification object based on the information extracted from the database. Specifiable parameters are year, month, day, hour, minute, and second. If this key is omitted, the end time is the latest time recorded among the extracted data.

col_range

start time ((00:00:00

to 23:59:59))

end time ((00:00:01

to 24:00:00))

Specify the time range of verification objects by specifying the start time and end time. Delimit hour, minute, and second values with a colon (:). Delimit start time and end time with a semicolon (;).

If you specify multiple points of time, write them continuously as separate key definitions. You can define this key up to five times.

stat_sum_time

((24 to 720))

Specify the total length of the time zones to calculate the statistical threshold.

stat_timing

Specify the time or interval to calculate the statistical threshold. If this key is omitted, the statistical threshold is calculated at intervals of 1 hour.

  • Time specification

    Specify the time to calculate in the hour:minute format. When you specify multiple points of time, delimit the time value with a comma (,). Specifiable values are from 0:00 to 23:59.

  • Interval specification

    Specify the interval of calculation in minutes (m) or hours (h) in a range from 15m to 24h. Specification of multiple intervals causes an error.

When coding a resource definition, note the following:

(3) Details of subresource and instance definition

The table below describes the contents of the definitions concerning subresources and instances in the threshold verification definition file. You must write fields in the definition file in the order in which they are listed in the following table.

Key name

Value

subrscid#

Specify the subresource ID of the verification object. Specification of a nonexistent subresource ID causes an error.

instance

((character string of up to 255 bytes))

Specify the instance name of the verification object instance by a character string of up to 255 bytes. You can specify multiple instance names successively to verify multiple instances.

threshold

  • For fixed threshold

    ((0, or floating decimal point between ±1.00 x 10-2 to ±1.7976931348623157 x 10308))

  • For statistical threshold

    <<99.95;99.99>> ((0.01 to 99.99))

  • For fixed threshold (when stat is not specified)

    Specify the thresholds for verification in the order of warning threshold first and then critical threshold, while delimiting each threshold with a semicolon (;). A threshold must be 0 or a floating point number from ±1.00 x 10-2 to ±1.7976931348623157 x 10308. If the mantissa of the number exceeds 1.7976931348623157, round it off. You can specify the same value for the warning and critical thresholds. When the same value is specified, the warning region is eliminated.

  • For statistical threshold (when stat is specified)

    After specifying stat, specify the ratios of data to be verified (as thresholds) in the order of warning threshold first and then critical threshold, delimiting each threshold with a semicolon (;). A threshold must be in the range from 0.01 to 99.99, and can be specified with up to 2 digits after the decimal point.

threshold_OVER

((1 to 99))

Specify the number of times the threshold can be exceeded continuously.

#

For the subresource IDs that are assigned to the subresources of user resources, see 6.3.14(6)(d) Subresource ID.

For the subresource IDs if the resources provided by SSO, see E. Resource IDs.

When coding a subresource and instance definition, note the following:

(4) Examples

The following shows examples of a threshold verification definition file.

Example of definitions in the threshold verification definition file (when fixed thresholds and multiple instances are specified)

[Figure]

Example of definitions in the threshold verification definition file (when fixed thresholds and multiple subresources are specified)

[Figure]

Example of definitions in the threshold verification definition file (when statistical thresholds are specified)

[Figure]

Example of definitions in the threshold verification definition file (when fixed and statistical thresholds are specified)

[Figure]