Available as of v2.2.0

After you’ve enabled monitoring at either the cluster level or project level, you will want to be start viewing the data being collected. There are multiple ways to view this data.

Rancher Dashboard

Note: This is only available if you’ve enabled monitoring at the cluster level. Project specific analytics must be viewed using the project’s Grafana instance.

Rancher’s dashboards are available at multiple locations:

  • Cluster Dashboard: From the Global view, navigate to the cluster.
  • Node Metrics: From the Global view, navigate to the cluster. Select Nodes. Find the individual node and click on its name. Click Node Metrics.
  • Workload Metrics: From the Global view, navigate to the project. From the main navigation bar, choose Resources > Workloads. (In versions prior to v2.3.0, choose Workloads on the main navigation bar.) Find the individual workload and click on its name. Click Workload Metrics.
  • Pod Metrics: From the Global view, navigate to the project. Select Workloads > Workloads. Find the individual workload and click on its name. Find the individual pod and click on its name. Click Pod Metrics.
  • Container Metrics: From the Global view, navigate to the project. From the main navigation bar, choose Resources > Workloads. (In versions prior to v2.3.0, choose Workloads on the main navigation bar.) Find the individual workload and click on its name. Find the individual pod and click on its name. Find the individual container and click on its name. Click Container Metrics.

Prometheus metrics are displayed and are denoted with the Grafana icon. If you click on the icon, the metrics will open a new tab in Grafana.

Within each Prometheus metrics widget, there are several ways to customize your view.

  • Toggle between two views:
    • Detail: Displays graphs and charts that let you view each event in a Prometheus time series
    • Summary Displays events in a Prometheus time series that are outside the norm.
  • Change the range of the time series that you’re viewing to see a more refined or expansive data sample.
  • Customize the data sample to display data between specific dates and times.

When analyzing these metrics, don’t be concerned about any single standalone metric in the charts and graphs. Rather, you should establish a baseline for your metrics over the course of time, e.g. the range of values that your components usually operate within and are considered normal. After you establish the baseline, be on the lookout for any large deltas in the charts and graphs, as these big changes usually indicate a problem that you need to investigate.

Grafana

If you’ve enabled monitoring at either the cluster level or project level, Rancher automatically creates a link to Grafana instance. Use this link to view monitoring data.

Grafana allows you to query, visualize, alert, and ultimately, understand your cluster and workload data. For more information on Grafana and its capabilities, visit the Grafana website.

Authentication

Rancher determines which users can access the new Grafana instance, as well as the objects they can view within it, by validating them against the user’s cluster or project roles. In other words, a user’s access in Grafana mirrors their access in Rancher.

Accessing Grafana from the Grafana Instance

  1. From the Global view, navigate to the cluster that you want to access Grafana.

  2. From the main navigation bar, choose Apps. In versions prior to v2.2.0, choose Catalog Apps on the main navigation bar.

  3. Find the application based on what level of metrics you want to view:

    • Cluster Level: Find the cluster-monitoring application.
    • Project Level: Find the project-monitoring application.
  4. Click the /index.html link. You will be redirected to a new webpage for Grafana, which shows metrics for either the cluster or project depending on which application you selected.

  5. Sign in to Grafana. The default username is admin and the default password is admin. For security, Rancher recommends changing the default password after logging in.

Results: You will be logged into Grafana from the Grafana instance. After logging in, you can view the preset Grafana dashboards, which are imported via the Grafana provisioning mechanism, so you cannot modify them directly. For now, if you want to configure your own dashboards, clone the original and modify the new copy.