mirror of
https://github.com/rancher/rancher-docs.git
synced 2026-05-05 12:43:16 +00:00
122 lines
5.7 KiB
Markdown
122 lines
5.7 KiB
Markdown
---
|
|
title: Built-in Dashboards
|
|
---
|
|
|
|
<head>
|
|
<link rel="canonical" href="https://ranchermanager.docs.rancher.com/integrations-in-rancher/monitoring-and-alerting/built-in-dashboards"/>
|
|
</head>
|
|
|
|
## Grafana UI
|
|
|
|
[Grafana](https://grafana.com/grafana/) allows you to query, visualize, alert on and understand your metrics no matter where they are stored. Create, explore, and share dashboards with your team and foster a data driven culture.
|
|
|
|
To see the default dashboards for time series data visualization, go to the Grafana UI.
|
|
|
|
### Customizing Grafana
|
|
|
|
To view and customize the PromQL queries powering the Grafana dashboard, see [this page.](../../how-to-guides/advanced-user-guides/monitoring-alerting-guides/customize-grafana-dashboard.md)
|
|
|
|
### Persistent Grafana Dashboards
|
|
|
|
To create a persistent Grafana dashboard, see [this page.](../../how-to-guides/advanced-user-guides/monitoring-alerting-guides/create-persistent-grafana-dashboard.md)
|
|
|
|
### Access to Grafana
|
|
|
|
For information about role-based access control for Grafana, see [this section.](rbac-for-monitoring.md#role-based-access-control-for-grafana)
|
|
|
|
|
|
## Alertmanager UI
|
|
|
|
When `rancher-monitoring` is installed, the Prometheus Alertmanager UI is deployed, allowing you to view your alerts and the current Alertmanager configuration.
|
|
|
|
:::note
|
|
|
|
This section assumes familiarity with how monitoring components work together. For more information about Alertmanager, see [How Alertmanager Works.](how-monitoring-works.md#3-how-alertmanager-works)
|
|
|
|
:::
|
|
|
|
### Accessing the Alertmanager UI
|
|
|
|
The Alertmanager UI lets you see the most recently fired alerts.
|
|
|
|
:::note Prerequisite:
|
|
|
|
The `rancher-monitoring` application must be installed.
|
|
|
|
:::
|
|
|
|
To see the Alertmanager UI,
|
|
|
|
1. In the upper left corner, click **☰ > Cluster Management**.
|
|
1. On the **Clusters** page, go to the cluster where you want to see the Alertmanager UI, click **Explore**.
|
|
1. In the left navigation bar, click **Monitoring**.
|
|
1. Click **Alertmanager**.
|
|
|
|
**Result:** The Alertmanager UI opens in a new tab. For help with configuration, refer to the [official Alertmanager documentation.](https://prometheus.io/docs/alerting/latest/alertmanager/)
|
|
|
|
For more information on configuring Alertmanager in Rancher, see [this page.](../../how-to-guides/advanced-user-guides/monitoring-v2-configuration-guides/advanced-configuration/alertmanager.md)
|
|
|
|
<figcaption>The Alertmanager UI</figcaption>
|
|
|
|

|
|
|
|
|
|
### Viewing Default Alerts
|
|
|
|
To see alerts that are fired by default, go to the Alertmanager UI and click **Expand all groups**.
|
|
|
|
|
|
## Prometheus UI
|
|
|
|
By default, the [kube-state-metrics service](https://github.com/kubernetes/kube-state-metrics) provides a wealth of information about CPU and memory utilization to the monitoring application. These metrics cover Kubernetes resources across namespaces. This means that in order to see resource metrics for a service, you don't need to create a new ServiceMonitor for it. Because the data is already in the time series database, you can go to the Prometheus UI and run a PromQL query to get the information. The same query can be used to configure a Grafana dashboard to show a graph of those metrics over time.
|
|
|
|
To see the Prometheus UI, install `rancher-monitoring`. Then:
|
|
|
|
1. In the upper left corner, click **☰ > Cluster Management**.
|
|
1. On the **Clusters** page, go to the cluster where you want to see the Prometheus UI and click **Explore**.
|
|
1. In the left navigation bar, click **Monitoring**.
|
|
1. Click **Prometheus Graph**.
|
|
|
|
<figcaption>Prometheus Graph UI</figcaption>
|
|
|
|

|
|
|
|
### Viewing the Prometheus Targets
|
|
|
|
To see what services you are monitoring, you will need to see your targets. Targets are set up by ServiceMonitors and PodMonitors as sources to scrape metrics from. You won't need to directly edit targets, but the Prometheus UI can be useful for giving you an overview of all of the sources of metrics that are being scraped.
|
|
|
|
To see the Prometheus Targets, install `rancher-monitoring`. Then:
|
|
|
|
|
|
1. In the upper left corner, click **☰ > Cluster Management**.
|
|
1. On the **Clusters** page, go to the cluster where you want to see the Prometheus targets and click **Explore**.
|
|
1. In the left navigation bar, click **Monitoring**.
|
|
1. Click **Prometheus Targets**.
|
|
|
|
<figcaption>Targets in the Prometheus UI</figcaption>
|
|
|
|

|
|
|
|
### Viewing the PrometheusRules
|
|
|
|
When you define a Rule (which is declared within a RuleGroup in a PrometheusRule resource), the [spec of the Rule itself](https://github.com/prometheus-operator/prometheus-operator/blob/master/Documentation/api.md#rule) contains labels that are used by Alertmanager to figure out which Route should receive a certain Alert.
|
|
|
|
To see the PrometheusRules, install `rancher-monitoring`. Then:
|
|
|
|
1. In the upper left corner, click **☰ > Cluster Management**.
|
|
1. On the **Clusters** page, go to the cluster where you want to see the visualizations and click **Explore**.
|
|
1. In the left navigation bar, click **Monitoring**.
|
|
1. Click **Prometheus Rules**.
|
|
|
|
You can also see the rules in the Prometheus UI:
|
|
|
|
<figcaption>Rules in the Prometheus UI</figcaption>
|
|
|
|

|
|
|
|
For more information on configuring PrometheusRules in Rancher, see [this page.](../../how-to-guides/advanced-user-guides/monitoring-v2-configuration-guides/advanced-configuration/prometheusrules.md)
|
|
|
|
## Legacy UI
|
|
|
|
For information on the dashboards available in v2.2 to v2.4 of Rancher, before the introduction of the `rancher-monitoring` application, see the [Rancher v2.0—v2.4 docs](https://github.com/rancher/rancher-docs/tree/main/archived_docs/en/version-2.0-2.4/explanations/integrations-in-rancher/cluster-monitoring/viewing-metrics.md).
|