View the Event Log Using the CLI¶
You can use CLI commands to work with historical alarms and logs in the event log.
Procedure
Log in with administrative privileges.
$ source /etc/platform/openrc
Use the fm event-list command to view historical alarms’ sets/clears and logs. By default, only unsuppressed events are shown.
For more about event suppression, see Events Suppression Overview.
The syntax of the command is:
fm event-list [-q <QUERY>] [-l <NUMBER>] [--alarms] [--logs] [--include_suppress]
Optional arguments:
-q QUERY, --query QUERY
- key[op]data_type::value; list. data_type is optional, but if supplied must be string, integer, float, or boolean.
-l NUMBER, --limit NUMBER
Maximum number of event logs to return.
--alarms
Show historical alarms set/clears only.
--logs
Show customer logs only.
--include\_suppress
Show suppressed alarms as well as unsuppressed alarms.
--uuid
Include the unique event UUID in the listing such that it can be used in displaying event details with fm event-show <uuid>.
-nopaging
Disable output paging.
For details on CLI paging, see CLI Commands and Paged Output.
For example:
[sysadmin@controller-0 ~(keystone_admin)]$ fm event-list -l 5 +-----------+-----+-----+--------------------+-----------------+---------+ |Time Stamp |State|Event|Reason Text |Entity Instance |Severity | | | |Log | |ID | | | | |ID | | | | +-----------+-----+-----+--------------------+-----------------+---------+ |2019-05-21T| set |100. |Platform Memory |host=controller-0|major | | 13:15:26. | |103 |threshold exceeded ;|numa=node0 | | | 464231 | | |threshold 80%,actual| | | | | | |80% | | | | | | | | | | |2019-05-21T| set | 100.|Platform Memory |host=controller-0|major | | 13:15:26. | | 103 |threshold exceeded; | | | | 456738 | | |threshold 80%,actual| | | | | | |80% | | | | | | | | | | |2019-05-21T|clear| 100.|Platform Memory |host=controller-0|major | | 13:07:26. | | 103 |threshold exceeded; |numa=node0 | | | 658374 | | |threshold 80%,actual| | | | | | |79% | | | | | | | | | | |2019-05-21T|clear| 100.|Platform Memory |host=controller-0|major | | 13:07:26. | | 103 |threshold exceeded; | | | | 656608 | | |threshold 80%,actual| | | | | | |79% | | | | | | | | | | |2019-05-21T| set | 100 |Platform Memory |host=controller-0|major | | 13:05:26. | | 103 |threshold exceeded; |numa=node0 | | | 481240 | | |threshold 80%,actual| | | | | | |79% | | | | | | | | | | +-----------+-----+-----+--------------------+-----------------+---------+
Note
You can also use the
--nopaging
option to avoid paging long event lists.In the following example, the fm event-list command shows alarms only; the State column indicates either set or clear.
[sysadmin@controller-0 ~(keystone_admin)]$ fm event-list -l 5 --alarms +-------------+-------+-------+--------------------+---------------+----------+ | Time Stamp | State | Event | Reason Text | Entity | Severity | | | | Log | | Instance ID | | | | | ID | | | | +-------------+-------+-------+--------------------+---------------+----------+ | 2019-05-21T | set | 100. | Platform Memory | host= | major | | 13:15:26. | | 103 | threshold exceeded | controller-0. | | | 464231 | | | ; threshold 80%, | numa=node0 | | | | | | actual 80% | | | | | | | | | | | 2019-05-21T | set | 100. | Platform Memory | host= | | | 13:15:26. | | 103 | threshold exceeded | controller-0 | major | | 456738 | | | ; threshold 80%, | | | | | | | actual 80% | | | | | | | | | | | 2019-05-21T | clear | 100. | Platform Memory | host= | | | 13:07:26. | | 103 | threshold exceeded | controller-0. | major | | 658374 | | | ; threshold 80%, | numa=node0 | | | | | | actual 79% | | | | | | | | | | | 2019-05-21T | clear | 100. | Platform Memory | host= | | | 13:07:26. | | 103 | threshold exceeded | controller-0 | major | | 656608 | | | ; threshold 80%, | | | | | | | actual 79% | | | | | | | | | | | 2019-05-21T | set | 100. | Platform Memory | host= | | | 13:05:26. | | 103 | threshold exceeded | controller-0. | major | | 481240 | | | ; threshold 80%, | numa=node0 | | | | | | actual 79% | | | | | | | | | | +-------------+-------+-------+--------------------+---------------+----------+
In the following example, the fm event-list command shows logs only; the State column indicates log.
[sysadmin@controller-0 ~(keystone_admin)]$ fm event-list -l 5 --logs +-------------+-------+-------+---------------------+---------------+----------+ | Time Stamp | State | Event | Reason Text | Entity | Severity | | | | Log | | Instance ID | | | | | ID | | | | +-------------+-------+-------+---------------------+---------------+----------+ | 2019-05-21T | log | 700. | Exited Multi-Node | subsystem=vim | critical | | 00:50:29. | | 217 | Recovery Mode | | | | 525068 | | | | | | | | | | | | | | 2019-05-21T | log | 700. | Entered Multi-Node | subsystem=vim | critical | | 00:49:49. | | 216 | Recovery Mode | | | | 979021 | | | | | | | | | | | | | | 2019-05-21T | log | 401. | Service group vim- | service | | | 00:49:31. | | 002 | services redundancy | _domain= | critical | | 205116 | | | restored | controller. | | | | | | | service_group | | | | | | | =vim- | | | | | | | services | | | | | | | | | | 2019-05-21T | log | 401. | Service group vim- | service | | | 00:49:30. | | 001 | services state | _domain= | critical | | 003221 | | | change from go- | controller. | | | | | | active to active on | service_group | | | | | | host controller-0 | =vim-services | | | | | | | .host= | | | | | | | controller-0 | | | | | | | | | | 2019-05-21T | log | 401. | Service group | service | | | 00:49:29. | | 002 | controller-services | _domain= | critical | | 950524 | | | redundancy restored | controller. | | | | | | | service | | | | | | | _group= | | | | | | | controller | | | | | | | -services | | | | | | | | | +-------------+-------+-------+---------------------+---------------+----------+