Discover tabs #3446
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -94,6 +94,8 @@ You can later filter the data that shows in the chart and in the table by specif | |
| You can combine multiple keywords or characters. For example, `geo dest` finds `geo.dest` and `geo.src.dest`. | ||
| :::: | ||
|
|
||
| {applies_to}`stack: ga 9.2` When they exist in your data, Discover shows a small list of recommended fields to explore. This list is static and managed by Elastic. | ||
florent-leborgne marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
florent-leborgne marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
|
|
||
| 2. Select a field to view its most frequent values. | ||
| **Discover** shows the top 10 values and the number of records used to calculate those values. | ||
|
|
||
|
|
@@ -303,6 +305,35 @@ Note that in ES|QL mode, the **Documents** tab is named **Results**. | |
|
|
||
| Learn more about how to use ES|QL queries in [Using ES|QL](try-esql.md). | ||
|
|
||
| ### Run multiple explorations with tabs | ||
| ```{applies_to} | ||
| stack: preview 9.2 | ||
| serverless: preview | ||
| ``` | ||
| **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 KQL), time range, filters, selected data source, columns and sort order you defined, and the active [context-aware experience](#context-aware-discover). | ||
florent-leborgne marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
|
|
||
| This allows you to pivot quickly between different explorations without rebuilding everything. For example: | ||
florent-leborgne marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
|
|
||
| * **Compare time periods:** Open multiple tabs with the same query but different time ranges | ||
| * **Test query variations:** Duplicate a tab to experiment with different {{esql}} queries or filters | ||
| * **Switch contexts:** Keep separate tabs for logs, metrics, and traces exploration | ||
florent-leborgne marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
| * **Test a hypothesis:** Switch between different data sources or field combinations | ||
|
|
||
| #### Manage Discover tabs | ||
|
|
||
| You can open new tabs or duplicate existing ones to compare different queries: | ||
| - To start a fresh exploration in a new tab, select the {icon}`plus` icon next to existing tabs. | ||
florent-leborgne marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
| - 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**. | ||
|
|
||
| To manage and organize your tabs, you can: | ||
| - Rename them: Hover over a tab and select the {icon}`boxes_vertical` **Actions** icon, then select **Rename**. | ||
florent-leborgne marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
| - Reorder them: Drag and drop a tab to move it. | ||
| - Close them: Hover over a tab and select the {icon}`cross` icon. | ||
| - 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. | ||
florent-leborgne marked this conversation as resolved.
Show resolved
Hide resolved
|
||
| - 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. | ||
|
Contributor
There was a problem hiding this comment. After reading this, I feel like we should rename the "Tabs bar menu" button in the UI and come back to update these docs later 😅 The plural "tabs" flows a bit oddly and I see you refer to it as "tab bar" in this sentence too. Any suggestions, maybe just "Tabs menu" would work?
Contributor
Author
There was a problem hiding this comment. I'd like to call this something with verb, but I find this menu a bit odd and even Manage tabs isn't fully accurate because you can do some actions (access/restore tabs and clear some in batch), but not individual actions :D
Contributor
There was a problem hiding this comment. Yeah it's a bit of an odd one and tricky to name. Not 100% sure what to call it yet, but I'm sure we can land on something reasonable. I opened an issue for it here so we don't forget at least: elastic/kibana#239420. |
||
|
|
||
| To keep all of your tabs ready for a later exploration session, 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 later. | ||
florent-leborgne marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
|
|
||
| ### Inspect your Discover queries | ||
|
|
||
| :::{include} ../_snippets/inspect-request.md | ||
|
|
@@ -311,7 +342,7 @@ Learn more about how to use ES|QL queries in [Using ES|QL](try-esql.md). | |
|
|
||
| ### Save your Discover session for later use [save-discover-search] | ||
|
|
||
| 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}}. | ||
|
|
||
| 1. In the application menu bar, click **Save**. | ||
| 2. Give your session a title and a description. | ||
|
|
||
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
One thing that might be missing is that you can clear all tabs and start a new Discover session using the "+" button in the application menu bar. This gets you out of the currently open Discover session if there is one and starts a fresh unsaved session, which manually closing open tabs doesn't. Maybe this is clear from other parts of the docs though, I didn't check.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
You're right I didn't think of this and should call this out. I'll add this
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
It's actually a bit scary that you can flush your current session without a warning if it has unsaved changes. And if it has never been saved in the 1st place, you also don't get the "unsaved changes" warning. That's cold! 😅
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Agreed 😬 There are definitely still some rough edges around tab management to work through in post-MVP phases. We at least have the recently closed menu to help recover accidentally lost tabs for now, but still worth refining some of these scenarios.