docs/doc/source/fault-mgmt/viewing-alarm-details-using-the-cli.rst
Stone 037c99f0b7 Fault Management doc
Added Data Networks toctree

Changed case on doc title in top level index - changed doc directory to
fault-mgmt.

Added Distributed Cloud section.

Broke out "OpenStack Fault Management Overview" statement about remote log
collection to conditionally included file.

Incorporated patch 6 review comments. Also implemented rST :abbr:
for first instance of SNMP in each file.

Changed port number and community string in two SNMP walk examples.

Change-Id: I1afd71265e752c4c9a54bf2dc9a173b3e17332a7
Signed-off-by: Stone <ronald.stone@windriver.com>
2020-11-27 14:13:00 -05:00

2.7 KiB

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.