7.5.5 threshold

This section may appear more than once, and for every section more than one threshold can be configured because the thresholds can be assigned to an interface, agent or section instance (thus group thresholds cannot be configured in this way). Similarly to the previously described cases, the parameters can be either mandatory or optional.

·       name: The name of the threshold, a mandatory parameter. The following variables can be used in the name value:

o   <name> parameter: it is automatically replaced by the system with name of the equipment to be created (that is, never with the name of the agent)

o   <description> parameter: it is replaced with the name of the measurement

o   <description_with_ifdescr> parameter: it is replaced with the name of the measurement and the Cisco specific interface description or the ifAlias, if the later ones exists and PVSR is not using the Cisco specific description for naming the interfaces (this is the default). Otherwise it is the same as <description>

·       description: The optional description field. The same variables can be used as in the case of the name parameter

·       type: The type of the threshold. If it is specified but the given type does not exist in the system yet, then it will be automatically created.

·       measurement: It identifies the measurement configuration of the template, mandatory parameter. It contains a letter and a number, where the number identifies the appropriate instance of the section. The possible values of the letter are:

o   F: traffic measurement within an interface section

o   H: error measurement within an interface section

o   C: carrier measurement within an interface section

o   O: other section

o   A: agent section

·       expression: Threshold expression, mandatory parameter. In the same format as it is used in threshold configuration, with the following differences. :

o   Instead of the DBID<Type character><database id>.IN and OUT, only the IN and OUT texts should be used

o   The expression must fit in a single line, a line break can be inserted with a _NEW_LINE_ character sequence

·       level: Alarm level, mandatory parameter, with Critical, Warning, Major or Minor values

·       quick_eval: If it is set to 1 then the threshold will be using the quick evaluation feature

·       when: The When parameter on the threshold definition interface, if it is not specified, then it is every day between 0-24 hrs

·       email: The E-mail parameter on the threshold definition interface. The e-mails should be provided as a comma separated list (of course it can also be blank). The system automatically searches the specified e-mail addresses in the admin user’s list of e-mail addresses, if the address does not exist in the system yet then it will be automatically created.

·       mobile_notification: The Mobile notification on the threshold definition interface. The notifications should be provided as a comma separated list (of course it can also be blank). If the recipient is a user then it must be presented in the form User + user name (and not the user login name); if the recipient is a mobile notification group then in the form Group + group name (similar to the threshold export result file content)

·       trap: The SNMP Trap parameter on the threshold definition interface, if it is not specified, then it is blank.

·       ext_command: The Command parameter on the threshold definition interface, if it is not specified, then it is blank.

·       always: The continually alarm parameter on the threshold definition interface. If yes, then 1, if not, then 0; by default it is 0.

Example:

[threshold1]

#the first 4 are mandatory, the others are the default

name=<name>:<description>

measurement=F2

expression=#IN>100 or _NEW_LINE_ IN<10#1#2#

level=Critical

email=balazs.szabo@netvisor.hu,baxi@netvisor.hu

always=0

[threshold2]

#the first 4 are mandatory, the others are the default

name=<name>:<description>

measurement=O1

expression=#IN>50#1#2#

level=Warning

when=Week days between 8 A.M. and 4 P.M.

trap=public@192.168.35.76:9162

always=1

[threshold3]

name=<description>

measurement=A1

expression=#IN<90#1#1#

level=Major

[threshold4]

name=<description>

measurement=A2

expression=#IN>5#1#1#

level=Minor

always=1