Interface AlarmDescription
- All Superinterfaces:
SerializableAsMap
An AlarmDescription is a hierarchical representation of a textual description of an
Alarm
.
An AlarmHandler
specialized in notifying external systems about an alarm should structure this content into
a format that is supported and makes sense to the receiving system.- Since:
- 5.2.0
-
Nested Class Summary
Nested ClassesModifier and TypeInterfaceDescriptionstatic class
An ImpactedResourceGroup contains a set of String identifiers for impacted resources grouped by some common category or trait. -
Method Summary
Modifier and TypeMethodDescriptionasMap()
Returns a map of the entire description that can be used for json serializations and similar.Returns a Markdown serialization of this AlarmDescription.Returns a brief description of theAlarm
; useful as a headline or for when there are hard size limitations on the information that can be sent or handled.Returns a dashboard link to a detailed information page about theAlarm
in the administration web user interface.Returns a detailed description of theAlarm
.Returns a map of descriptions of the resources impacted by this alarm, organized by resource type.Returns a list of suggested actions for troubleshooting and resolving theAlarm
.
-
Method Details
-
getDashboardLink
Returns a dashboard link to a detailed information page about theAlarm
in the administration web user interface. Will returnnull
, if the administration web user interface is not enabled and an admin base-url is not defined.- Returns:
- a dashboard link to the alarm, or
null
-
getBriefDescription
String getBriefDescription()Returns a brief description of theAlarm
; useful as a headline or for when there are hard size limitations on the information that can be sent or handled.- Returns:
- a brief description
-
getDetailedDescription
Returns a detailed description of theAlarm
. The detailed description may contain multiple paragraphs, each represented by a String element in the returned list.- Returns:
- a List of detailed description paragraphs
-
getImpactedResources
Map<ResourceType,AlarmDescription.ImpactedResourceGroup> getImpactedResources()Returns a map of descriptions of the resources impacted by this alarm, organized by resource type.- Returns:
- a Map of
AlarmDescription.ImpactedResourceGroup
objects, grouped byResourceType
-
getSuggestedActions
Returns a list of suggested actions for troubleshooting and resolving theAlarm
.- Returns:
- a List of suggested actions
-
asMarkdown
String asMarkdown()Returns a Markdown serialization of this AlarmDescription.- Returns:
- a Markdown serialization of this AlarmDescription
-
asMap
Returns a map of the entire description that can be used for json serializations and similar.- Specified by:
asMap
in interfaceSerializableAsMap
- Returns:
- a map of the description
-