diff --git a/content/v2.0/visualize-data/dashboards/control-dashboard.md b/content/v2.0/visualize-data/dashboards/control-dashboard.md new file mode 100644 index 000000000..b3101e639 --- /dev/null +++ b/content/v2.0/visualize-data/dashboards/control-dashboard.md @@ -0,0 +1,61 @@ +--- +title: Control a dashboard +seotitle: Control an InfluxDB dashboard +description: Control an InfluxDB dashboard in the InfluxDB user interface (UI). +v2.0/tags: [dashboards] +menu: + v2_0: + name: Control a dashboard + parent: Manage dashboards +weight: 203 +--- + +## Control at the dashboard level + +Use dashboard controls in the upper right to update your dashboard. + +### Add a cell + +Click {{< icon "add-cell" >}} **Add Cell** to open the Data Explorer and configure a new cell for your dashboard. + +For details on using the Data Explorer, see [Explore metrics](/v2.0/visualize-data/explore-metrics/). + +### Add a note + +1. Click {{< icon "note" >}} **Add Note** to add a note cell to your dashboard. +2. Enter your note in Markdown in the left pane. A preview appears in the right pane. +3. Enable the **Show note when query returns no data** option to show the note only when the query displays no data. +4. Click **Save**. + +### Select timezone + +Click the timezone dropdown to select a timezone to use for the dashboard. Select either the local time (default) or UTC. + +{{< img-hd src="/img/timezone.png" alt="Select timezone" />}} + +### Select auto-refresh interval + +Select how frequently to refresh the dashboard's data. By default, refreshing is paused. + +{{< img-hd src="/img/refresh-interval.png" alt="Select refresh interval" />}} + +### Manually refresh dashboard + +Click the refresh button ({{< icon "refresh" >}}) to manually refresh the dashboard's data. + +### Select time range + +1. Select from the time range options in the dropdown menu. + +{{< img-hd src="/img/time-range.png" alt="Select time range" />}} + +2. Select **Custom Time Range** to enter a custom time range with precision up to nanoseconds. +The default time range is 5 minutes. + +### Add variables + +Click **Variables** to display variables available for your dashboard. For details, see [Use and manage variables](/v2.0/visualize-data/variables/) + +### Presentation mode + +Click the fullscreen icon ({{< icon "fullscreen" >}}) to enter presentation mode. Presentation mode allows you to view [a dashboard] in full screen, hiding the left and top navigation menus so only the cells appear. This mode might be helpful, for example, for stationary screens dedicated to monitoring visualizations. diff --git a/content/v2.0/visualize-data/explore-metrics.md b/content/v2.0/visualize-data/explore-metrics.md index 4937e90f5..5abfd23ea 100644 --- a/content/v2.0/visualize-data/explore-metrics.md +++ b/content/v2.0/visualize-data/explore-metrics.md @@ -41,6 +41,7 @@ See [Get started with Flux](/v2.0/query-data/get-started) to learn more about Fl * Click on the name of the query in the tab to rename it. ## Visualize your query + Select from available [visualization types](/v2.0/visualize-data/visualization-types/) or enable the **View Raw Data** option to view all of your query's results. 1. Select a visualization type from the dropdown menu in the upper-left. @@ -51,6 +52,43 @@ Select from available [visualization types](/v2.0/visualize-data/visualization-t For details about all of the available visualization options, see [Visualization types](/v2.0/visualize-data/visualization-types/). +## Control your dashboard cell + +From the cell editor overlay, use the controls in the lower pane to control your dashboard. + +### View raw data + +Toggle the **View Raw data** {{< icon "toggle" >}} option to see your data in table format instead of a graph. Use this option when data can't be visualized using a visualization type. + + {{< img-hd src="/img/view-raw-data.png" alt="View raw data" />}} + +### Save as CSV + +Click the CSV icon to save the cells contents as a CSV file. + +### Select auto-refresh interval + +Select how frequently to refresh the dashboard's data. By default, refreshing is paused. + +{{< img-hd src="/img/refresh-interval.png" alt="Select refresh interval" />}} + +### Manually refresh dashboard + +Click the refresh button ({{< icon "refresh" >}}) to manually refresh the dashboard's data. + +### Select time range + +1. Select from the time range options in the dropdown menu. + +{{< img-hd src="/img/time-range.png" alt="Select time range" />}} + +2. Select **Custom Time Range** to enter a custom time range with precision up to nanoseconds. +The default time range is 5m. + +### Query Builder or Script Editor + +Click **Query Builder** to use the builder to create a Flux query. Click **Script Editor** to manually edit the query. + ## Save your query as a dashboard cell or task **To save your query**: diff --git a/static/img/refresh-interval.png b/static/img/refresh-interval.png new file mode 100644 index 000000000..2c756c5df Binary files /dev/null and b/static/img/refresh-interval.png differ diff --git a/static/img/time-range.png b/static/img/time-range.png new file mode 100644 index 000000000..424eb385b Binary files /dev/null and b/static/img/time-range.png differ diff --git a/static/img/timezone.png b/static/img/timezone.png new file mode 100644 index 000000000..8cfe13417 Binary files /dev/null and b/static/img/timezone.png differ diff --git a/static/img/view-raw-data.png b/static/img/view-raw-data.png new file mode 100644 index 000000000..cce55f974 Binary files /dev/null and b/static/img/view-raw-data.png differ