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>
Parameter Files
The following are parameter files you can use to manage Alerts with CLI:
- Enabling/Disabling Alerts
- Setting Alerts Metrics Actions
- Clearing Alerts Actions
Enabling/Disabling Alerts
To enable/disable alerts metric use the following parameters file:
<parameter name="metric-settings-action" value="enable-disable" />
<parameter name="metric-set" value="Customized" />
<parameter name="target-instance-server-name" value="server1" />
<parameter name="target-instance-name" value="ORCL" />
<parameter name="target-instance-technology-code" value="OR" />
<parameter name="enable" value="true" />
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.
Setting Alerts Metrics Actions
To set Alert Metrics Actions, use the following parameters file with some of the parameters described in Additional parameterson page 133.
<parameter name="metric-settings-action" value="configure-actions" />
<parameter name="metric-set" value="Customized" />
<parameter name="target-instance-server-name" value="server1" />
<parameter name="target-instance-name" value="ORCL" />
<parameter name="target-instance-technology-code" value="OR" />
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.
Additional parameters
<parameter name="action-type" value="mail" />
<parameter name="action-email-address" value="arnold.layne@precise.com" />
<parameter name="action-alert-reoccurrence" value="1" />
<parameter name="action-alert-level" value="critical" />
<parameter name="action-email-content" value="Hello!" />
<parameter name="action-inform-mom-snmp-on-level-changing" value="true/false"/>
<parameter name="action-message-text" value="${text}"/>
<parameter name="action-program" value="${program path}"/>
<parameter name="action-program-server" value="alerts-focal/instance"/>
<parameter name="action-inform-mom-snmp-on-level-changing" value="true/false"/>
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 reoccurrence 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-changi ng 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-changi ng Values: true/false
Mandatory: Yes, if action type is program
Clearing Alerts Actions
To clear Alerts Actions, use the following parameters file:
<parameter name="metric-settings-action" value="remove-actions" />
<parameter name="metric-set" value="Customized" />
<parameter name="target-instance-server-name" value="server1" />
<parameter name="target-instance-name" value="ORCL" />
<parameter name="target-instance-technology-code" value="OR" />
<parameter name="action-types" value="MAIL" />
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.