Skip to content

Latest commit

 

History

History
87 lines (58 loc) · 3.94 KB

dashboards.md

File metadata and controls

87 lines (58 loc) · 3.94 KB
Raw

Working with dashboards

This document describes how to create dashboards and manage plugins (panels).

Dashboard properties

Dashboards are represented by the GrafanaDashboard custom resource. Examples can be found in deploy/examples/dashboards.

The following properties are accepted in the spec:

  • name: The filename of the dashboard that gets mounted into a volume in the grafana instance. Not to be confused with metadata.name.
  • json: Raw json string with the dashboard contents. Check the official documentation.
  • url: Url address to download a json string with the dashboard contents. This will take priority over the json field in case the download is successful
  • plugins: A list of plugins required by the dashboard. They will be installed by the operator if not already present.

Creating a new dashboard

By default the operator only watches for dashboards in it's own namespace. To watch for dashboards in other namespaces, the --scan-all flag must be passed.

To create a dashboard in the grafana namespace run:

$ kubectl create -f deploy/examples/dashboards/SimpleDashboard.yaml -n grafana

NOTE: it can take up to a minute until new dashboards are discovered by Grafana.

Dashboard error handling

If the dashboard contains invalid JSON a message with the parser error will be appended to the status field of the dashboard resource.

Plugins

Dashboards can specify plugins (panels) they depend on. The operator will automatically install them.

You need to provide a name and a version for every plugin, e.g.:

spec:
  name: "dummy"
  json: "{}"
  plugins:
    - name: "grafana-piechart-panel"
      version: "1.3.6"
    - name: "grafana-clock-panel"
      version: "1.0.2"

Plugins are installed from the Grafana plugin registry.

Dashboard discovery

The operator uses a list of set based selectors to discover dashboards by their labels. The dashboardLabelSelector property of the Grafana resource allows you to add selectors by which the dashboards will be filtered.

NOTE: If no dashboardLabelSelector is present, the operator will not discover any dashboards. The same goes for dashboards without labels, they will not be discovered by the operator.

Every selector can have a list of matchLabels and matchExpressions. The rules inside a single selector will be ANDed, while the list of selectors is evaluated with OR.

For example, the following selector:

dashboardLabelSelector:
  - matchExpressions:
      - {key: app, operator: In, values: [grafana]}
      - {key: group, operator: In, values: [grafana]}

requires the dashboard to have two labels, app and group and each label is required to have a value of grafana.

To accept either, the app or the group label, you can write the selector in the following way:

dashboardLabelSelector:
  - matchExpressions:
      - {key: app, operator: In, values: [grafana]}
  - matchExpressions:
      - {key: group, operator: In, values: [grafana]}

Discovering dashboards in other namespaces

The operator can discover dashboards in other namespaces if either the --scan-all flag is set or a list of watch namespaces is provided using the --namespaces flag. However this requires cluster wide permissions to the GrafanaDashboard custom resource. Create the permissions with:

$ oc create -f deploy/cluster_roles

NOTE: when installing the operator from operatorhub it will only have permissions to the namespace it's installed in. To discover dashboards in other namespaces you need to apply the cluster roles after installing the operator and add the --scan-all flag to the operator container.