4.5 KiB
| title | description | menu | weight | ||||||
|---|---|---|---|---|---|---|---|---|---|
| Explore metrics with InfluxDB | Explore and visualize your data in InfluxDB's Data Explorer. The InfluxDB user interface (UI) allows you to move seamlessly between using the Flux builder and manually editing the query. |
|
101 |
Explore and visualize your data in the Data Explorer. The InfluxDB user interface (UI) allows you to move seamlessly between using the Flux builder or templates and manually editing the query. Choose between visualization types for your query.
To open the Data Explorer, click the Data Explorer icon in the navigation bar:
{{< nav-icon "data-explorer" >}}
Explore data with Flux and the Data Explorer
Flux is InfluxData's functional data scripting language designed for querying, analyzing, and acting on time series data. See Get started with Flux to learn more about Flux.
-
Click the Data Explorer icon in the sidebar.
{{< nav-icon "data-explorer" >}}
-
Use the Flux builder in the bottom panel to create a Flux query:
- Select a bucket to define your data source.
- Edit your time range with the time range option in the dropdown menu.
- Add filters to narrow your data by selecting attributes or columns in the dropdown menu.
- Select Group from the Filter dropdown menu to group data into tables. For more about how grouping data in Flux works, see Group data.
- Alternatively, click Script Editor to manually edit the query. To switch back to the query builder, click Query Builder. Note that your updates from the Script Editor will not be saved.
- Use the Functions list to review the available Flux functions. Click on a function from the list to add it to your query.
- Click Submit (or press
Control+Enter) to run your query. You can then preview your graph in the above pane. - To work on multiple queries at once, click the {{< icon "plus" >}} to add another tab.
- Click the eye icon on a tab to hide or show a query's visualization.
- Click on the name of the query in the tab to rename it.
Visualize your query
Select from available visualization types or enable the View Raw Data option to view all of your query's results.
-
Select a visualization type from the dropdown menu in the upper-left.
{{< img-hd src="/img/2-0-visualization-dropdown.png" title="Visualization dropdown" />}}
-
Select the Visualization tab at the bottom of the Data Explorer. For details about all of the available visualization options, see Visualization types.
Control your dashboard cell
To open the cell editor overlay, click the gear icon in the upper right of a cell and select Configure. The cell editor overlay opens.
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/2-0-controls-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/2-0-controls-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
-
Select from the time range options in the dropdown menu.
{{< img-hd src="/img/2-0-controls-time-range.png" alt="Select time range" />}}
-
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.
Add comments to your script
In Script Editor mode, press Control+/ to toggle between commenting a line out.
Save your query as a dashboard cell or task
To save your query:
Click Save as in the upper right, then:
- To add your query to a dashboard, click Dashboard Cell.
- To save your query as a task, click Task.
- To save your query as a variable, click Variable.