You are looking at the documentation of a prior release. To read the documentation of the latest release, please visit here.

New to KubeVault? Please start here.

Visualize Vault server data using Grafana dashboard

Grafana provides an elegant graphical user interface to visualize data. You can create beautiful dashboard easily with a meaningful representation of your Prometheus metrics.

If there is no grafana instance running on your cluster, then you can read this tutorial to deploy one.

Add Prometheus Data Source

We have to add our Prometheus server prometheus-prometheus-0 as data source of grafana. We are going to use a ClusterIP service to connect Prometheus server with grafana. Let’s create a service to select Prometheus server prometheus-prometheus-0,

$ kubectl apply -f https://github.com/kubevault/kubevault/raw/v2022.06.16/docs/examples/monitoring/vault-server/prometheus-service.yaml
service/prometheus created

Below the YAML for the service we have created above,

apiVersion: v1
kind: Service
metadata:
  name: prometheus
  namespace: monitoring
spec:
  type: ClusterIP
  ports:
  - name: web
    port: 9090
    protocol: TCP
    targetPort: 9090
  selector:
    app: prometheus

Now, follow these steps to add the Prometheus server as data source of Grafana UI.

  1. From Grafana UI, go to Configuration option from sidebar and click on Data Sources.

      Grafana: Data Sources

  2. Then, click on Add data source.

      Grafana: Add data source

  3. Now, configure Name, Type and URL fields as specified below and keep rest of the configuration to their default value then click Save&Test button.

      Grafana: Configure data source

Once you have added Prometheus data source successfully, you are ready to create a dashboard to visualize the metrics.

Import Vault server Dashboard

Vault server comes with a pre-configured Grafana dashboard. You can download json configuration of the dashboard from here.

Follow these steps to import the preconfigured stash dashboard,

  1. From Grafana UI, go to Create option from sidebar and click on import.

      Grafana: Import dashboard

  2. Then, paste json from here or upload json configuration file of the dashboard using Upload .json File button.

      Grafana: Provide dashboard ID

  3. Now on prometheus-infra field, select the data source name that we have given to our Prometheus data source earlier. Then click on Import button.

      Grafana: Select data source

Once you have imported the dashboard successfully, you will be greeted with dashboard.

  Grafana: Stash dashboard

Cleanup

To cleanup the Kubernetes resources created by this tutorial, run:

kubectl delete -n demo service prometheus