Skip to content

Commit 3f5f954

Browse files
florent-leborgnebenironsidedavismcphee
authored
Discover tabs (#3446)
This PR: - Adds a section about using tabs in Discover and how to manage these tabs - Edits the Save Discover session section to add the notion of tabs being saved as part of the Discover session - Adds a note about recommended fields (unrelated to tabs but noticed this on the way) Closes: #3145 --------- Co-authored-by: Benjamin Ironside Goldstein <[email protected]> Co-authored-by: Davis McPhee <[email protected]>
1 parent ff57b74 commit 3f5f954

File tree

1 file changed

+36
-1
lines changed

1 file changed

+36
-1
lines changed

explore-analyze/discover/discover-get-started.md

Lines changed: 36 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -94,6 +94,8 @@ You can later filter the data that shows in the chart and in the table by specif
9494
You can combine multiple keywords or characters. For example, `geo dest` finds `geo.dest` and `geo.src.dest`.
9595
::::
9696

97+
{applies_to}`stack: ga 9.2` For some searches, Discover suggests recommended fields to explore. These suggestions are based on the data you query and are managed by Elastic.
98+
9799
2. Select a field to view its most frequent values.
98100
**Discover** shows the top 10 values and the number of records used to calculate those values.
99101

@@ -303,6 +305,39 @@ Note that in ES|QL mode, the **Documents** tab is named **Results**.
303305

304306
Learn more about how to use ES|QL queries in [Using ES|QL](try-esql.md).
305307

308+
### Run multiple explorations with tabs
309+
```{applies_to}
310+
stack: preview 9.2
311+
serverless: preview
312+
```
313+
**Discover** supports multiple tabs to help you explore different aspects of your data simultaneously. Each tab maintains its own independent state, including the query ({{esql}} or classic mode), time range, filters, selected data source, columns and sort order you defined, and the active [context-aware experience](#context-aware-discover).
314+
315+
This allows you to pivot quickly between different explorations without losing your place. For example:
316+
317+
* **Compare time periods:** Open multiple tabs with the same query but different time ranges
318+
* **Test query variations:** Duplicate a tab to experiment with different {{esql}} queries or filters
319+
* **Switch contexts:** Keep separate tabs for logs, metrics, and traces explorations
320+
* **Test a hypothesis:** Switch between different data sources or field combinations
321+
322+
#### Manage Discover tabs
323+
324+
You can open new tabs or duplicate existing ones to compare different queries:
325+
- To start a fresh exploration in a new tab, select the {icon}`plus` icon next to the existing tabs.
326+
- To test variations of your current query in a new tab, hover over a tab and select the {icon}`boxes_vertical` **Actions** icon, then select **Duplicate**.
327+
328+
To manage and organize your tabs, you can:
329+
- Rename them: Double-click its label or hover over a tab and select the {icon}`boxes_vertical` **Actions** icon, then select **Rename**.
330+
- Reorder them: Drag and drop a tab to move it.
331+
- Close them: Hover over a tab and select the {icon}`cross` icon.
332+
- Close several tabs at once: When you hover over a tab and select the {icon}`boxes_vertical` **Actions** icon, options let you **Close other tabs** to keep only the active tab open or **Close tabs to the right** to only keep your first tabs and discard any subsequent tabs.
333+
334+
:::{tip}
335+
If you want to discard all open tabs, you can also start a {icon}`plus` **New session** from the toolbar. When you use this option, any unsaved changes to your current session are lost.
336+
:::
337+
- Reopen recently closed tabs: If you close a tab by mistake, you can retrieve it by selecting the {icon}`boxes_vertical` **Tabs bar menu** icon located at the end of the tab bar.
338+
339+
To keep all of your tabs for later, you can [Save your Discover session](#save-discover-search). All currently open tabs are saved within the session and will be there when you open it again.
340+
306341
### Inspect your Discover queries
307342

308343
:::{include} ../_snippets/inspect-request.md
@@ -319,7 +354,7 @@ You can send your long-running KQL or {{esql}} queries to the background from **
319354

320355
### Save your Discover session for later use [save-discover-search]
321356

322-
Save your Discover session so you can use it later, generate a CSV report, or use it to create visualizations, dashboards, and Canvas workpads. Saving a Discover session saves the query text, filters, and current view of **Discover**, including the columns selected in the document table, the sort order, and the {{data-source}}.
357+
Save your Discover session so you can use it later, generate a CSV report, or use it to create visualizations, dashboards, and Canvas workpads. Saving a Discover session saves all open tabs, along with their query text, filters, and current view of **Discover**, including the columns selected in the document table, the sort order, and the {{data-source}}.
323358

324359
1. In the application menu bar, click **Save**.
325360
2. Give your session a title and a description.

0 commit comments

Comments
 (0)