OpenShift docs are moving and will soon only be available at docs.redhat.com, the home of all Red Hat product documentation. Explore the new docs experience today.
  1. Documentation
    2. history
×

Accessing third-party UIs

Integrated Metrics, Alerting, and Dashboard UIs are provided in the OpenShift Container Platform web console. See the following for details on using these integrated UIs:

OpenShift Container Platform also provides access to the Prometheus, Alertmanager, and Grafana third-party interfaces. Dashboards for some additional platform components are included in Monitoring → Dashboards in the OpenShift Container Platform web console.

Default access to the third-party monitoring interfaces might be removed in future OpenShift Container Platform releases. Following this, you will need to use port-forwarding to access them.

The Grafana instance that is provided with the OpenShift Container Platform monitoring stack, along with its dashboards, is read-only. The Grafana dashboard includes Kubernetes and cluster-monitoring metrics only.

Accessing third-party monitoring UIs by using the web console

You can access the Alertmanager, Grafana, Prometheus, and Thanos Querier web UIs through the OpenShift Container Platform web console.

Prerequisites

  • You have access to the cluster as a user with the cluster-admin role.

Procedure

  1. In the Administrator perspective, navigate to Networking → Routes.

    Access to the third-party Alertmanager, Grafana, Prometheus, and Thanos Querier UIs is not available from the Developer perspective. Instead, use the Metrics UI link in the Developer perspective, which includes some predefined CPU, memory, bandwidth, and network packet queries for the selected project.

  2. Select the openshift-monitoring project in the Project list.

  3. Access a third-party monitoring UI:

    • Select the URL in the alertmanager-main row to open the login page for the Alertmanager UI.

    • Select the URL in the grafana row to open the login page for the Grafana UI.

    • Select the URL in the prometheus-k8s row to open the login page for the Prometheus UI.

    • Select the URL in the thanos-querier row to open the login page for the Thanos Querier UI.

  4. Choose Log in with OpenShift to log in using your OpenShift Container Platform credentials.

Accessing third-party monitoring UIs by using the CLI

You can obtain URLs for the Prometheus, Alertmanager, and Grafana web UIs by using the OpenShift CLI (oc) tool.

Prerequisites

  • You have access to the cluster as a user with the cluster-admin role.

  • You have installed the OpenShift CLI (oc).

Procedure

  1. Run the following to list routes for the openshift-monitoring project:

    $ oc -n openshift-monitoring get routes
    Example output
    NAME                HOST/PORT                                                     ...
alertmanager-main   alertmanager-main-openshift-monitoring.apps._url_.openshift.com ...
grafana             grafana-openshift-monitoring.apps._url_.openshift.com           ...
prometheus-k8s      prometheus-k8s-openshift-monitoring.apps._url_.openshift.com    ...
thanos-querier      thanos-querier-openshift-monitoring.apps._url_.openshift.com    ...

  2. Navigate to a HOST/PORT route by using a web browser.

  3. Select Log in with OpenShift to log in using your OpenShift Container Platform credentials.

The monitoring routes are managed by the Cluster Monitoring Operator and they cannot be modified by the user.