keycloak-scim/server_installation/topics/operator/monitoring-stack.adoc
Rex Peralta add5788151
Update monitoring-stack.adoc (#1225)
remove extraneous 'that' to fix grammar within the opening paragraph
2021-11-10 09:49:15 +01:00

56 lines
2.3 KiB
Text

[[_monitoring-operator]]
=== The {application_monitoring_operator}
Before using the Operator to install {project_name} or create components, we recommend that you install the {application_monitoring_operator}, which tracks Operator activity. To view metrics for the Operator, you can use the Grafana Dashboard and Prometheus Alerts from the {application_monitoring_operator}. For example, you can view metrics such as the number of controller runtime reconciliation loops, the reconcile loop time, and errors.
The {project_operator} integration with the {application_monitoring_operator} requires no action. You only need to install the {application_monitoring_operator} in the cluster.
==== Installing the {application_monitoring_operator}
.Prerequisites
* The {project_operator} is installed.
* You have cluster-admin permission or an equivalent level of permissions granted by an administrator.
.Procedure
. Install the {application_monitoring_operator} by using the link:{application_monitoring_operator_installation_link}[documentation].
. Annotate the namespace used for the {project_operator} installation. For example:
+
[source,bash,subs=+attributes]
----
{create_cmd_brief} label namespace <namespace> monitoring-key=middleware
----
. Log into the OpenShift web console.
. Confirm monitoring is working by searching for Prometheus and Grafana route in the `application-monitoring` namespace.
+
.Routes in OpenShift web console
image:{project_images}/operator-application-monitoring-routes.png[]
==== Viewing Operator Metrics
Grafana and Promotheus each provide graphical information about Operator activities.
* The Operator installs a pre-defined Grafana Dashboard as shown here:
+
.Grafana Dashboard
image:{project_images}/operator-graphana-dashboard.png[]
+
[NOTE]
====
If you make customizations, we recommend that you clone the Grafana Dashboard so that your changes are not overwritten during an upgrade.
====
* The Operator installs a set of pre-defined Prometheus Alerts as shown here:
+
.Prometheus Alerts
image:{project_images}/operator-prometheus-alerts.png[]
.Additional resources
For more information, see link:https://docs.openshift.com/container-platform/latest/monitoring/cluster_monitoring/prometheus-alertmanager-and-grafana.html[Accessing Prometheus, Alertmanager, and Grafana].