Current event object attributes for notifications from Global Manager

Current event object attributes for events from the Global Manager describes the attributes contained in current event objects in the Notification Adapter generated by the Service Assurance Global Manager. When customizing the notification adapters, combine these attributes to include the specific information you require regarding each notification.

All attributes for timestamps represent units of time in seconds. The attribute’s value is the number of seconds since January 31, 1970 (Greenwich Mean Time, GMT).

Table 1. Current event object attributes for events from the Global Manager

Notification attribute	Type	Description
icAcknowledged	Boolean	TRUE if the notification is acknowledged, FALSE if not.
icActive	Boolean	TRUE if the event is active, FALSE if not.
icCategory	String	Type of notification sent by the Global Manager. For example: Availability Discovery Error Operational Performance PowerSupply Resource Temperature
icCertainty	Float	Confidence that this notification is the correct diagnosis. Value ranges from 0 to 100.
icClass	String	Class of the object triggering the event.
icClassDisplayName	String	The display class name of the object triggering the event.
icDisplayName	String	Display name for the instance that triggered this event. This value is the same as icInstanceDisplayName.
icDisplayType	String	Display string of the notification type that abstracts the difference between the notifications from the Global Manager and the events from the Domain Manager (for example, NOTIFY, CLEAR, and TIMER_ALARM). Note: The icType field contains the detailed type information.
icElementClassName	String	Class name of the managed element most closely related to this event. The attribute’s value may be an empty string.
icElementName	String	Name of the managed element most closely related to this event. The attribute’s value may be an empty string.
icEvent	String	Event name such as DOWN or NOT RESPONDING.
icEventDescription	String	Description of the event.
icEventDisplayName	String	The event name. This has the same value as icEvent.
icEventType	String	The event type. The valid event types are: MOMENTARY DURABLE
icFirstNotifiedAt	Integer	Timestamp of the first notification.
icId	String	A unique identification for this notification. As previously-received notifications are cleared (NL_CLEAR), these new messages have the same ID as the original notification (NL_NOTIFY). Customizations to the ASL scripts that need to match such messages should use this attribute.
icImpact	Integer	Numeric value that indicates the effect of this event on related elements.
icInMaintenance	Boolean	TRUE if the device is in maintenance mode, FALSE if not.
icInstance	String	Instance name of the object that triggered the event.
icInstanceDisplayName	String	Display name for the instance triggering this event. This value is the same as icDisplayName.
icIsRoot	Boolean	TRUE if the notification is a root cause; FALSE if not.
icIsProblem	Boolean	Yes indicates if (and only if) at least one of the source event types is “PROBLEM”, and other source event types are either “PROBLEM” or “UNKNOWN.” No indicates that one or more of the source event types is “EVENT” or “AGGREGATE.” Since filtering on IsRoot can result in transient behavior when events are received from multiple underlying sources, it is recommended to filter on IsProblem instead.
icLastChangedAt	Integer	Timestamp, in seconds, when the notification was last changed.
icLastClearedAt	Integer	Timestamp, in seconds, when the notification was last cleared.
icLastNotifiedAt	Integer	Timestamp when the Global Manager was last notified of the occurrence of this notification.
icNLObjectName	String	The object name of the notification list that generated this notification.
icNotificationName	String	Name of the notification object. It can be used to retrieve additional information about the notification not sent to the adapter by default.
icOccurrenceCount	Integer	Number of times the notification occurred.
icOwner	String	Name of the person responsible for this notification. Value is SYSTEM when acknowledged by the Global Manager.
icServerName	String	Name of the VMware Manager to whom the adapter listens.
icSeverity	Integer	Level of severity for the notification: 1 = CRITICAL 2 = MAJOR 3 = MINOR 4 = UNKNOWN 5 = NORMAL Note: Only the numbers, not the text descriptions are contained in this attribute.
icSourceDomainName	String	A comma-separated list of sources for this notification. These are names of the underlying notifying sources. There may be more than one in case underlying sources have an overlapping topology.
icSourceEventType	String	Indicates the type of event from an underlying source or sources. Value can be: PROBLEM, EVENT, AGGREGATE, or UNKNOWN. The default value is UNKNOWN. (Not to be confused with Event Type.)
icSystemDescription	String	Description of the system specified in the icSystemName field.
icSystemName	String	The display name of the computer system most closely associated with the event. In cases where there is no relevant system, the attribute’s value will be an empty string.
icSystemType	String	Type of the system specified in icSystemName field. The attribute’s value may be an empty string, the DisplayClassName of the system’s class, or one of the system’s class such as HOST, ROUTER, or SWITCH.
icTimestamp	Integer	The time when the Global Manager notifies a client that a change occurred for the notification. For the Global Manager, note that the following attributes are typically used instead of icTimestamp: icFirstNotifiedAt, icLastChangedAt, icLastClearedAt, and icLastNotifiedAt.
icTroubleTicketId	String	Trouble ticket ID.
icType	String	Notification Type. The valid types are: NL_NOTIFY NL_CHANGE NL_CLEAR NL_DELETE TIMER_ALARM Note: Now the notification adapters do not send notifications for NL_CHANGE or NL_DELETE event types. You cannot use an adapter to inform another application about notification changes or deletions.
icUserDefined1-10	String	Ten user-defined fields. Reserved for custom configuration.