Alerts metrics

This section includes the following topic:

Managing Alerts with CLI

You can manage Precise Alerts using CLI. To manage alerts metrics using CLI

Use the relevant parameters file. To select one, see Parameter Files on page 131.
Run the following command:
Windows   infra\bin\psin_cli.bat
                   -action alerts-settings
                   -i3-user <user_name>
                   {-i3-encrypted-password <encrypted_password> | -i3-clear-password <clear_password>}
                   -parametersfile <path_to_parameters_file>
UNIX ./infra/bin/psin_cli.sh
                   -action alerts-settings
                   -i3-user <user_name>
                   {-i3-encrypted-password <encrypted_password> | -i3-clear-password <clear_password>}
                   -parametersfile <path_to_parameters_file>

The following are parameter files you can use to manage Alerts with CLI:

To enable/disable alerts metric use the following parameters file:

Table 12-1 Elements for Enabling/Disabling Alerts

Element	Description
metric-settings-action	Always enable-disable Mandatory: Yes
metric-set	The metric name. Values: string Mandatory: Yes
target-instance-server-name	The related instance server name Values: String Mandatory: Yes, if filter-instances-by-technology or filter-instances-by-environment are not set.
target-instance-name	The related instance name Values: string Mandatory: Yes, if filter-instances-by-technology or filter-instances-by-environment are not set.
target-instance-technology-code	The related instance technology code Values: String. For more information, see Technology Codes on page 174. Mandatory: Yes, if filter-instances-by-technology or filter-instances-by-environment are not set.
enable	Values: true/false Mandatory: Yes
filter-instances-by-technology	Required technology or a comma separated list. Values: String Mandatory: Only if specific target parameters are not used.
filter-instances-by-environment	Required application or a comma separated list. Values: String Mandatory: Only if specific target parameters are not used.

To set Alert Metrics Actions, use the following parameters file with some of the parameters described in Additional parameterson page 133.

Table 12-2 Elements for Setting Alerts Metrics Actions

Element	Description
metric-settings-action	Values: configure-actions Mandatory: Yes
metric-set	The metric name. Values: string Mandatory: Yes
target-instance-server-name	The related instance server name. Values: String Mandatory: Yes, if filter-instances-by-technology or filter-instances-by-environment are not set.
target-instance-name	The related instance name. Values: string Mandatory: Yes, if filter-instances-by-technology or filter-instances-by-environment are not set.
target-instance-technology-code	The related instance technology code Values: String. For more information, see Technology Codes on page 174. Mandatory: Yes, if filter-instances-by-technology or filter-instances-by-environment are not set.
filter-instances-by-technology	Required technology or a comma separated list. Values: String Mandatory: Only if specific target parameters are not used.
filter-instances-by-environment	Required environment or a comma separated list. Values: String Mandatory: Only if specific target parameters are not used.

Table 12-3 Elements for Additional parameters

Element	Description
action-type	Values: mail message program snmp mom Mandatory: Yes
action-email-address	Email address Values: string Mandatory: Yes, if action type is mail
action-alert-reoccurrence	Alerts recurrence level Values: Numeric Mandatory: Yes, if action type is mail
action-alert-level	Alert Level Values: one of critical or warning Mandatory: Yes, if action type is mail
action-email-content	Text of the email message Values: string Mandatory: Yes, if action type is mail
action-inform-mom-snmp-on-level-changing	Values: true/false Mandatory: Yes, if action type is mom/snmp
action-message-text	Values: string Mandatory: Yes, if action type is message
action-program	The program to run Values: string Mandatory: Yes, if action type is program
action-program-server	The server to run the program on Values: string Mandatory: Yes, if action type is program
action-inform-mom-snmp-on-level-changing	Values: true/false Mandatory: Yes, if action type is program

To clear Alerts Actions, use the following parameters file:

Table 12-4 Elements for Clearing Alerts Actions

Element	Description
metric-settings-action	Always remove-actions Mandatory: Yes
metric-set	The metric name. Values: string Mandatory: Yes
target-instance-server-name	The related instance server name Values: String Mandatory: Yes, if filter-instances-by-technology or filter-instances-by-environment are not set.
target-instance-name	The related instance name Values: string Mandatory: Yes, if filter-instances-by-technology or filter-instances-by-environment are not set.
target-instance-technology-code	The related instance technology code Values: String. For more information, see Technology Codes on page 174. Mandatory: Yes, if filter-instances-by-technology or filter-instances-by-environment are not set.
action-types	Values: mail message program snmp mom Mandatory: Yes
filter-instances-by-technology	Required technology or a comma separated list. Values: String Mandatory: Only if specific target parameters are not used.
filter-instances-by-environment	Required application or a comma separated list. Values: String Mandatory: Only if specific target parameters are not used.