From 5cad7aba8da4eeb6efa74060bde613422888a741 Mon Sep 17 00:00:00 2001 From: Shrinath Rao Date: Thu, 22 Oct 2026 12:51:09 +0530 Subject: [PATCH] =?UTF-8?q?docs:=20dashboard-variables-auto-run=20?= =?UTF-8?q?=E2=80=94=20openobserve=20PR=20#15216?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../variables/variables-in-openobserve.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/docs/user-guide/analytics/dashboards/variables/variables-in-openobserve.md b/docs/user-guide/analytics/dashboards/variables/variables-in-openobserve.md index 649fee79..b36ec03d 100644 --- a/docs/user-guide/analytics/dashboards/variables/variables-in-openobserve.md +++ b/docs/user-guide/analytics/dashboards/variables/variables-in-openobserve.md @@ -11,6 +11,8 @@ Variables in OpenObserve dashboards let users filter data dynamically. You can u When a value is selected, the variable updates, but the panels do not refresh automatically. To view updated panels, users must click the **Refresh** button manually. +To apply changes automatically, turn on [Auto Run](#apply-variables-on-change-auto-run). + ## Why Use Variables Use variables to: @@ -96,6 +98,20 @@ For multi-value variables, you can apply format modifiers to control how the sel - `{{var:doublequote}}` or `${var:doublequote}`: wraps each value in double quotes. - `{{var:singlequote}}` or `${var:singlequote}`: wraps each value in single quotes. +## Apply Variables on Change (Auto Run) + +When the `ZO_AUTO_QUERY_ENABLED` flag is on, **Refresh** becomes a split button. Open its menu and select **Turn on Auto Run** or **Turn off Auto Run**. This is the same setting as in Logs and Traces, so changing it in one place changes it everywhere. + +![TODO: screenshot of the split Refresh button with the Auto Run menu open](images/placeholder.png) + +With Auto Run on, you do not need to click **Refresh**: + +- Variable changes apply after 300 ms. +- Multi-select variables apply when the dropdown closes, including by **Escape** or **Select all**. +- Panels run only after the whole variable chain has loaded, and only the panels whose query changed run, once each. + +With Auto Run off, **Refresh** turns amber when there are unapplied changes. Auto Run covers global, tab, and panel variables, the full-screen panel view, and RUM App Performance. + ## Advanced Configuration After creating and applying a variable, you can further refine its behavior using advanced settings.