docs/doc/source/fault-mgmt/kubernetes/fault-management-overview.rst

65 lines
2.7 KiB
ReStructuredText

.. yrq1552337051689
.. _fault-management-overview:
=========================
Fault Management Overview
=========================
An admin user can view |prod-long| fault management alarms and logs in order
to monitor and respond to fault conditions.
See :ref:`Alarm Messages <100-series-alarm-messages-starlingx>` for the list of
alarms and :ref:`Customer Log Messages
<200-series-log-messages-starlingx>`
for the list of customer logs reported by |prod|.
You can access active and historical alarms, and customer logs using the CLI,
GUI, REST APIs and |SNMP|.
To use the CLI, see :ref:`Viewing Active Alarms Using the CLI
<viewing-active-alarms-using-the-cli>` and :ref:`Viewing the Event Log Using the
CLI <viewing-the-event-log-using-the-cli>`.
Using the GUI, you can obtain fault management information in a number of
places.
.. _fault-management-overview-ul-nqw-hbp-mx:
- The Fault Management pages, available from
**Admin** \> **Fault Management** in the left-hand pane, provide access to
the following:
- The Global Alarm Banner in the page header of all screens provides the
active alarm counts for all alarm severities, see
:ref:`The Global Alarm Banner <the-global-alarm-banner>`.
- **Admin** \> **Fault Management** \> **Active Alarms**—Alarms that are
currently set, and require user action to clear them. For more
information about active alarms, see :ref:`Viewing Active Alarms Using
the CLI <viewing-active-alarms-using-the-cli>` and :ref:`Deleting an
Alarm Using the CLI <deleting-an-alarm-using-the-cli>`.
- **Admin** \> **Fault Management** \> **Events**—The event log
consolidates historical alarms that have occurred in the past, that
is, both set and clear events of active alarms, as well as customer
logs.
For more about the event log, which includes historical alarms and
customer logs, see :ref:`Viewing the Event Log Using Horizon
<viewing-the-event-log-using-horizon>`.
- **Admin** \> **Fault Management** \> **Events Suppression**—Individual
events can be put into a suppressed state or an unsuppressed state. A
suppressed alarm is excluded from the Active Alarm and Events displays.
All alarms are unsuppressed by default. An event can be suppressed or
unsuppressed using the Horizon Web interface, the CLI, or REST APIs.
- The Data Network Topology view provides real-time alarm information for
data networks and associated worker hosts and data/pci-passthru/pci-sriov
interfaces.
.. xreflink For more information, see |datanet-doc|: :ref:`The Data Network Topology View <the-data-network-topology-view>`.
To use SNMP, see :ref:`SNMP Overview <snmp-overview>`.