Dashboards

  1. Whole-Cluster Dashboard
  2. Dynamically Generated Dashboards
  3. Custom prefix for dashboard UIDs and titles
  4. Extra Metric Query Parameters

Whole-Cluster Dashboard

Note: This dashboard is packaged by default with Gloo Edge Enterprise

A dashboard showing whole-cluster metrics can be found in the gloo/Envoy Statistics dashboard. In that dashboard you can find panels showing:

Dynamically Generated Dashboards

Gloo Edge Enterprise’s observability component generates a dashboard per watched upstream. These dashboards are updated and recreated every time an upstream changes. It renders a Go template that can be found in a configmap, which gets loaded into the observability pod’s env at startup:

~ > kubectl -n gloo-system get cm gloo-observability-config -o yaml | head -n 10
apiVersion: v1
data:
  GRAFANA_URL: http://glooe-grafana.gloo-system.svc.cluster.local:80
  UPSTREAM_DASHBOARD_JSON_TEMPLATE: |2

    {
      "annotations": {
        "list": [
          {
            "builtIn": 1,

If you want to customize how these per-upstream dashboards look, you can provide your own template to use by writing a Grafana dashboard JSON representation to that config map key. Currently the only available variables that are available when the Go template is rendered are:

Custom prefix for dashboard UIDs and titles

You can provide a prefix that is prepended to the UID and title of all dashboards that are generated by Gloo Edge Enterprise. This prefix can be very useful in scenarios where you have multiple installations of Edge Enterprise that publish dashboards to an external centralized Grafana Server. Providing a unique prefix per installation ensures that all dashboards that are generated by Gloo Edge Enterprise have a unique UID and title and do not conflict across multiple installations.

To enable this feature, add the prefix that you want to use in the gloo.settings.observabilityOptions.grafanaIntegration.dashboardPrefix field.

The prefix can have a maximum length of 20 characters.

When you add a prefix, Gloo Edge generates new Grafana dashboards that contain that prefix in the dashboard name and UID. Previously generated Grafana dashboards are not removed and must be deleted manually.

Extra Metric Query Parameters

You can specify extra query parameters that you want to add to all metric query definitions in the Grafana dashboards that Gloo Edge generates. For example, you might aggregate metrics from multiple clusters in a central Prometheus server. Without additional query parameters, the Gloo Edge-generated dashboards pull in the metrics for all of your clusters which can lead to incorrect results and graphs. To ensure that the Gloo Edge Grafana dashboards show only the metrics for the cluster that you are interested in, you can specify the cluster name as an additional query parameter, such as cluster="my-cluster". Only metrics that match this parameter are pulled into the Grafana dashboard.

To enable this feature, add the query parameters that you want to add to the gloo.settings.observabilityOptions.grafanaIntegration.extraMetricQueryParameters field. Separate multiple query parameters by comma, such as cluster="my-cluster",gateway_proxy_id="proxy-2".