Versions Compared

Old Version 1

changes.mady.by.user Nadja Pollard

Saved on

compared with

New Version 2

changes.mady.by.user Nadja Pollard

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This section includes the following topic:

Anchor
ManagingAlertswithCLI
ManagingAlertswithCLI
Managing Alerts with CLI

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

  1. Use the relevant parameters file. To select one, see Parameter Files on page 131.
  2. 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.


Precise. Performance intelligence from click to storage. Learn more > >

...