Looking for the old docs site? You can still view it for a limited time here.

Install Grafana Dashboards

If you’re running Prometheus and Grafana for monitoring the performance and health of Fusion services, then you’ll want to install Lucidworks Grafana dashboards. We provide a number of dashboards in the fusion-cloud-native repo.

How to configure Grafana
  1. If you used the install_prom.sh script to install Prometheus / Grafana into your Fusion namespace, then you need to get the initial Grafana password from a K8s secret by doing:

    kubectl get secret --namespace "${NAMESPACE}" ${RELEASE}-monitoring-grafana \
      -o jsonpath="{.data.admin-password}" | base64 --decode ; echo

    To see the name of the Grafana deployment, do: kubectl get deploy

  2. With Grafana, you can either set up a temporary port-forward to a Grafana pod or expose Grafana on an external IP using a K8s LoadBalancer. To define a LoadBalancer, do (replace ${RELEASE} with your Helm release label, typically the same as your namespace):

    kubectl expose deployment ${RELEASE}-monitoring-grafana --type=LoadBalancer --name=grafana --port=3000 --target-port=3000
  3. Use kubectl get services --namespace <namespace> to verify that the load balancer is set up and has an external IP address.

  4. Direct your browser to http://<GrafanaIP>:3000 and enter the username admin@localhost and the password that was returned in the previous step.

    This will log you into the application. It is recommended that you create another administrative user with a more desirable password.

    If you used the install_prom.sh script, then a default Prometheus data source will already be configured for you. If not, then you need to configure the Prometheus data source in Grafana.

  5. Go to the gear icon on the left and then go to Data Sources.

  6. Click Add Data Source and then click on Prometheus as the data source type. It will bring you to a page where it will ask for HTTP URL for the Prometheus server.

    grafana add datasource

  7. Enter http://<RELEASE>-prom-prometheus-server

  8. Configure any additional fields as desired (but defaults are fine), then click Save and Test, which should succeed.

  9. If you used the install_prom.sh script, then Fusion’s default Grafana dashboards will already be imported. If not, import the dashboards from the fusion-cloud-native repo:

    grafana import