Skip to content

Commit 8c7375d

Browse files
first take at getting started (elastic#973)
1 parent 0505ff8 commit 8c7375d

File tree

5 files changed

+64
-74
lines changed

5 files changed

+64
-74
lines changed

deploy-manage/deploy/_snippets/installation-order.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
If you're deploying the {{stack}} in a self-managed cluster, then install the {{stack}} products you want to use in the following order:
22

3-
* {{es}}
4-
* {{kib}}
3+
* [{{es}}](/deploy-manage/deploy/self-managed/installing-elasticsearch.md)
4+
* [{{kib}}](/deploy-manage/deploy/self-managed/install-kibana.md)
55
* [Logstash](logstash://reference/index.md)
66
* [{{agent}}](/reference/fleet/index.md) or [Beats](beats://reference/index.md)
77
* [APM](/solutions/observability/apps/application-performance-monitoring-apm.md)

get-started/index.md

Lines changed: 25 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -7,24 +7,43 @@ mapped_pages:
77
---
88
# Get started
99

10-
## Overview
10+
## Overview [what-is-es]
11+
12+
[{{es}}](https://github.com/elastic/elasticsearch) is a distributed search and analytics engine, scalable data store, and vector database built on Apache Lucene. It’s optimized for speed and relevance on production-scale workloads. Use {{es}} to search, index, store, and analyze data of all shapes and sizes in near real time. [{{kib}}](https://github.com/elastic/kibana) is the graphical user interface for {{es}}. It’s a powerful tool for visualizing and analyzing your data, and for managing and monitoring the Elastic Stack.
1113

1214
{{es}} is the heart of the [Elastic Stack](the-stack.md). Combined with {{kib}}, it powers these Elastic solutions and use cases:
1315

14-
* [Observability](/solutions/observability.md)
15-
* [Security](/solutions/security.md)
16-
* [Search](/solutions/search.md)
16+
* **[Elasticsearch](/solutions/search.md)**: Build powerful search and RAG applications using Elasticsearch's vector database, AI toolkit, and advanced retrieval capabilities.
17+
* **[Observability](/solutions/observability.md)**: Resolve problems with open, flexible, and unified observability powered by advanced machine learning and analytics.
18+
* **[Security](/solutions/security.md)**: Detect, investigate, and respond to threats with AI-driven security analytics to protect your organization at scale.
1719

1820
:::{tip}
1921
Refer to our [customer success stories](https://www.elastic.co/customers/success-stories) for concrete examples of how Elastic is used in real-world scenarios.
2022
:::
2123

24+
## Choose your deployment type
25+
26+
:::{include} /deploy-manage/_snippets/deployment-options-overview.md
27+
:::
28+
29+
## Explore the solutions
30+
31+
Elasticsearch supports diverse use cases. Select a solution and follow its dedicated getting-started guide:
32+
33+
| | |
34+
| --- | --- |
35+
| | |
36+
| ![elasticsearch](https://www.elastic.co/docs/assets/images/elasticsearch.png "elasticsearch =50%") | **Elasticsearch**<br> Create seamless search experiences for apps, websites, or workplaces.<br><br>[**Get started →**](../solutions/search/get-started.md)<br> |
37+
| ![observability](https://www.elastic.co/docs/assets/images/observability.png "observability =50%") | **Observability**<br> Monitor logs, metrics, and traces to gain insight into your systems.<br><br>[**Get started →**](../solutions/observability/get-started.md)<br> |
38+
| ![security](https://www.elastic.co/docs/assets/images/security.png "security =50%") | **Security**<br> Monitor logs, metrics, and traces to gain insight into your systems.<br><br>[**Get started →**](../solutions/security/get-started.md)<br> |
39+
2240
## Next steps
2341

24-
Get started by learning about:
42+
For learn more about our products and solutions, see:
2543

2644
- [{{es}} and {{kib}}](introduction.md), the core components of the {{stack}}.
2745
- [The stack](/get-started/the-stack.md) to understand the relationship between core and optional components of an Elastic deployment.
2846
- [The out-of-the-box solutions and use cases](/solutions/index.md) that Elastic supports.
2947
- [Deploying Elastic](./deployment-options.md) for your use case.
30-
- [Versioning and availability](./versioning-availability.md) in Elastic deployments.
48+
- [Versioning and availability](./versioning-availability.md) in Elastic deployments.
49+

get-started/introduction.md

Lines changed: 18 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -3,60 +3,40 @@ mapped_pages:
33
- https://www.elastic.co/guide/en/elasticsearch/reference/current/elasticsearch-intro-what-is-es.html
44
---
55

6-
# {{es}} and {{kib}} [introduction]
6+
# Use cases [introduction]
7+
$$$what-is-kib$$$
8+
$$$what-is-es$$$
79

8-
## What is {{es}}?
9-
10-
[{{es}}](https://github.com/elastic/elasticsearch) is a distributed search and analytics engine, scalable data store, and vector database built on Apache Lucene. It’s optimized for speed and relevance on production-scale workloads. Use {{es}} to search, index, store, and analyze data of all shapes and sizes in near real time.
11-
12-
You can deploy {{es}} as a standalone service to build custom search and analytics solutions or deploy it together with other Elastic products, using various [deployment options](./deployment-options.md).
13-
14-
Explore the full list of [{{es}} features](https://www.elastic.co/elasticsearch/features) on the product webpage.
15-
16-
To learn more about the internals of the data store, refer to [](/manage-data/data-store.md).
17-
18-
::::{tip}
19-
Want to get started quickly with the {{es}} API? Check out our hands-on [quick start tutorials](/solutions/search/api-quickstarts.md) and [Python notebooks](https://github.com/elastic/elasticsearch-labs/tree/main/notebooks#readme).
20-
::::
21-
22-
## What is {{kib}}?
23-
24-
[{{kib}}](https://github.com/elastic/kibana) is the graphical user interface for {{es}}. It’s a powerful tool for visualizing and analyzing your data, and for managing and monitoring the Elastic Stack.
25-
26-
Together, {{es}} and {{kib}} form the core of the [Elastic Stack](the-stack.md).
27-
28-
They power all Elastic solutions and use cases:
10+
The {{stack}} is used for a wide and growing range of use cases. Here are a few examples:
2911

30-
- [Observability](/solutions/observability.md)
31-
- [Security](/solutions/security.md)
32-
- [Search](/solutions/search.md)
12+
## Elasticsearch
3313

34-
## Use cases
14+
- **Full-text search**: Build a fast, relevant full-text search solution using inverted indexes, tokenization, and text analysis.
15+
- **Vector database**: Store and search vectorized data, and create vector embeddings with built-in and third-party natural language processing (NLP) models.
16+
- **Semantic search**: Understand the intent and contextual meaning behind search queries using tools like synonyms, dense vector embeddings, and learned sparse query-document expansion.
17+
- **Hybrid search**: Combine full-text search with vector search using state-of-the-art ranking algorithms.
18+
- **Build search experiences**: Add hybrid search capabilities to apps or websites, or build enterprise search engines over your organization’s internal data sources.
19+
- **Retrieval augmented generation (RAG)**: Use {{ecloud}} as a retrieval engine to supplement generative AI models with more relevant, up-to-date, or proprietary data for a range of use cases.
20+
- **Geospatial search**: Search for locations and calculate spatial relationships using geospatial queries.
3521

36-
The {{stack}} is used for a wide and growing range of use cases. Here are a few examples:
22+
[**Get started with {{es}} **](../solutions/search/get-started.md)
3723

38-
**Observability**
24+
## Observability
3925

4026
- **Logs, metrics, and traces**: Collect, store, and analyze logs, metrics, and traces from applications, systems, and services.
4127
- **Application performance monitoring (APM)**: Monitor and analyze the performance of business-critical software applications.
4228
- **Real user monitoring (RUM)**: Monitor, quantify, and analyze user interactions with web applications.
4329
- **OpenTelemetry**: Reuse your existing instrumentation to send telemetry data to the Elastic Stack using the OpenTelemetry standard.
4430

45-
**Security**
31+
[**Get started with {{observability}} →**](../solutions/observability/get-started.md)
32+
33+
## Security
4634

4735
- **Security information and event management (SIEM)**: Collect, store, and analyze security data from applications, systems, and services.
4836
- **Endpoint security**: Monitor and analyze endpoint security data.
4937
- **Threat hunting**: Search and analyze data to detect and respond to security threats.
5038

51-
**Search**
52-
53-
- **Full-text search**: Build a fast, relevant full-text search solution using inverted indexes, tokenization, and text analysis.
54-
- **Vector database**: Store and search vectorized data, and create vector embeddings with built-in and third-party natural language processing (NLP) models.
55-
- **Semantic search**: Understand the intent and contextual meaning behind search queries using tools like synonyms, dense vector embeddings, and learned sparse query-document expansion.
56-
- **Hybrid search**: Combine full-text search with vector search using state-of-the-art ranking algorithms.
57-
- **Build search experiences**: Add hybrid search capabilities to apps or websites, or build enterprise search engines over your organization’s internal data sources.
58-
- **Retrieval augmented generation (RAG)**: Use {{ecloud}} as a retrieval engine to supplement generative AI models with more relevant, up-to-date, or proprietary data for a range of use cases.
59-
- **Geospatial search**: Search for locations and calculate spatial relationships using geospatial queries.
39+
[**Get started with {{elastic-sec}} →**](../solutions/security/get-started.md)
6040

6141
This is just a sample of search, observability, and security use cases enabled by {{ecloud}}. Refer to Elastic [customer success stories](https://www.elastic.co/customers/success-stories) for concrete examples across a range of industries.
6242

get-started/the-stack.md

Lines changed: 18 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -35,58 +35,49 @@ If you want to transform or enrich data before it’s stored, you can use {{es}}
3535

3636
Trying to decide which ingest component to use? Refer to [Adding data to {{es}}](/manage-data/ingest.md) to help you decide.
3737

38-
$$$stack-components-agent$$$
38+
#### {{fleet}} and {{agent}} [stack-components-agent]
3939

40-
{{fleet}} and {{agent}}
41-
: {{agent}} is a single, unified way to add monitoring for logs, metrics, and other types of data to a host. It can also protect hosts from security threats, query data from operating systems, forward data from remote services or hardware, and more. Each agent has a single policy to which you can add integrations for new data sources, security protections, and more.
40+
{{agent}} is a single, unified way to add monitoring for logs, metrics, and other types of data to a host. It can also protect hosts from security threats, query data from operating systems, forward data from remote services or hardware, and more. Each agent has a single policy to which you can add integrations for new data sources, security protections, and more.
4241

43-
{{fleet}} enables you to centrally manage {{agents}} and their policies. Use {{fleet}} to monitor the state of all your {{agents}}, manage agent policies, and upgrade {{agent}} binaries or integrations.
42+
{{fleet}} enables you to centrally manage {{agents}} and their policies. Use {{fleet}} to monitor the state of all your {{agents}}, manage agent policies, and upgrade {{agent}} binaries or integrations.
4443

45-
[Learn more about {{fleet}} and {{agent}}](/reference/fleet/index.md).
44+
[Learn more about {{fleet}} and {{agent}}](/reference/fleet/index.md).
4645

46+
#### APM [stack-components-apm]
4747

48-
$$$stack-components-apm$$$
48+
Elastic APM is an application performance monitoring system built on the {{stack}}. It allows you to monitor software services and applications in real-time, by collecting detailed performance information on response time for incoming requests, database queries, calls to caches, external HTTP requests, and more. This makes it easy to pinpoint and fix performance problems quickly. [Learn more about APM](/solutions/observability/apps/application-performance-monitoring-apm.md).
4949

50-
APM
51-
: Elastic APM is an application performance monitoring system built on the {{stack}}. It allows you to monitor software services and applications in real-time, by collecting detailed performance information on response time for incoming requests, database queries, calls to caches, external HTTP requests, and more. This makes it easy to pinpoint and fix performance problems quickly. [Learn more about APM](/solutions/observability/apps/application-performance-monitoring-apm.md).
50+
#### {{beats}} [stack-components-beats]
5251

53-
$$$stack-components-beats$$$
52+
{{beats}} are data shippers that you install as agents on your servers to send operational data to {{es}}. {{beats}} are available for many standard observability data scenarios, including audit data, log files and journals, cloud data, availability, metrics, network traffic, and Windows event logs. [Learn more about {{beats}}](beats://reference/index.md).
5453

55-
{{beats}}
56-
: {{beats}} are data shippers that you install as agents on your servers to send operational data to {{es}}. {{beats}} are available for many standard observability data scenarios, including audit data, log files and journals, cloud data, availability, metrics, network traffic, and Windows event logs. [Learn more about {{beats}}](beats://reference/index.md).
54+
#### {{es}} ingest pipelines [stack-components-ingest-pipelines]
5755

58-
$$$stack-components-ingest-pipelines$$$
56+
Ingest pipelines let you perform common transformations on your data before indexing them into {{es}}. You can configure one or more "processor" tasks to run sequentially, making specific changes to your documents before storing them in {{es}}. [Learn more about ingest pipelines](/manage-data/ingest/transform-enrich/ingest-pipelines.md).
5957

60-
{{es}} ingest pipelines
61-
: Ingest pipelines let you perform common transformations on your data before indexing them into {{es}}. You can configure one or more "processor" tasks to run sequentially, making specific changes to your documents before storing them in {{es}}. [Learn more about ingest pipelines](/manage-data/ingest/transform-enrich/ingest-pipelines.md).
58+
#### {{ls}} [stack-components-logstash]
6259

63-
$$$stack-components-logstash$$$
64-
65-
{{ls}}
66-
: {{ls}} is a data collection engine with real-time pipelining capabilities. It can dynamically unify data from disparate sources and normalize the data into destinations of your choice. {{ls}} supports a broad array of input, filter, and output plugins, with many native codecs further simplifying the ingestion process. [Learn more about {{ls}}](logstash://reference/index.md).
60+
{{ls}} is a data collection engine with real-time pipelining capabilities. It can dynamically unify data from disparate sources and normalize the data into destinations of your choice. {{ls}} supports a broad array of input, filter, and output plugins, with many native codecs further simplifying the ingestion process. [Learn more about {{ls}}](logstash://reference/index.md).
6761

6862

6963
### Store [_store]
7064

71-
$$$stack-components-elasticsearch$$$
65+
#### {{es}} [stack-components-elasticsearch]
7266

73-
{{es}}
74-
: {{es}} is the distributed search and analytics engine at the heart of the {{stack}}. It provides near real-time search and analytics for all types of data. Whether you have structured or unstructured text, numerical data, or geospatial data, {{es}} can efficiently store and index it in a way that supports fast searches. {{es}} provides a REST API that enables you to store data in {{es}} and retrieve it. The REST API also provides access to {{es}}'s search and analytics capabilities. [Learn more about {{es}}](/get-started/index.md).
67+
{{es}} is the distributed search and analytics engine at the heart of the {{stack}}. It provides near real-time search and analytics for all types of data. Whether you have structured or unstructured text, numerical data, or geospatial data, {{es}} can efficiently store and index it in a way that supports fast searches. {{es}} provides a REST API that enables you to store data in {{es}} and retrieve it. The REST API also provides access to {{es}}'s search and analytics capabilities. [Learn more about {{es}}](/get-started/index.md).
7568

7669

7770
### Consume [_consume]
7871

7972
Use {{kib}} to query and visualize the data that’s stored in {{es}}. Or, use the {{es}} clients to access data in {{es}} directly from common programming languages.
8073

81-
$$$stack-components-kibana$$$
74+
#### {{kib}} [stack-components-kibana]
8275

83-
{{kib}}
84-
: {{kib}} is the tool to harness your {{es}} data and to manage the {{stack}}. Use it to analyze and visualize the data that’s stored in {{es}}. {{kib}} is also the home for the Search, Observability and Security solutions. [Learn more about {{kib}}](/explore-analyze/index.md).
76+
{{kib}} is the tool to harness your {{es}} data and to manage the {{stack}}. Use it to analyze and visualize the data that’s stored in {{es}}. {{kib}} is also the home for the Search, Observability and Security solutions. [Learn more about {{kib}}](/explore-analyze/index.md).
8577

86-
$$$stack-components-elasticsearch-clients$$$
78+
#### {{es}} clients [stack-components-elasticsearch-clients]
8779

88-
{{es}} clients
89-
: The clients provide a convenient mechanism to manage API requests and responses to and from {{es}} from popular languages such as Java, Ruby, Go, Python, and others. Both official and community contributed clients are available. [Learn more about the {{es}} clients](https://www.elastic.co/guide/en/elasticsearch/client/index.html).
80+
The clients provide a convenient mechanism to manage API requests and responses to and from {{es}} from popular languages such as Java, Ruby, Go, Python, and others. Both official and community contributed clients are available. [Learn more about the {{es}} clients](https://www.elastic.co/guide/en/elasticsearch/client/index.html).
9081

9182
## Version compatibility
9283
```{applies_to}

manage-data/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ applies_to:
66

77
# Manage data
88

9-
Whether you're looking to build a fast and relevant search solution, monitor business-critical applications and infrastructure, monitor endpoint security data, or one of the [many other use cases Elastic supports](/get-started/introduction.md#use-cases), you'll need to understand how to ingest and manage data stored in {{es}}.
9+
Whether you're looking to build a fast and relevant search solution, monitor business-critical applications and infrastructure, monitor endpoint security data, or one of the [many other use cases Elastic supports](/get-started/introduction.md), you'll need to understand how to ingest and manage data stored in {{es}}.
1010

1111
## Learn how data is stored
1212

0 commit comments

Comments
 (0)