7.7.5.3 DESCRIBE ALERTHISTORY

Purpose

The DESCRIBE ALERTHISTORY command displays a list of attributes for the ALERTHISTORY object type.

Syntax

DESCRIBE ALERTHISTORY

Usage Notes

The attributes for the DESCRIBE ALERTHISTORY command can include the following:

• alertAction: Recommended action to perform for this alert
• alertDescription: Description for the alert
• alertMessage: Brief explanation of the alert
• alertSequenceID: Unique sequence ID for the alert. When an alert changes its state, such as warning to critical or critical to clear, another occurrence of the alert is created with the same sequence number and a time stamp of the transition.
• alertShortName: Abbreviated name for the alert. If the alert is based on a metric, then the short name is the same as the corresponding metric name attribute.

• alertType: Type of the alert. Values are stateful or stateless.

  • Stateful alerts are automatically cleared on transition to normal.
  • Stateless alerts are never cleared. You can change the alert by setting the examinedBy attribute.
• beginTime: Time stamp when an alert changes its state
• endTime: Time stamp for the end of the period when an alert changes its state
• examinedBy: Administrator who reviewed the alert
• failedMail: Intended e-mail recipient when a notification failed
• failedSNMP: Intended SNMP subscriber when a notification failed
• metricObjectName: Object, such as cell disk or grid disk, for which a metric threshold has caused an alert
• metricValue: Value of the metric that caused the alert
• name: Unique identifier for the alert

• notificationState: Number indicating progress in notifying subscribers to alert messages:

  • 0, or "non-deliverable": Never tried
  • 1, or "sent": Sent successfully
  • 2, or "attempting delivery": Retrying, up to 5 times
  • 3, or "delivery failed": Retry failed 5 times
  • 4, or "creating diagpack": The diagnostic packaging and the outgoing alert email are still pending for this alert. It is used by MS to keep track of the alerts that have not been processed or are being processed. This enables MS, in the event of a restart, to continue processing alerts with state 4 and send the alert email.
• sequenceBeginTime: Time stamp when an alert sequence ID is first created
• serviceRequestLink: The URL to the service request associated with the alert
• serviceRequestNumber: The service request number associated with the alert

• severity: Severity level. Values are:

  • clear
  • info
  • warning
  • critical

Example 7-96 Describing the ALERTHISTORY Object

CellCLI> DESCRIBE ALERTHISTORY

         name
         alertAction
         alertDescription
         alertMessage
         alertSequenceID
         alertShortName
         alertType
         beginTime
         endTime
         examinedBy              modifiable
         failedMail
         failedSNMP
         metricObjectName
         metricValue
         notificationState
         sequenceBeginTime
         serviceRequestLink
         serviceRequestNumber
         severity