.. _c3_alerts_navigation:

*****************
Alerts navigation
*****************

.. _alerts_overview:

Alerts Overview page
--------------------

To access the Alerts Overview page, click the Alerts bell icon in the top banner. The icon appears in a light blue focus
thereafter until exiting the Alerts area.

.. image:: ../../images/c3-alerts-bell-icon-initial.png

The Alerts page has the following main sections, accessible by clicking the tabs:

- **HISTORY** - :ref:`Historical alert log <alert_history>`
- **TRIGGERS** - :ref:`trigger_mgmnt`
- **ACTIONS** - :ref:`actions_mgmnt`
- **REST API** - :ref:`integration_alerts`

.. figure:: ../../images/c3-alerts-submenus.png
   :width: 600px

.. _alert_history:

Alerts History
--------------

To access the Alerts History page, click the Alerts |bell| icon in the top banner.

The Alerts page opens to the History tab by default. The page is blank when there isn't any triggered history yet.

After actions have been triggered, the History page shows a summary of triggers that caused an action to be executed.

.. figure:: ../../images/c3-alerts-history.png
   :width: 600px

The History table shows the **Time** that the alert occurred, the **Trigger** that fired, the **Component**, and the
number of Actions that were activated in **Action Count**.

Click a link in the **Time** column to view more details for a triggered alert. Depending on the type of alert, there
could be both a chart and text or just text.

.. figure:: ../../images/c3-alert-history-detail.png
   :scale: 50%
   :alt: Triggered alert history detail

   Example triggered alert detail

The date and time the alert was triggered and the action that was sent for the trigger are displayed. The threshold
information for the trigger is provided.

The alert history does not list every triggered event:

- Any alerts triggered by consumer lag, cluster status, or broker status events do *not* populate history. Alert emails
  sent do *not* contain an email link to alerts history.
- Only alerts triggered by topic status events (streams topology) populate history. Alert emails are sent that contain
  an email link to alerts history, as configured in ``confluent.controlcenter.rest.listeners``.

.. |bell| image:: ../../images/c3-alerts-bell-icon.png