Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
38 commits
Select commit Hold shift + click to select a range
c70c2d5
Move Elasticsearch solution files to new directory
leemthompo Dec 8, 2025
ef803d9
Add Elasticsearch solution and Search use case overview pages
leemthompo Dec 8, 2025
597e532
Update Search pages to reference Elasticsearch solution
leemthompo Dec 8, 2025
45e407b
Update ES solution get-started page with new content
leemthompo Dec 8, 2025
6a5fb4b
Restructure navigation into Search use case and Elasticsearch solution
leemthompo Dec 8, 2025
2efdd52
Fix toc.yml to remove non-existent quickstart references
leemthompo Dec 8, 2025
a561b33
Fix internal references and redirects after file moves
leemthompo Dec 8, 2025
31d7bfe
Update all internal references to moved pages
leemthompo Dec 8, 2025
b67429e
Update remaining references to playground, MCP, and search-applications
leemthompo Dec 8, 2025
460e69c
Fix final search-with-synonyms reference in ece-ha.md
leemthompo Dec 8, 2025
c94e778
Move search-connection-details to Elasticsearch solution
leemthompo Dec 8, 2025
168f2d9
Improve Search use case landing page
leemthompo Dec 8, 2025
490f92f
Move synonyms documentation to Search use case
leemthompo Dec 9, 2025
ae00cdf
Add redirects for ES solution pages moved from Search
leemthompo Dec 9, 2025
cb7669a
Fix broken links with absolute paths
leemthompo Dec 9, 2025
369a369
Restore stepper format to Elasticsearch solution get-started page
leemthompo Dec 10, 2025
0a97210
delete temp file
leemthompo Dec 10, 2025
1b59a93
tweak verbiage
leemthompo Dec 10, 2025
0e687bf
refactor the solutions-use-cases landing page
leemthompo Dec 10, 2025
1be8f3f
less repetition
leemthompo Dec 10, 2025
817c0b2
tighten up
leemthompo Dec 10, 2025
ae1a361
de-emphasize search applications
leemthompo Dec 10, 2025
471b254
clarify verbiage
leemthompo Dec 10, 2025
752a53e
better words
leemthompo Dec 10, 2025
3893f33
rework use case landing page
leemthompo Dec 10, 2025
58db21a
update related links
leemthompo Dec 10, 2025
45f2b62
reword
leemthompo Dec 10, 2025
60583fc
restore better wording
leemthompo Dec 10, 2025
be72056
fix table
leemthompo Dec 10, 2025
337360f
Apply suggestions
leemthompo Dec 11, 2025
35db040
Merge branch 'main' into leemthompo/searchy-mc-elasticsearch
leemthompo Dec 11, 2025
9c7baf0
Move quickstart guides from Elasticsearch solution to search use case
leemthompo Dec 17, 2025
f640f54
Rewrite solutions overview pages with path-based framing
leemthompo Dec 17, 2025
2c98ea4
update rag page
leemthompo Dec 17, 2025
6f1e500
update solution overview
leemthompo Dec 17, 2025
51c7065
Merge branch 'main' into leemthompo/searchy-mc-elasticsearch
leemthompo Dec 17, 2025
45e74b2
fix toc
leemthompo Dec 17, 2025
dd74195
fix build
leemthompo Dec 17, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion deploy-manage/deploy/cloud-enterprise/ece-ha.md
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,7 @@ Backing up Zookeeper data directory is also recommended. Refer to [rebuilding a

## External resources accessibility

If youre using a [private Docker registry server](ece-install-offline-with-registry.md) or hosting any [custom bundles and plugins](../../../solutions/search/full-text/search-with-synonyms.md) on a web server, make sure these resources are accessible from all ECE allocators, so they can continue to be accessed in the event of a network partition or zone outage.
If you're using a [private Docker registry server](ece-install-offline-with-registry.md) or hosting any [custom bundles and plugins](/solutions/search/full-text/search-with-synonyms.md) on a web server, make sure these resources are accessible from all ECE allocators, so they can continue to be accessed in the event of a network partition or zone outage.

## Other recommendations

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -98,7 +98,7 @@ This table compares Elasticsearch capabilities between {{ech}} deployments and S
| **Repository management** | ✅ | Managed | Automatically managed by Elastic |
| [**Scripted metric aggregations**](elasticsearch://reference/aggregations/search-aggregations-metrics-scripted-metric-aggregation.md) | ✅ | ❌ | Not available in Serverless<br>The alternative for this in Serverless is [ES|QL](elasticsearch://reference/query-languages/esql.md) |
| [**`join` fields**](elasticsearch://reference/elasticsearch/mapping-reference/parent-join.md) | ✅ | ❌ | Not available in Serverless<br>The alternative for this in Serverless is the ES\|QL [`LOOKUP JOIN`](elasticsearch://reference/query-languages/esql/commands/lookup-join.md) command |
| [**Search applications**](/solutions/search/search-applications.md) | - UI and APIs <br>- Maintenance mode (beta) | - API-only <br>- Maintenance mode (beta) | UI not available in Serverless |
| [**Search applications**](/solutions/elasticsearch-solution-project/search-applications.md) | - UI and APIs <br>- Maintenance mode (beta) | - API-only <br>- Maintenance mode (beta) | UI not available in Serverless |
| **Shard management** | User-configurable | Managed by Elastic | No manual shard allocation in Serverless |
| [**Watcher**](/explore-analyze/alerts-cases/watcher.md) | ✅ | ❌ | Use **Kibana Alerts** instead, which provides rich integrations across use cases |
| **Web crawler** | ❌ (Managed Elastic Crawler discontinued with Enterprise Search in 9.0) | Self-managed only | Use [**self-managed crawler**](https://github.com/elastic/crawler) |
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ This Hot/Frozen – High Availability architecture is intended for organizations
* Have a requirement for cost effective long term data storage (many months or years).
* Provide insights and alerts using logs, metrics, traces, or various event types to ensure optimal performance and quick issue resolution for applications.
* Apply [machine learning anomaly detection](/explore-analyze/machine-learning/anomaly-detection.md) to help detect patterns in time series data to find root cause and resolve problems faster.
* Use an AI assistant ([Observability](/explore-analyze/ai-features/ai-assistant.md), [Security](/solutions/security/ai/ai-assistant.md), or [Playground](/solutions/search/rag/playground.md)) for investigation, incident response, reporting, query generation, or query conversion from other languages using natural language.
* Use an AI assistant ([Observability](/explore-analyze/ai-features/ai-assistant.md), [Security](/solutions/security/ai/ai-assistant.md), or [Playground](/solutions/elasticsearch-solution-project/playground.md)) for investigation, incident response, reporting, query generation, or query conversion from other languages using natural language.
* Deploy an architecture model that allows for maximum flexibility between storage cost and performance.

::::{important}
Expand Down
6 changes: 3 additions & 3 deletions explore-analyze/ai-features.md
Original file line number Diff line number Diff line change
Expand Up @@ -71,19 +71,19 @@ The [{{es}}](/solutions/search.md) solution view (or project type in {{serverles

### Agent Builder

[Agent Builder](/solutions/search/elastic-agent-builder.md) enables you to create AI agents that can interact with your {{es}} data, run queries, and provide intelligent responses. It provides a complete framework for building conversational AI experiences on top of your search infrastructure.
[Agent Builder](/solutions/elasticsearch-solution-project/elastic-agent-builder.md) enables you to create AI agents that can interact with your {{es}} data, run queries, and provide intelligent responses. It provides a complete framework for building conversational AI experiences on top of your search infrastructure.

### AI assistant for {{es}}

[](/solutions/observability/observability-ai-assistant.md) helps you understand, analyze, and interact with your Elastic data throughout {{kib}}. It provides a chat interface where you can ask questions about the {{stack}} and your data, and provides contextual insights throughout {{kib}} that explain errors and messages and suggest remediation steps.

### Playground

[Playground](/solutions/search/rag/playground.md) enables you to use large language models (LLMs) to understand, explore, and analyze your {{es}} data using retrieval augmented generation (RAG), via a chat interface. Playground is also very useful for testing and debugging your {{es}} queries, using the [retrievers](/solutions/search/retrievers-overview.md) syntax with the `_search` endpoint.
[Playground](/solutions/elasticsearch-solution-project/playground.md) enables you to use large language models (LLMs) to understand, explore, and analyze your {{es}} data using retrieval augmented generation (RAG), via a chat interface. Playground is also very useful for testing and debugging your {{es}} queries, using the [retrievers](/solutions/search/retrievers-overview.md) syntax with the `_search` endpoint.

### Model context protocol

The [Model Context Protocol (MCP)](/solutions/search/mcp.md) lets you connect AI agents and assistants to your {{es}} data to enable natural language interactions with your indices.
The [Model Context Protocol (MCP)](/solutions/elasticsearch-solution-project/mcp.md) lets you connect AI agents and assistants to your {{es}} data to enable natural language interactions with your indices.

## AI-powered features in {{observability}}

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ This feature is not available at all Elastic subscription levels. Refer to the E

### ELSER text expansion [ingest-pipeline-search-inference-elser]

Using Elastics [ELSER machine learning model](../nlp/ml-nlp-elser.md) you can easily incorporate text expansion for your queries. This works by using ELSER to provide semantic enrichments to your documents upon ingestion, combined with the power of [Elastic Search Application templates](../../../solutions/search/search-applications.md) to provide automated text expansion at query time.
Using Elastic's [ELSER machine learning model](../nlp/ml-nlp-elser.md) you can easily incorporate text expansion for your queries. This works by using ELSER to provide semantic enrichments to your documents upon ingestion, combined with the power of [Elastic Search Application templates](/solutions/elasticsearch-solution-project/search-applications.md) to provide automated text expansion at query time.

### Named entity recognition (NER) [ingest-pipeline-search-inference-ner]

Expand Down
2 changes: 1 addition & 1 deletion explore-analyze/query-filter/tools/playground.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,6 @@ Use the Search Playground to test and edit {{es}} queries visually in the UI. Th
Find Playground in the {{es-serverless}} UI under **{{es}} > Build > Playground**.

::::{note}
ℹ️ For more details, check the full [Playground documentation](../../../solutions/search/rag/playground.md).
ℹ️ For more details, check the full [Playground documentation](/solutions/elasticsearch-solution-project/playground.md).

::::
4 changes: 3 additions & 1 deletion get-started/introduction.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ Whether you're building a search experience, monitoring your infrastructure, or

| Your need | Recommended solution | Best for |
|-----------|-------------------|----------|
| Build powerful, scalable searches to quickly search, analyze, and visualize large amounts of data for real-time insights| [{{es}}](/solutions/search.md)<br>• [Get started](/solutions/search/get-started.md)| Developers, architects, data engineers |
| Build powerful, scalable searches to quickly search, analyze, and visualize large amounts of data for real-time insights| [{{es}}](/solutions/search.md)[^search-note]<br>• [Get started](/solutions/search/get-started.md)| Developers, architects, data engineers |
| Observe and monitor system health and performance, or send telemetry data | [Elastic {{observability}}](/solutions/observability.md)<br>• [Get started](/solutions/observability/get-started.md) | DevOps, SREs, IT operations |
| Monitor data for anomalous activity, detect, prevent, and respond to security incidents | [{{elastic-sec}}](/solutions/security.md)<br>• [Get started](/solutions/security/get-started.md)| SOC teams, security analysts, IT security admins |

Expand All @@ -29,6 +29,8 @@ Each of our solutions is available as a fully managed {{serverless-short}} proje

If you're new to Elastic, you can find quickstarts and introductory steps for each solution within [](/solutions/index.md).

[^search-note]: The core [{{es}} search capabilities](/solutions/search.md) are available across all deployment types, solutions, and project types through APIs and client libraries. The [{{es}} solution](/solutions/elasticsearch-solution-project.md) adds UI tools on top of these capabilities to help you build search applications faster.

<!--
## {{es}}

Expand Down
12 changes: 11 additions & 1 deletion redirects.yml
Copy link
Collaborator

Choose a reason for hiding this comment

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

assuming that this list of redirects is currently incomplete

Copy link
Contributor Author

Choose a reason for hiding this comment

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

correct

Original file line number Diff line number Diff line change
@@ -1,4 +1,14 @@
redirects:
# Search primitives moved from ES solution to Search use case
'solutions/elasticsearch-solution-project/full-text/search-with-synonyms.md': 'solutions/search/full-text/search-with-synonyms.md'
Copy link
Collaborator

Choose a reason for hiding this comment

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

I don't see this page being moved in this pr

'solutions/elasticsearch-solution-project/full-text/create-update-synonyms-api-example.md': 'solutions/search/full-text/create-update-synonyms-api-example.md'
# ES solution pages moved from Search to ES solution
'solutions/search/agent-builder/get-started.md': 'solutions/elasticsearch-solution-project/agent-builder/get-started.md'
'solutions/search/elastic-agent-builder.md': 'solutions/elasticsearch-solution-project/elastic-agent-builder.md'
'solutions/search/query-rules-ui.md': 'solutions/elasticsearch-solution-project/query-rules-ui.md'
'solutions/search/search-applications.md': 'solutions/elasticsearch-solution-project/search-applications.md'
'solutions/search/search-applications/search-application-client.md': 'solutions/elasticsearch-solution-project/search-applications/search-application-client.md'
'solutions/search/search-connection-details.md': 'solutions/elasticsearch-solution-project/search-connection-details.md'
'deploy-manage/security/secure-http-communications.md': '!deploy-manage/security/secure-cluster-communications.md'
'deploy-manage/security/manually-configure-security-in-self-managed-cluster.md': '!deploy-manage/security/self-setup.md'
'deploy-manage/security/security-certificates-keys.md': '!deploy-manage/security/self-auto-setup.md'
Expand Down Expand Up @@ -355,7 +365,7 @@ redirects:
'troubleshoot/observability/apm-agent-swift/apm-ios-agent.md': 'troubleshoot/ingest/opentelemetry/edot-sdks/ios/index.md'

# Related to https://github.com/elastic/docs-content/pull/2843
'solutions/search/serverless-elasticsearch-get-started.md': 'solutions/search/get-started.md'
'solutions/search/serverless-elasticsearch-get-started.md': 'solutions/elasticsearch-solution-project/get-started.md'

# Related to https://github.com/elastic/docs-content/pull/3032
'manage-data/lifecycle/index-lifecycle-management/tutorial-automate-rollover.md': 'manage-data/lifecycle/index-lifecycle-management/ilm-tutorials.md'
Expand Down
2 changes: 1 addition & 1 deletion reference/elasticsearch-clients/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,5 +22,5 @@ products:
- [Rust](elasticsearch-rs://reference/index.md)

::::{tip}
Learn how to [connect to your {{es}} endpoint](/solutions/search/search-connection-details.md).
Learn how to [connect to your {{es}} endpoint](/solutions/elasticsearch-solution-project/search-connection-details.md).
Copy link
Collaborator

Choose a reason for hiding this comment

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

do we care to tell people how to connect to these in other contexts, if we can assume that clients are solution-agnostic? probably a problem for later

Copy link
Contributor Author

Choose a reason for hiding this comment

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

good q not sure, need to check what the experience is like on other project types too + if we should have a raw non-UI section for connection details

::::
2 changes: 1 addition & 1 deletion release-notes/elastic-cloud-serverless/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -431,7 +431,7 @@ Review the changes, fixes, and more to {{serverless-full}}.

### Features and enhancements [serverless-changelog-10202025-features-enhancements]

* [Agent Builder](/solutions/search/elastic-agent-builder.md) is now available in technical preview and is enabled by default on {{serverless-full}}
* [Agent Builder](/solutions/elasticsearch-solution-project/elastic-agent-builder.md) is now available in technical preview and is enabled by default on {{serverless-full}}
* Lets you remove root privileges from {{fleet}} managed agents [#237790]({{kib-pull}}237790)
* Adds the `xpack.fleet.experimentalFeatures` setting [#238840]({{kib-pull}}238840)
* Supports expression suggestions within function parameters [#236343]({{kib-pull}}236343)
Expand Down
66 changes: 66 additions & 0 deletions solutions/elasticsearch-solution-project.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,66 @@
---
mapped_pages:
- https://www.elastic.co/guide/en/serverless/current/what-is-elasticsearch-serverless.html
- https://www.elastic.co/guide/en/kibana/current/search-space.html
applies_to:
stack:
serverless:
products:
- id: elasticsearch
- id: cloud-serverless
- id: kibana
navigation_title: Elasticsearch solution
---

# {{es}} solution overview

The {{es}} solution and serverless project type provide specialized UI tools that help you build search applications faster. The solution is an optional complement to the core {{es}} [search capabilities](/solutions/search.md) which are available through APIs across all deployment types, solutions, and project types.[^api-note]

These UI affordances are exclusive to the {{es}} solution (on non-serverless deployments) and the {{es}} serverless project type.

::::{tip}
Not sure which deployment type is right for you? Use the following resources to help you decide:

- Read the Elastic [deployment types overview](/deploy-manage/deploy.md)
- Compare [serverless and {{ech}}](/deploy-manage/deploy/elastic-cloud/differences-from-other-elasticsearch-offerings.md)
- Compare pricing models between [Elastic Cloud](/deploy-manage/cloud-organization/billing/cloud-hosted-deployment-billing-dimensions.md) and [Serverless](/deploy-manage/cloud-organization/billing/serverless-project-billing-dimensions.md)
::::


## Features and tools

The {{es}} solution provides the following specialized UI tools and features to help you build search applications faster:

### Agent Builder

[Agent Builder](/solutions/elasticsearch-solution-project/elastic-agent-builder.md) enables you to create AI agents that can interact with your {{es}} data, execute queries, and provide intelligent responses. It provides a complete framework for building conversational AI experiences on top of your search infrastructure.
Copy link
Collaborator

Choose a reason for hiding this comment

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

snippetable


### Playground

[Playground](/solutions/elasticsearch-solution-project/playground.md) lets you use large language models (LLMs) to understand, explore, and analyze your {{es}} data using retrieval augmented generation (RAG), via a chat interface. Playground is also useful for testing and debugging your {{es}} queries using the [retrievers](/solutions/search/retrievers-overview.md) syntax.

### Synonyms UI

The [synonyms UI](/solutions/search/full-text/search-with-synonyms.md#method-1-kib-ui) enables managing synonym sets directly within {{kib}}. This makes it easier to improve search relevance without editing configuration files.

### Query Rules UI

The [Query Rules UI](/solutions/elasticsearch-solution-project/query-rules-ui.md) enables you to create and manage query rules that modify search behavior based on specific conditions, helping you deliver more relevant results for common queries.

### Model Context Protocol (MCP)

The [Model Context Protocol (MCP)](/solutions/elasticsearch-solution-project/mcp.md) lets you connect AI agents and assistants to your {{es}} data to enable natural language interactions with your indices.

## Get started

Ready to start using the {{es}} solution? Refer to [Get started](/solutions/elasticsearch-solution-project/get-started.md) for setup instructions and quickstart guides.

For a deeper understanding of search concepts and techniques, refer to the [Search use case](/solutions/search.md) documentation.

## Related reference

* [Search use case documentation](/solutions/search.md)
* [{{es}} reference documentation](elasticsearch://reference/elasticsearch/index.md)
* [{{es}} API documentation]({{es-apis}})

[^api-note]: Certain APIs are not available on serverless deployments because they are fully managed by Elastic. Refer to [Available Elasticsearch APIs](/deploy-manage/deploy/elastic-cloud/differences-from-other-elasticsearch-offerings.md#elasticsearch-differences-serverless-apis-availability) for details.
Original file line number Diff line number Diff line change
Expand Up @@ -13,9 +13,9 @@ applies_to:
Learn how to get started by enabling the {{agent-builder}} features and begin chatting with your data.

::::::{stepper}
::::{step} Set up an Elastic deployment
::::{step} Set up an {{es}} deployment

If you don't already have an Elastic deployment, refer to [Select your deployment type](/solutions/search/get-started.md#choose-your-deployment-type).
If you don't already have an {{es}} deployment, refer to [Get started with search](/solutions/search/get-started.md).

:::{note}
For {{ech}} deployments, make sure you are using the solution navigation instead of classic navigation.
Expand Down Expand Up @@ -68,7 +68,7 @@ For a broader overview of ingestion options, go to [](/manage-data/ingest.md).
:::{tip}
If you're not ready to add your own data, you can:
- Use the Elastic [sample data](/manage-data/ingest/sample-data.md).
- Generate synthetic financial data using [this Python tool](https://github.com/jeffvestal/synthetic-financial-data?tab=readme-ov-file#synthetic-financial-data-generator-). (This requires your [{{es}} URL and an API key](/solutions/search/search-connection-details.md)).
- Generate synthetic financial data using [this Python tool](https://github.com/jeffvestal/synthetic-financial-data?tab=readme-ov-file#synthetic-financial-data-generator-). (This requires your [{{es}} URL and an API key](/solutions/elasticsearch-solution-project/search-connection-details.md)).

% TODO: we can link to a an agent builder tutorial if we add one in the docs
:::
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,7 @@ curl -X GET "https://${KIBANA_URL}/api/agent_builder/tools" \
```
:::{tip}
To generate API keys, search for `API keys` in the [global search bar](/explore-analyze/find-and-organize/find-apps-and-objects.md).
[Learn more](https://www.elastic.co/docs/solutions/search/search-connection-details).
[Learn more](/solutions/elasticsearch-solution-project/search-connection-details.md).
:::

### Working with Spaces
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -63,7 +63,7 @@ export KIBANA_URL="your-kibana-url"
export API_KEY="your-api-key"
```

For information on generating API keys, refer to [API keys](https://www.elastic.co/docs/solutions/search/search-connection-details).
For information on generating API keys, refer to [](/deploy-manage/api-keys/serverless-project-api-keys.md).

Tools execute with the scope assigned to the API key. Make sure your API key has the appropriate permissions to only access the indices and data that you want to expose through the MCP server. To learn more, refer to [](#api-key-application-privileges).
:::
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -69,7 +69,7 @@ The following models are not compatible with {{agent-builder}}:

- **OpenAI**: GPT-5-chat

Learn more about [incompatible LLMs](/solutions/search/agent-builder/limitations-known-issues.md#incompatible-llms).
Learn more about [incompatible LLMs](/solutions/elasticsearch-solution-project/agent-builder/limitations-known-issues.md#incompatible-llms).

### Why model quality matters

Expand Down
Loading
Loading