Documentation

Rook version master
Rook version v1.2 Rook version v1.1 Rook version v1.0 Rook version v0.9 Rook version v0.8 Rook version v0.7 Rook version v0.6 Rook version v0.5 Rook version master
    Edit on GitHub

    PLEASE NOTE: This document applies to an unreleased version of Rook. It is strongly recommended that you only use official releases of Rook, as unreleased versions are subject to changes and incompatibilities that will not be supported in the official releases.

    If you are using an official release version of Rook, you should refer to the documentation for your specific version.

    Documentation for other releases can be found by using the version selector in the bottom left of any doc page.

    OpenShift Common Issues

    Enable Monitoring in the Storage Dashboard

    OpenShift Console uses OpenShift Prometheus for monitoring and populating data in Storage Dashboard. Additional configuration is required to monitor the Ceph Cluster from the storage dashboard.

    1. Enable Ceph Cluster monitoring

      Follow ceph-monitoring/prometheus-alerts.

    2. Set the required label on the namespace

      $ oc label namespace rook-ceph "openshift.io/cluster-monitoring=true"

    Troubleshoot Monitoring Issues

    Pre-req: Switch to rook-ceph namespace with oc project rook-ceph

    1. Ensure ceph-mgr pod is Running

      $ oc get pods -l app=rook-ceph-mgr

       NAME            READY   STATUS    RESTARTS   AGE
 rook-ceph-mgr   1/1     Running   0          14h

    2. Ensure service monitor is present

      $ oc get servicemonitor rook-ceph-mgr

       NAME                          AGE
 rook-ceph-mgr                 14h

    3. Ensure prometheus rules are present

      oc get prometheusrules -l prometheus=rook-prometheus

       NAME                    AGE
 prometheus-ceph-rules   14h