Skip to content

Commit 001fd38

Browse files
jughostakibanamachinewajihaparvezdavismcpheejuliaElastic
authored andcommitted
[Discover] Rename Saved Search to Discover Session (elastic#202217)
- Closes elastic#174144 ## Summary This PR renames Saved Search into Discover Session in UI. - [x] Discover - [x] Saved Objects page and modal - [x] Docs - [x] Other occurrences <img width="810" alt="Screenshot 2024-12-16 at 15 20 10" src="https://github.com/user-attachments/assets/e39083da-f496-4ed5-bbdc-8e184897fc41" /> <img width="1220" alt="Screenshot 2024-12-11 at 14 40 15" src="https://github.com/user-attachments/assets/a6dc3e29-e1a5-4304-8148-0108231cc9de" /> <img width="1476" alt="Screenshot 2024-12-16 at 14 57 39" src="https://github.com/user-attachments/assets/4b34c70e-e21a-4d82-85f2-f5a3cb7a3826" /> ### Checklist - [x] Any text added follows [EUI's writing guidelines](https://elastic.github.io/eui/#/guidelines/writing), uses sentence case text and includes [i18n support](https://github.com/elastic/kibana/blob/main/packages/kbn-i18n/README.md) - [x] [Documentation](https://www.elastic.co/guide/en/kibana/master/development-documentation.html) was added for features that require explanation or tutorials - [x] [Unit or functional tests](https://www.elastic.co/guide/en/kibana/master/development-tests.html) were updated or added to match the most common scenarios - [x] The PR description includes the appropriate Release Notes section, and the correct `release_note:*` label is applied per the [guidelines](https://www.elastic.co/guide/en/kibana/master/contributing.html#kibana-release-notes-process) --------- Co-authored-by: kibanamachine <[email protected]> Co-authored-by: wajihaparvez <[email protected]> Co-authored-by: Davis McPhee <[email protected]> Co-authored-by: Julia Bardi <[email protected]>
1 parent 84535df commit 001fd38

File tree

97 files changed

+214
-425
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

97 files changed

+214
-425
lines changed

dev_docs/key_concepts/building_blocks.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,7 @@ and <DocLink id="kibBuildingBlocks" section="index-patterns" text="Index Pattern
4242
### Dashboard Embeddable
4343

4444
Add a Dashboard Embeddable directly inside your application to provide users with a set of visualizations and graphs that work seamlessly
45-
with the <DocLink id="kibBuildingBlocks" section="query-bar" text="Query Bar"/>. Every feature that is added to a registered <DocLink id="kibBuildingBlocks" section="embeddables" text="Embeddable" /> (Lens, Maps, Saved Searches and more) will be available automatically, as well as any <DocLink id="kibBuildingBlocks" section="ui-actions--triggers" text="UI Actions" /> that are added to the Embeddable context menu panel (for example, drilldowns, custom panel time ranges, and "share to" features).
45+
with the <DocLink id="kibBuildingBlocks" section="query-bar" text="Query Bar"/>. Every feature that is added to a registered <DocLink id="kibBuildingBlocks" section="embeddables" text="Embeddable" /> (Lens, Maps, Discover sessions and more) will be available automatically, as well as any <DocLink id="kibBuildingBlocks" section="ui-actions--triggers" text="UI Actions" /> that are added to the Embeddable context menu panel (for example, drilldowns, custom panel time ranges, and "share to" features).
4646

4747
The Dashboard Embeddable is one of the highest-level UI components you can add to your application.
4848

docs/concepts/data-views.asciidoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -166,7 +166,7 @@ clusters or indicies from cross-cluster search].
166166
When you delete a {data-source}, you cannot recover the associated field formatters, runtime fields, source filters,
167167
and field popularity data. Deleting a {data-source} does not remove any indices or data documents from {es}.
168168

169-
WARNING: Deleting a {data-source} breaks all visualizations, saved searches, and other saved objects that reference the data view.
169+
WARNING: Deleting a {data-source} breaks all visualizations, saved Discover sessions, and other saved objects that reference the data view.
170170

171171
. Go to the **Data Views** management page using the navigation menu or the <<kibana-navigation-search,global search field>>.
172172

docs/concepts/esql.asciidoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ disabled using the `enableESQL` setting from the
2626
{kibana-ref}/advanced-options.html[Advanced Settings].
2727
2828
This will hide the {esql} user interface from various applications.
29-
However, users will be able to access existing {esql} artifacts like saved searches and visualizations.
29+
However, users will be able to access existing {esql} artifacts like saved Discover sessions and visualizations.
3030
====
3131

3232
[float]

docs/concepts/save-query.asciidoc

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -11,10 +11,10 @@ Save this query, and you can embed the search results in dashboards,
1111
use them as a foundation for building a visualization,
1212
and share them in a link or CVS form.
1313

14-
Saved queries are different than <<save-open-search,saved searches>>,
14+
Saved queries are different than <<save-open-search,saved Discover sessions>>,
1515
which include the *Discover* configuration&mdash;selected columns in the document table, sort order, and
1616
{data-source}&mdash;in addition to the query.
17-
Saved searches are primarily used for adding search results to a dashboard.
17+
Discover sessions are primarily used for adding search results to a dashboard.
1818

1919
[role="xpack"]
2020
==== Read-only access

docs/developer/plugin-list.asciidoc

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -309,6 +309,7 @@ oss plugins.
309309
310310
|{kib-repo}blob/{branch}/src/plugins/saved_search/README.md[savedSearch]
311311
|Contains the saved search saved object definition and helpers.
312+
This object is created when a user saves their current session in the Discover app.
312313
313314
314315
|{kib-repo}blob/{branch}/src/plugins/screenshot_mode/README.md[screenshotMode]

docs/discover/document-explorer.asciidoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,7 @@ In the pop-up, drag the column names to their new order.
3636

3737
* To resize a column, drag the right edge of the column header until the column is the width that you want.
3838
+
39-
Column widths are stored with a saved search. When you visualize saved searches on dashboards, the saved search appears the same as in **Discover**.
39+
Column widths are stored with a Discover session. When you add a Discover session as a dashboard panel, it appears the same as in **Discover**.
4040

4141
[float]
4242
[[document-explorer-density]]

docs/discover/get-started-discover.asciidoc

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -293,24 +293,24 @@ Learn more about how to use ES|QL queries in <<try-esql, Using ES|QL>>.
293293

294294
[float]
295295
[[save-discover-search]]
296-
==== Save your search for later use
296+
==== Save your Discover session for later use
297297

298-
Save your search so you can use it later, generate a CSV report, or use it to create visualizations, dashboards, and Canvas workpads.
299-
Saving a search saves the query text, filters,
298+
Save your Discover session so you can use it later, generate a CSV report, or use it to create visualizations, dashboards, and Canvas workpads.
299+
Saving a Discover session saves the query text, filters,
300300
and current view of *Discover*, including the columns selected in
301301
the document table, the sort order, and the {data-source}.
302302

303303
. In the application menu bar, click **Save**.
304304

305-
. Give your search a title and a description.
305+
. Give your session a title and a description.
306306

307-
. Optionally store <<managing-tags,tags>> and the time range with the search.
307+
. Optionally store <<managing-tags,tags>> and the time range with the session.
308308

309309
. Click **Save**.
310310

311311
[float]
312312
[[share-your-findings]]
313-
==== Share your search
313+
==== Share your Discover session
314314

315315
To share your search and **Discover** view with a larger audience, click *Share* in the application menu bar.
316316
For detailed information about the sharing options, refer to <<reporting-getting-started,Reporting>>.

docs/discover/save-search.asciidoc

Lines changed: 18 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
[[save-open-search]]
2-
== Save a search for reuse
2+
== Save a Discover session for reuse
33

4-
A saved search is a convenient way to reuse a search
4+
A saved Discover session is a convenient way to reuse a search
55
that you've created in *Discover*.
6-
Saved searches are good for adding search results to a dashboard,
6+
Discover sessions are good for saving a configured view of Discover to use later or adding search results to a dashboard,
77
and can also serve as a foundation for building visualizations.
88

99
[role="xpack"]
@@ -16,27 +16,27 @@ displayed and the *Save* button is not visible. For more information, refer to <
1616
[role="screenshot"]
1717
image::discover/images/read-only-badge.png[Example of Discover's read only access indicator in Kibana's header]
1818
[float]
19-
=== Save a search
19+
=== Save a Discover session
2020

21-
By default, a saved search stores the query text, filters, and
21+
By default, a Discover session stores the query text, filters, and
2222
current view of *Discover*, including the columns and sort order in the document table, and the {data-source}.
2323

24-
. Once you've created a search worth saving, click *Save* in the toolbar.
25-
. Enter a name for the search.
26-
. Optionally store <<managing-tags,tags>> and the time range with the search.
24+
. Once you've created a view worth saving, click *Save* in the toolbar.
25+
. Enter a name for the session.
26+
. Optionally store <<managing-tags,tags>> and the time range with the session.
2727
. Click *Save*.
28-
. To reload your search results in *Discover*, click *Open* in the toolbar, and select the saved search.
28+
. To reload your search results in *Discover*, click *Open* in the toolbar, and select the saved Discover session.
2929
+
30-
If the saved search is associated with a different {data-source} than is currently
31-
selected, opening the saved search changes the selected {data-source}. The query language
32-
used for the saved search is also automatically selected.
30+
If the saved Discover session is associated with a different {data-source} than is currently
31+
selected, opening the saved Discover session changes the selected {data-source}. The query language
32+
used for the saved Discover session is also automatically selected.
3333

3434
[float]
35-
=== Duplicate a search
36-
. In **Discover**, open the search that you want to duplicate.
35+
=== Duplicate a Discover session
36+
. In **Discover**, open the Discover session that you want to duplicate.
3737
. In the toolbar, click *Save*.
38-
. Give the search a new name.
39-
. Turn on **Save as new search**.
38+
. Give the session a new name.
39+
. Turn on **Save as new Discover session**.
4040
. Click *Save*.
4141

4242

@@ -46,5 +46,5 @@ used for the saved search is also automatically selected.
4646
. Go to *Dashboards*.
4747
. Open or create the dashboard, then click *Edit*.
4848
. Click *Add from library*.
49-
. From the *Types* dropdown, select *Saved search*.
50-
. Select the saved search that you want to visualize, then click *X* to close the list.
49+
. From the *Types* dropdown, select *Discover session*.
50+
. Select the Discover session that you want to add, then click *X* to close the list.

docs/discover/search-sessions.asciidoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -52,7 +52,7 @@ image::images/search-session-awhile.png[Search Session indicator displaying the
5252
Once you save a search session, you can start a new search,
5353
navigate to a different application, or close the browser.
5454

55-
. To view your saved searches, go to the
55+
. To view your saved search sessions, go to the
5656
*Search Sessions* management page using the navigation menu or the <<kibana-navigation-search,global search field>>.
5757
For a saved or completed session, you can also open this view from the search sessions popup.
5858

docs/discover/search.asciidoc

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -92,10 +92,10 @@ status:[400 TO 499] AND (extension:php OR extension:html)
9292

9393

9494
[[save-open-search]]
95-
=== Save a search
96-
A saved search persists your current view of Discover for later retrieval and reuse. You can reload a saved search into Discover, add it to a dashboard, and use it as the basis for a visualization.
95+
=== Save a Discover session
96+
A saved Discover session persists your current view of Discover for later retrieval and reuse. You can reload a saved session into Discover, add it to a dashboard, and use it as the basis for a visualization.
9797

98-
A saved search includes the query text, filters, and optionally, the time filter. A saved search also includes the selected columns in the document table, the sort order, and the current index pattern.
98+
A Discover session includes the query text, filters, and optionally, the time filter. A Discover session also includes the selected columns in the document table, the sort order, and the current {data-source}.
9999

100100
[role="xpack"]
101101
[[discover-read-only-access]]
@@ -107,23 +107,23 @@ Kibana see <<xpack-security-authorization>>.
107107
[role="screenshot"]
108108
image::discover/images/read-only-badge.png[Example of Discover's read only access indicator in Kibana's header]
109109

110-
==== Save a search
111-
To save the current search:
110+
==== Save a Discover session
111+
To save the current session:
112112

113113
. Click *Save* in the toolbar.
114-
. Enter a name for the search and click *Save*.
114+
. Enter a name for the session and click *Save*.
115115

116-
To import, export, and delete saved searches, go to the *Saved Objects* management page using the navigation menu or the <<kibana-navigation-search,global search field>>.
116+
To import, export, and delete saved Discover sessions, go to the *Saved Objects* management page using the navigation menu or the <<kibana-navigation-search,global search field>>.
117117

118-
==== Open a saved search
119-
To load a saved search into Discover:
118+
==== Open a saved Discover session
119+
To load a saved session into Discover:
120120

121121
. Click *Open* in the toolbar.
122-
. Select the search you want to open.
122+
. Select the session you want to open.
123123

124-
If the saved search is associated with a different index pattern than is currently
125-
selected, opening the saved search changes the selected index pattern. The query language
126-
used for the saved search will also be automatically selected.
124+
If the saved Discover session is associated with a different {data-source} than is currently
125+
selected, opening the saved Discover session changes the selected {data-source}. The query language
126+
used for the saved Discover session will also be automatically selected.
127127

128128
[[save-load-delete-query]]
129129
=== Save a query
@@ -133,7 +133,7 @@ A saved query is a portable collection of query text and filters that you can re
133133
* View the results of the same query in multiple apps
134134
* Share your query
135135

136-
Saved queries don't include information specific to Discover, such as the currently selected columns in the document table, the sort order, and the index pattern. If you want to save your current view of Discover for later retrieval and reuse, create a <<save-open-search, saved search>> instead.
136+
Saved queries don't include information specific to Discover, such as the currently selected columns in the document table, the sort order, and the {data-source}. If you want to save your current view of Discover for later retrieval and reuse, create a <<save-open-search, Discover session>> instead.
137137

138138
[role="xpack"]
139139
==== Read-only access

0 commit comments

Comments
 (0)