Skip to content

Conversation

florent-leborgne
Copy link
Contributor

@florent-leborgne florent-leborgne commented Oct 13, 2025

This PR:

  • Repurposes the Search sessions page into Background search. The feature being essentially the same on the UX side (a few changes still), and using the same settings behind the scenes, we chose to update the existing page rather than create a new one.
  • Calls out that search sessions, which is a deprecated feature since 8.15 and disabled by default, are being replaced with this new background search feature, so that search sessions users know what's happening.
  • Adds references to background search to a few places to increase its visibility.
    • Discover overview docs on searching & filtering
    • Glossary
    • Dashboards docs as a tip for slow loading scenarios
  • Removes the old search sessions example in favor of more generic but goal-oriented small sections

The update to the Search session settings page are in elastic/kibana#238699 as these source files are in another repo

Closes: #3105

Copy link

github-actions bot commented Oct 13, 2025

Copy link

@lukasolson lukasolson left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A couple of minor pieces of feedback, otherwise LGTM


You can send your long-running searches to the background from **Discover** or **Dashboards** and let them run while you continue your work.

A notification appears when a background search has completed, and allows you to open the list of background searches. You can also access that list at any time to check the status of your searches and interact with them from the {icon}`background_task` **Background searches** button in the toolbar.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Technically the notification appears when the background search object has been created, not when the searches are complete.


You can resume your other tasks, for example start a new search, navigate to a different application, or close the browser. Once the search has completed, a notification informs you and lets you access the search to view its results.

Background searches expire after 7 days. Beyond that period, you must run the search again.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not sure if it's worth mentioning here that it's configurable with the advanced setting data.search.sessions.defaultExpiration.

From the list of background searches, you can reopen and edit any searches, but also extend their validity period or delete them to keep only searches that you care about.

1. Open your list of background searches using one of the following methods:
- Once a background search has completed, a notification appears to inform you, with a link to open the list of background searches.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Same comment as above - we currently don't have a notification when the search completes.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Discover] docs for background search

3 participants