Versions Compared

Key

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

...

Anchor
AboutRoleManagementInAlerts
AboutRoleManagementInAlerts
About role management in Alerts

...

Old / NewCriticalNear-CriticalNormalNot sampled
CriticalDo not issueIssueIssueIssue
Near-CriticalIssueDo not issueIssueIssue
NormalIssueIssueDo not issueIssue
Not SampledIssueIssueDo not issueDo not issue

Anchor
EmailActionProperties
EmailActionProperties
Email action properties

Use the Email Action Type to set the email address of the recipient and the message text that will be sent when an alert is raised by the specified metric.

...

The $METRIC_NAME metric exceeded its $METRIC_ALERT threshold. The metric's valie value was: $METRIC_VALUE. The metric's thresholds are:$THRESHOLDS.

...

  1. From the Actions tab on the Metric Properties dialog, select the email option on the Action Type list box.
  2. Select the email action you want to edit.
  3. Click Delete.

Anchor
MessageActionProperties
MessageActionProperties
Message action properties

Use the Message Action Type to set the text message that will be displayed on every screen with an open Alerts user interface, when an alert is raised by the specified metric. The message text can also include dynamic parameters.

...

  1. From the Actions tab on the Metric Properties dialog, select the message option on the Action Type list box.
  2. Select the message action you want to edit.
  3. Click Delete.

Anchor
ProgramActionProperties
ProgramActionProperties
Program action properties

Use the Program Action Type to set your program to be ran as an action when an alert is raised by the specified metric.

...

  1. From the Actions tab on the Metric Properties dialog, select the program option on the Action Type list box.
  2. Select the program action you want to edit.
  3. Click Delete.

Anchor
SNMPActionProperties
SNMPActionProperties
SNMP action properties

Use the SNMP Action Type to set alerts to be reported to an SNMP based management tool that you may have, such as CA Unicenter® and HP OpenView.

...

  1. From the Actions tab, select the SNMP option on the Action Type list box.
  2. To apply SNMP traps, check Send an SNMP trap whenever the metric alert level changes.
  3. To test your definitions, click Test.
  4. To save your definitions, choose whether to save them either for the selected instance, or for all the environments’ instances. Then click Save and Close.

Anchor
MOMActionProperties
MOMActionProperties
MOM action properties

Use the MOM Action Type to set alerts to be reported to the MOM server whenever the metric alert level changes.

...

Dynamic parameterDefinition
$METRIC_NAMEName of the metric.
$METRIC_SETName of the metric set.
$TECHNOLOGY_NAMEName of the instance technology.
$INSTANCE_NAMEName of the instance sampled by the metric.
$APPTIER_NAMEName of one of the AppTiers to which the instance applies.
$APPTIERS_NAMECorrelated to $ENVIRONMENT_NAME.
$ENVIRONMENT_NAMEName of one of the environments to which the instance applies.
$ENVIRONMENTS_NAMEName of one of the environments to which the instance applies.
$METRIC_ALERTThe alert severity level of the metric that was issued when the action was activated.
$SAMPLE_REASON

Reason of the sample that caused the action. The reasons can be one of the following:

  • Schedule. A regular sample, which is initiated according to the sampling schedule.
  • Resample. A sample initiated by clicking the Resample button.
  • Restart. A sample of pre-configured metrics after InformPoint restarts.
  • Resample As Startup. A sample of pre-configured metrics after Alerts FocalPoint restarts.
  • Resample By Demand. A sample due to a change in the instance’s availability (for example, if the monitored Oracle database was shutdown, the Oracle Availability metric will be resampled by demand).
$ITEMSHas been deprecated (will not be used in future versions). Use $METRIC_VALUE instead.
$METRIC_VALUE
  • For Single value metrics:
    Value returned by the metric that was issued when the action was activated.
  • For list metrics:
    List of items returned by the metric sampling. The format of the returned string is as follows:
    Tab-delimited in Email and Message actions.
    Underscore-delimited in Program actions.
$METRIC_TIMEThe time of the last actual sampling.
$SAMPLE_RANGE_START_TIMEThe sampling period start time of the last sample.
$SAMPLE_RANGE_END_TIMEThe sampling period end time of the last sample.
$METRIC_PROGRESSProgress status of the metric.
$PROGRESS_UPDATING_USERRole name of last user that modified the progress status of the metric.
$PROGRESS_UPDATE_TIMETime of the last update of the progress status of the metric.
$THRESHOLDSWarning (near critical) and Critical threshold values defined for the metric. Relevant only for a metric with sub-metrics.
$NEAR_CRITICAL_THRESHOLDWarning (near critical) threshold value defined for the metric. Relevant only for a metric with no sub-metrics.
$CRITICAL_THRESHOLDCritical threshold value defined for the metric. Relevant only for a metric with no sub-metrics.
$SERVER_MACHINE_NAMEName of the server machine on which the instance is running.
$SAMPLING_RATESampling rate of the metric.
$SAMPLING_PERIODSampling period of the metric.
$MIN_VALUEMinimum value that is acceptable for the metric.

 

An example for using dynamic parameters in Email or Message actions can be found in the Message text box in the Email tab (default message).

...

The following examples are provided:•    action

  • action_example.bat (for Windows). To activate this file, set the following command line:
    • action_example.bat $METRIC_ALERT $METRIC_TIME $METRIC_NAME $METRIC_VALUE

...

  • action_example.sh (for Linux or UNIX). To activate this file, set the following command line:
    • action_example.sh $METRIC_ALERT $METRIC_TIME $METRIC_NAME $METRIC_VALUE

For both examples, when Alerts activates the file, it writes to a log file information about the alert, which can be helpful for troubleshooting alerts. The log file name is action_example.log and it contains the following text:

...

<$METRIC_VALUE result>.

See “Email action properties” on page 171. See “Message action properties” on page 172. See “Program action properties” on page 173. See “SNMP action properties” on page 174. See “MOM action properties” on page 174. Email action properties, Message action properties, Program action properties, SNMP action properties, and MOM action properties.

Anchor
AboutSettingAlertsSNMP
AboutSettingAlertsSNMP
About setting Alerts SNMP connectivity

SNMP (Simple Network Management Protocol) is the Internet standard protocol for network management software. Alerts supports connectivity to an SNMP Framework using the following Protocol Data Unit (PDU) operations:

  • SNMP get

...

  • Operation. Alerts FocalPoint can receive SNMP Get requests from an SNMP manager to read the Precise

...

  • Alerts database accordingly.
  • SNMP trap

...

  • operation. When Alerts SNMP server is enabled for actions, Alerts sends SNMP traps to your SNMP

...

  • manager in case an alert state is raised or resolved.

SNMP Get Operation

Alerts has an extended user interface, allowing you to set metric definitions and to view the samples results. However, you may want to use your SNMP manager to receive metric specific data from Alerts.

To enable this option, first create a Management Information Bases (MIB) file. The MIB file maps the Alerts database entities, such as the various environments, various instances, and the metrics relevant for each of the instances. Because different sites have different environments, instances, and so on, you must adjust the Alerts MIB file to each site.

Creating an MIB file

Alerts FocalPoint creates the MIB file and displays its status (success or failure) on the standard output. The newly created MIB file name is InformForAlertsMib.mib and is stored in the following directory:<i3

<i3_

...

root>\products\pulse\userprograms

Information about the MIB creation process can be found in the log file:<i3

<i3_

...

root>\logs\alerts.mibbuilder.log

To create an MIB file•    On

  • On the server that Alerts FocalPoint is installed, run the following command, according to the server operating system, from the Precise root directory:

On a Windows NT

...

server. <i3_root>\products\pulse\pulsefocal\bin\ createalertsmib.bat

On a Linux or UNIX

...

server. <i3_root>/products/pulse/pulsefocal/bin/ createalertsmib.sh

Enabling the Get operation

To use your MIB browser to open the MIB file that you have created and browse the different metrics, you must set the Get parameters on both your SNMP manager and Alerts. The examples provided along with the following instructions relate to the CA Unicenter MIB browser, which is an SNMP management application.

To set the get parameters1.    Copy

  1. Copy the newly created MIB file (InformForAlertsMib.mib) to the SNMP server's MIBs directory.
    For example in CA-Unicenter:  <TND_root>\SERVICES\CONFIG\MIBS.

...

  1. Upload the MIB file to your SNMP MIB browser.
    For example in CA-Unicenter, run the following command from the TND directory
    <TND_root>\SERVICES\CONFIG\MIBS:
    ldmib -n oidprecise -m InformForAlertsMib.mib

...

  1. In the SNMP tab of Alerts Settings dialog box, set an available listening port in the SNMP port box. This port will receive the Get requests from your SNMP MIB browser. Also, set the SNMP version according to your MIB browser.

 

Browsing the Alerts MIB

Before you start browsing the Alerts MIB, it is recommended to be familiar with the following issues:

...

•    Identifying property fields in the MIB

•    MIB structure

Technology representation

The MIB tree shows the technologies of the Precise environment as the numbers 1 - 15. The table below shows how each number in a MIB tree is mapped to a technology.

...

<oldTrapStyle>YES</oldTrapStyle>

Anchor
AboutAlertsMOMConnectivity
AboutAlertsMOMConnectivity
About Alerts MOM connectivity

This section describes how to go about setting up Alerts for MOM connectivity.

...

Alerts is delivered with a set of predefined MOM alert actions for metrics monitored by Precise Microsoft technologies.

 

Anchor
AboutCreatingCustomizedMetrics
AboutCreatingCustomizedMetrics
About creating customized metrics

You can add customized metrics to an AppTier (excluding the Cross-AppTiers), or delete customized metrics.

...