037c99f0b7
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>
11 KiB
11 KiB
View the Event Log Using the CLI
You can use CLI commands to work with historical alarms and logs in the event log.
Log in with administrative privileges.
$ source /etc/platform/openrcUse the
fm event-listcommand to view historical alarms' sets/clears and logs. By default, only unsuppressed events are shown.For more about event suppression, see
Events Suppression Overview <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 <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
--nopagingoption to avoid paging long event lists.In the following example, the
fm event-listcommand 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-listcommand 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 | | | | | | | | | +-------------+-------+-------+---------------------+---------------+----------+