Previous Topic: Searching for and Viewing EventsNext Topic: Normalized and Raw Event Types


Event Properties and Event Information

As an administrator, you search for and interact with events using the properties for the USM alert type. The valid properties appear when you right-click an Event Pattern field on the Event Search tab of the Event Policy dialog. Valid property values also appear for enumerated properties.

All USM alert properties are supported in searches, but many are optional properties that are not present in every event.

Use the lists of properties that follow to understand the information depicted by each property. Use the right-click menu in the Event Search tab to add properties to a search and add valid values for properties with enumerated values.

The properties present in every event that you can use in normalized event searches are as follows:

Note: For more information about USM alert properties, see the USM schema documentation on the CA SOI Bookshelf.

AlertedMdrProduct

Defines the domain manager that originated the event. The tooltip for each data source on the left pane displays this value as Connector Type.

The right-click menu in the event search tab displays these numeric values as domain manager names for increased usability. Always use the right-click menu to assign an AlertedMdrProduct value to avoid having to manually enter the numeric value.

Example: CA:09998 (Sample Connector)

AlertedMdrProdInstance

Defines the domain manager system that originated the event. This property is typically the host name of the system where the domain manager is installed. The tooltip for each data source on the left pane displays this value as Instance Name.

AlertedMdrElementID

Defines the unique identifier of the CI that originated the event.

AlertType

Defines the type of condition that the event reports. The most common valid values are Quality, Risk, Compliance, and Cost.

Severity

Defines the event severity.

Note: Even though events with severity values of normal and informational are returned in event searches and can participate in event policies, events with these severities cannot appear as alerts in the Operations Console.

Summary

Defines a summary description of the event.

You can include the following properties in event searches using the provided scoping controls for source and time. Therefore, they are typically not required in the actual event search pattern:

MdrProduct

Defines the domain manager that originated the event. The tooltip for each data source on the left pane displays this value as Connector Type.

The right-click menu in the event search tab displays these numeric values as domain manager names for increased usability. Always use the right-click menu to assign an MdrProduct value to avoid having to manually enter the numeric value.

Example: CA:09998 (Sample Connector)

MdrProdInstance

Defines the domain manager system that originated the event. This property is typically the host name of the system where the domain manager is installed. The tooltip for each data source on the left pane displays this value as Instance Name.

MdrElementID

Defines a unique identifier for the event.

OccurrenceTimestamp

Defines when the condition that caused the event occurred. This property uses the xs:dateTime format: YYYY-MM-DDTHH:MM:SS.SSS-Z.

ReportTimestamp

Defines when the event was created. This property uses the xs:dateTime format: YYYY-MM-DDTHH:MM:SS.SSS-Z.

The optional event properties that you can include in event searches are as follows. Not all events have these properties assigned, which would eliminate them from any search using these properties:

Note: When you select a property added to the usm-core2 update to the USM schema, it appears in the search pattern with a 'usm-core2:' prefix

AlertCategory

Defines a high-level category, such as Application, SystemAndStorage, and so on.

Assignee

Defines the Person CI to which the event is assigned in the following format: MdrProduct,MdrProdInstance,MdrElementID.

Note: Assigning an alert from the Operations Console does not affect this event value.

AssigneeUserName

Defines the user name or login ID of the person assigned to the alert, if known.

Comments

Defines comments associated with the alert.

ElapsedTime

Defines the duration over which a number of identical events occurred. This property uses the xs:duration format.

ExtendedMessage

Provides a complete alert message when the message is longer than the 1024 character length permitted by the Message property.

ExtensionNameValuePairs

Defines a comma-separated string of name-value pairs, where the name and value are separate by an equal (=) sign.

ImpactedEntities

Defines a semi-colon-separated list of CIs experiencing issues related to this event. This property can only have a value when the AlertType is Risk-RootCause, and is therefore the root cause impacting other CIs. Each impacted CI is listed using the following format: MdrProduct,MdrProdInstance,MdrElementID.

IsAcknowledgeable

Defines whether the event can be acknowledged.

IsAcknowledged

Defines whether the event is acknowledged.

Note: Acknowledging an alert from the Operations Console does not affect this event value.

IsClearable

Defines whether the event can be cleared when an equivalent normal severity event is received.

IsCleared

Defines whether the event is currently cleared.

Note: Clearing an alert from the Operations Console does not affect this event value.

Mapped Types

Defines a comma-separated list of types that identify the types in the domain manager whose instances are mapped when creating the USM instance.

Message

Defines a detailed description of the event.

MetricName

Defines an identifying name for a metric.

MetricDescription

Defines a description of a metric.

MetricType

Defines the metric type.

MetricUnitDefinition

Defines a unit of measure defined by the SI and IEC Technical Committee standards.

MetricDataType

Defines the data type of the metric.

MetricValue

Defines a value for a metric that crossed a threshold, or otherwise was the reason for the alert.

OriginApplication

Defines the name of the application where the alert originated.

OriginDnsName

Defines the fully qualified DNS name of the device where the alert originated.

OriginIPV4Address

Defines the IPv4 address of the device where the alert originated.

OriginIPV6Address

Defines the IPv6 address of the device where the alert originated.

RelatedAlerts

Defines a semi-colon-separated list of related events, which are events resulting from the same root cause. Each related event is listed using the following format: MdrProduct,MdrProdInstance,MdrElementID.

RelatedIncident

Defines the Incident CI created for this event in the following format: MdrProduct,MdrProdInstance,MdrElementID.

RelatedIncidentURL

Defines the URL of the Incident CI created for this event.

RepeatCount

Defines the number of identical events occurring within a specific time defined by the ElapsedTime property.

RetireTimestamp

Defines when the event is no longer relevant. For example, a maintenance time may only be in effect for one hour. This property uses the xs:dateTime format: YYYY-MM-DDTHH:MM:SS.SSS-Z.

SeverityTrend

Defines the current trend toward more or less severity.

Tags

Defines a comma-separated list of alert classifiers that are useful for visualization or query.

TenantID

Defines a tenant identifier.

UrlParams

Defines a URL to open the domain manager from which the event originated.