grafana_dashboard_var_app

Description

The grafana_dashboard_var_app parameter overrides the Grafana dashboard template variable name for the app filter. The Console's "Open in Grafana" deep-link button substitutes this name into the URL it opens (e.g., ?var-app=<app> becomes ?var-application=<app> when set to application).

Default Value

The default value is app.

Allowed Range

Letters, digits, and underscore only. The validator at pkg/cli/rack.go rejects values containing characters that would break URL substitution or Grafana template syntax.

Use Cases

• Dashboards using application: More verbose dashboard naming conventions favor application over app.
• Dashboards using project: Multi-tenant dashboards sometimes scope by project instead of app.

Setting Parameters

To override to application:

$ convox rack params set grafana_dashboard_var_app=application -r rackName
Setting parameters... OK

To revert to the default:

$ convox rack params set grafana_dashboard_var_app=app -r rackName
Setting parameters... OK

To clear the override (falls back to the canonical default app):

$ convox rack params set grafana_dashboard_var_app= -r rackName
Setting parameters... OK

Operational Notes

• The Console reads the value via the rack-params query and substitutes at deep-link generation time. No restart is required; the next dashboard open uses the new value.
• The "Dashboard filter mismatch?" troubleshooting modal in the Console explains the four configurable var names and how to inspect Grafana's expected variable names.

Related Parameters

• grafana_dashboard_var_rack: Companion override for the rack/cluster filter.
• grafana_dashboard_var_namespace: Companion override for the namespace filter.
• grafana_dashboard_var_service: Companion override for the service filter.
• grafana_url: Base Grafana URL used by the deep-link button.

Version Requirements

This parameter requires at least Convox rack version 3.24.6.