starlingx/docs
Code Issues Proposed changes
47040fa69b
docs/doc/source/fault-mgmt/kubernetes/viewing-alarm-details-using-the-cli.rst
Ron Stone f125a8b892 Remove spurious escapes (r8,dsR8) 
This change addresses a long-standing issue in rST documentation imported from XML.
That import process added backslash escapes in front of various characters. The three
most common being '(', ')', and '_'.
These instances are removed.

Signed-off-by: Ron Stone <ronald.stone@windriver.com>
Change-Id: Id43a9337ffcd505ccbdf072d7b29afdb5d2c997e
2023-03-01 11:19:04 +00:00

2.7 KiB
Raw Blame History

View Alarm Details Using the CLI

You can view detailed information to help troubleshoot an alarm.

  • Use the following command to view details about an alarm.

    fm alarm-show <uuid>

    <uuid> is the ID of the alarm to query. Use the fm alarm-list to obtain UUIDs as described in Viewing Active Alarms Using the CLI <viewing-active-alarms-using-the-cli>.

    ~(keystone_admin)$ fm alarm-show 4ab5698a-19cb-4c17-bd63-302173fef62c
+------------------------+-------------------------------------------------+
| Property               | Value                                           |
+------------------------+-------------------------------------------------+
| alarm_id               | 100.104                                         |
| alarm_state            | set                                             |
| alarm_type             | operational-violation                           |
| entity_instance_id     | system=hp380-1_4.host=controller-0              |
| entity_type_id         | system.host                                     |
| probable_cause         | threshold-crossed                               |
| proposed_repair_action | /dev/sda3 check usage                           |
| reason_text            | /dev/sda3 critical threshold set (0.00 MB left) |
| service_affecting      | False                                           |
| severity               | critical                                        |
| suppression            | True                                            |
| timestamp              | 2014-06-25T16:58:57.324613                      |
| uuid                   | 4ab5698a-19cb-4c17-bd63-302173fef62c            |
+------------------------+-------------------------------------------------+

    The pair of attributes (alarm_id, entity_instance_id) uniquely identifies an active alarm:

    alarm_id

    An ID identifying the particular alarm condition. Note that there are some alarm conditions, such as administratively locked, that can be raised by more than one entity-instance-id.

    entity_instance_id

    Type and instance information of the object raising the alarm. A period-separated list of (key, value) pairs, representing the containment structure of the overall entity instance. This structure is used for processing hierarchical clearing of alarms.