diff --git a/deploy-manage/deploy/self-managed.md b/deploy-manage/deploy/self-managed.md index 7591b2f9ac..582df38e81 100644 --- a/deploy-manage/deploy/self-managed.md +++ b/deploy-manage/deploy/self-managed.md @@ -33,7 +33,8 @@ For a comparison of these deployment options, refer to [Choosing your deployment This section focuses on deploying {{es}} and {{kib}} without an orchestrator. -Depending on your use case, you might need to deploy other components, such as APM, Fleet, or Logstash. Deploying those components is not covered in this section. [Learn more about optional components](/get-started/the-stack.md). +Depending on your use case, you might need to deploy other components, such as APM, Fleet, or Logstash. +Deploying those components is not covered in this section. [Learn more about optional components](/get-started/the-stack.md). This section covers the following tasks: diff --git a/docset.yml b/docset.yml index 71608e8f6a..1060f588db 100644 --- a/docset.yml +++ b/docset.yml @@ -27,6 +27,7 @@ cross_links: - cloud-on-k8s - curator - detection-rules + - docs-content - ecctl - ecs - ecs-dotnet diff --git a/extend/index.md b/extend/index.md index 110f8b8de8..bf6c6b8f43 100644 --- a/extend/index.md +++ b/extend/index.md @@ -1,26 +1,58 @@ -# Extend and contribute +# Extend and contribute -This section contains information on how to extend or contribute to our various products. +You can extend and build on the Elastic Platform in several ways. Whether you need to get data into Elasticsearch, add new functionality, edit the documentation, or build a custom application, here is an overview of the primary development paths to help you choose the right one for your project. -## Contributing to Elastic documentation +There are two main approaches to extending Elastic: creating standardized Integrations for data ingestion or building custom solutions by developing directly against our REST APIs. + +## Path 1: Create an Elastic Integration + +If your primary goal is to bring a new data source into the Elastic Stack in a standardized, reusable way, building an Elastic Integration is the best path. Integrations are pre-packaged assets that make it simple for users to collect and process data from a specific service or platform. + +This approach is ideal for shipping data, logs, metrics, and traces. By building an integration, you contribute to the ever-growing ecosystem that both you and the community can benefit from. + +* Integrations are built on a consistent framework, providing users with a turnkey experience, including dashboards, visualizations, and alerts. +* **`elastic-package`** is a command-line tool that is your primary interface for creating, testing, and packaging your integration. It scaffolds the entire project structure, letting you focus on the logic for data collection. +* Your integration will run on the Elastic Agent, our single, unified agent for data shipping. + +**When to choose this path** -You can contribute to the Elastic documentation in several ways. +* You want to ingest data from a new data source, like a database, API, or log file. +* You want to provide a standardized, out-of-the-box experience for other users. +* You need to process and structure data according to the Elastic Common Schema (ECS). -Refer to [Contribute to Elastic documentation](./contribute/index.md) for an overview. +**Ready to start?** Head over to the [Create an Integration](integrations://extend/index.md) guide. -## Contributing to Elastic Projects +## Path 2: Develop against the REST APIs -You can contribute to various projects, including: +For complete control and custom development, you can interact directly with Elastic's REST APIs. This path is perfect for building custom applications, automating complex workflows, and integrating Elastic into your existing infrastructure in a bespoke way. For example, you can programmatically manage your cluster, run complex queries, manage security settings, and interact with Kibana. -- [Kibana](kibana://extend/index.md): Enhance our data visualization platform by contributing to Kibana. -- [Logstash](logstash://extend/index.md): Help us improve the data processing pipeline with your contributions to Logstash. -- [Beats](beats://extend/index.md): Add new features or beats to our lightweight data shippers. +* The APIs provide direct access to the core capabilities of Elasticsearch and Kibana. If you can do it in the UI, you can automate it with the API. +* Elastic provides and supports official [clients](/reference/elasticsearch-clients/index.md) for popular languages like Java, Go, .NET, PHP, Python, Ruby, and JavaScript. These clients simplify interacting with the API, handling requests, and processing responses. +* The APIs are secured using role-based access control (RBAC). You can create API keys or use bearer tokens with fine-grained permissions to ensure your interactions are safe. -## Creating Integrations +### Elastic APIs at a glance -Extend the capabilities of Elastic by creating integrations that connect Elastic products with other tools and systems. Visit our [Integrations Guide](integrations://extend/index.md) to get started. +* Use the Elasticsearch APIs to: -## Elasticsearch Plugins + * Create, read, update, and delete documents. + * Perform everything from simple keyword searches to complex analytical aggregations. + * Monitor cluster health, manage nodes, and configure settings. + * Manage users, roles, and API keys. -Develop custom plugins to add new functionalities to Elasticsearch. Check out our [Elasticsearch Plugins Development Guide](elasticsearch://extend/index.md) for detailed instructions and best practices. +* Use the Kibana APIs to programmatically control the Kibana front-end and its objects: + + * Create and manage dashboards, visualizations, and saved searches. + * Automate the organization of content within Kibana. + * Create and manage rules for detecting conditions within your data. + +**When to choose this path** + +* You are building a custom application that uses Elasticsearch as its backend. +* You need to automate administrative tasks, such as creating users or managing index lifecycle policies. +* You are integrating Elastic's search and analytics capabilities into another platform. + +Ready to get started? Explore the [Elastic API Reference]({{apis}}). + +## Contributing to Elastic documentation +You can contribute to the Elastic documentation in several ways. Refer to [Contribute to Elastic documentation](./contribute/index.md) for an overview. diff --git a/get-started/deployment-options.md b/get-started/deployment-options.md index b6dcdf4e5b..59ad319f61 100644 --- a/get-started/deployment-options.md +++ b/get-started/deployment-options.md @@ -1,17 +1,41 @@ --- +navigation_title: Deployment options mapped_pages: - https://www.elastic.co/guide/en/elasticsearch/reference/current/elasticsearch-intro-deploy.html products: - id: elasticsearch +applies_to: + serverless: + stack: --- -# Deployment options [elasticsearch-intro-deploy] +# Deployment options + +You can run Elastic on any infrastructure, allowing you to choose the model that best fits your operational needs. Use this page for a quick overview of your options for deploying Elastic. -:::{include} /deploy-manage/_snippets/deployment-options-overview.md -::: +## Why your deployment choice matters + +Your deployment type significantly impacts the capabilities available across your Elastic environment and the amount of manual work required to set up and maintain it. Some deployment types provide automated orchestration that handles scaling, upgrades, and monitoring across multiple clusters, while others require you to manage these operational tasks manually. + +The choice you make determines how much time you'll spend on infrastructure management versus focusing on using Elastic's features to solve your business problems. + +## Quick start options + +These are the most common deployment types and their main features: + +* **[{{ecloud}}](/deploy-manage/deploy/elastic-cloud.md)**: Get a hosted solution up and running in minutes. + * **[{{ech}}](/deploy-manage/deploy/elastic-cloud/cloud-hosted.md)**: This offering, managed through [{{ecloud}}](/deploy-manage/deploy/elastic-cloud.md), provides you with a dedicated cluster on your choice of cloud provider (AWS, GCP, or Azure). It offers high control over your cluster's configuration, allowing you to fine-tune nodes, hardware, and versions to meet specific performance and architectural requirements. Sign up for a [14-day free trial](https://cloud.elastic.co/registration). + * **[{{serverless-full}}](/deploy-manage/deploy/elastic-cloud/serverless.md)**: This fully managed SaaS offering managed through [{{ecloud}}](/deploy-manage/deploy/elastic-cloud.md) abstracts away all underlying infrastructure, automatically and seamlessly scaling resources to meet your workload demands. It's designed for operational simplicity, with usage-based pricing that allows you to focus on your data without managing clusters. Sign up for a [14-day free trial](https://cloud.elastic.co/serverless-registration). +* **[Local development](/deploy-manage/deploy/self-managed/local-development-installation-quickstart.md)**: Get started quickly with {{es}} and {{kib}} in Docker for local development and testing. + +## Advanced options + +* **[Self-managed](/deploy-manage/deploy/self-managed.md)**: This approach allows you to install, operate, and maintain components of the {{stack}} on your own hardware, whether on-premises or in your private cloud. It provides maximum control over your environment. +* **[{{ece}}](/deploy-manage/deploy/cloud-enterprise.md)**: This Elastic self-managed offering allows you to provision, manage, and monitor components of the {{stack}} at any scale and on any infrastructure, while managing everything from a single console. +* **[{{eck}}](/deploy-manage/deploy/cloud-on-k8s.md)**: This extends Kubernetes by providing an official operator for deploying and managing components of the {{stack}}. It's ideal if you want to run and orchestrate Elastic on your own Kubernetes platform. :::{tip} -Refer to [](/deploy-manage/index.md) for detailed information and guidance on choosing the right deployment for your needs. +Refer to [Deploy and manage](/deploy-manage/index.md) for detailed information and guidance on selecting the appropriate deployment for your needs. ::: diff --git a/get-started/howto-use-the-docs.md b/get-started/howto-use-the-docs.md new file mode 100644 index 0000000000..f4a82f786b --- /dev/null +++ b/get-started/howto-use-the-docs.md @@ -0,0 +1,176 @@ +--- +applies_to: + serverless: + stack: +--- +# How to use the documentation + +Our documentation is organized to guide you through your journey with Elastic, from learning the basics to deploying and managing complex solutions. + +Here is a detailed breakdown of the documentation structure: + +* [**Elastic fundamentals**](/get-started/index.md): Understand the basics about the deployment options, platform, solutions, and features of the documentation. +* [**Solutions and use cases**](/solutions/index.md): Learn use cases, evaluate, and implement Elastic's solutions: Observability, Search, and Security. +* [**Manage data**](/manage-data/index.md): Learn about data store primitives, ingestion and enrichment, managing the data lifecycle, and migrating data. +* [**Explore and analyze**](/explore-analyze/index.md): Get value from data through querying, visualization, machine learning, and alerting. +* [**Deploy and manage**](/deploy-manage/index.md): Deploy and manage production-ready clusters. Covers deployment options and maintenance tasks. +* [**Manage your Cloud account**](/cloud-account/index.md): A dedicated section for user-facing cloud account tasks like resetting passwords. +* [**Troubleshoot**](/troubleshoot/index.md): Identify and resolve problems. +* [**Extend and contribute**](/extend/index.md): How to contribute to or integrate with Elastic, from open source to plugins to integrations. +* [**Release notes**](/release-notes/index.md): Contains release notes and changelogs for each new release. +* [**Reference**](/reference/index.md): Reference material for core tasks and manuals for other Elastic products. + +## Applicability badges + +Because you can deploy Elastic products in different ways (like on {{ecloud}} or in your own data center) and have different versions, not all documentation applies to every user. To help you quickly see if a topic is relevant to your situation, we use **applicability badges**. + +These badges appear at the top of a page or section and tell you which products, deployment models, and versions the content applies to. They also indicate the maturity level of a feature, such as **beta**, **technical preview**, or **generally available (GA)**. This system ensures that you can identify content specific to your environment and version. + +:::{tip} +A **Stack** badge indicates that a page applies to [{{stack}}](/get-started/the-stack.md) components across all deployment options except {{serverless-full}}. If a page applies to all deployment options, it will have **{{serverless-short}}** and Stack badges. +::: + +## Page options + +On each documentation page, you'll find several links that allow you to interact with the content: + +* **View as Markdown**: This link shows you the raw Markdown source code for the page you're viewing. This can be helpful if you want to reuse the source or feed the document to AI. +* **Edit this page**: Selecting this link will take you directly to the page's source file in its GitHub repository. From there, you can propose edits, which our team will review. +* **Report an issue**: If you've found a problem, like a typo, a technical error, or confusing content, but don't want to edit the page yourself, use this link. It will open a new issue in our GitHub repository, pre-filled with information about the page you were on, so you can describe the problem in detail. + +## Versioned documentation + +Starting with Elastic Stack 9.0, Elastic no longer publishes separate documentation sets for each minor release. Instead, all changes in the 9.x series are included in a single, continuously updated documentation set. + +This approach helps: + +* Reduce duplicate pages. +* Show the full history and context of a feature. +* Simplify search and navigation. + +We clearly mark content added or changed in a specific version using availability badges. The availability badges appear in page headers, section headers, and inline. + +### Elastic Stack example + +{applies_to}`stack: ga 9.1.0` + +This means the feature is: + +* Generally Available (GA) in the [{{stack}}](/get-started/the-stack.md) across all deployment options except {{serverless-full}} +* Introduced in version 9.1.0 + +:::{tip} +If a page applies to all deployment options including {{serverless-full}}, it will have both {{serverless-short}} and Stack badges. +::: + +### Serverless example + +{applies_to}`serverless: ga` {applies_to}`security: beta` + +This means the feature is: + +* Generally Available for {{es-serverless}} projects +* Beta for {{sec-serverless}} projects + +### Elastic Cloud Enterprise example + +{applies_to}`ece: deprecated 4.1.0` + +This means the feature is: + +* Available on Elastic Cloud Enterprise +* Deprecated starting in version 4.1.0 + +:::{tip} +Want to learn more about how availability badges are used? Check the [Elastic Docs syntax guide](https://elastic.github.io/docs-builder/syntax/applies/). +::: + +## Accessing previous versions + +You can browse documentation for different versions of our products in two ways: + +* **Version menu:** On most documentation pages, you'll find a version menu. Clicking this menu allows you to switch to a different version of the documentation for the content you are currently viewing. +* **All documentation versions page:** For a complete list of all available documentation versions for all Elastic products, you can visit the [All documentation versions](/versions.md) page. + +## Find docs for your product version + +Find the documentation for your Elastic product versions or releases. + +### Elastic Stack product versions + +| Product | Version | +| ----- | ----- | +| [Elasticsearch](https://www.elastic.co/docs/release-notes/elasticsearch) | 9.0.0 and later | +| [Kibana](https://www.elastic.co/docs/release-notes/kibana) | 9.0.0 and later | +| [Fleet and Elastic Agent](https://www.elastic.co/docs/release-notes/fleet) | 9.0.0 and later | +| [Logstash](https://www.elastic.co/docs/release-notes/logstash) | 9.0.0 and later | +| [Beats](https://www.elastic.co/docs/release-notes/beats) | 9.0.0 and later | +| [Elastic Observability](https://www.elastic.co/docs/release-notes/observability) | 9.0.0 and later | +| [Elastic APM](https://www.elastic.co/docs/release-notes/apm) | 9.0.0 and later | +| [Elastic Security](https://www.elastic.co/docs/release-notes/security) | 9.0.0 and later | + +### Deployment type versions or releases + +| Product | Version or release | +| ----- | ----- | +| All [Elastic Cloud Serverless](https://www.elastic.co/docs/release-notes/cloud-serverless) project types | All releases | +| [Elastic Cloud Hosted](https://www.elastic.co/docs/release-notes/cloud-hosted) | All releases for January 2025 and later | +| [Elastic Cloud Enterprise](https://www.elastic.co/docs/release-notes/cloud-enterprise) | 4.0.0 and later | +| [Elastic Cloud on Kubernetes](https://www.elastic.co/docs/release-notes/cloud-on-k8s) | 3.0.0 and later | + +### Schema, library, and tool versions + +| Product | Version or release | +| ----- | ----- | +| [Elasticsearch Java Client](https://www.elastic.co/docs/release-notes/elasticsearch/clients/java) | 9.0.0 and later | +| [Elasticsearch JavaScript Client](https://www.elastic.co/docs/release-notes/elasticsearch/clients/javascript) | 9.0.0 and later | +| [Elasticsearch .NET Client](https://www.elastic.co/docs/release-notes/elasticsearch/clients/dotnet) | 9.0.0 and later | +| [Elasticsearch PHP Client](https://www.elastic.co/docs/release-notes/elasticsearch/clients/php) | 9.0.0 and later | +| [Elasticsearch Python Client](https://www.elastic.co/docs/release-notes/elasticsearch/clients/python) | 9.0.0 and later | +| [Elasticsearch Ruby Client](https://www.elastic.co/docs/release-notes/elasticsearch/clients/ruby) | 9.0.0 and later | +| [Elastic Common Schema (ECS)](https://www.elastic.co/docs/release-notes/ecs) | 9.0.0 and later | +| [ECS Logging .NET library](https://www.elastic.co/docs/reference/ecs/logging/dotnet) | 8.18.1 and later | +| [ECS Logging Go (Logrus) library](https://www.elastic.co/docs/reference/ecs/logging/go-logrus) | 1.0.0 and later | +| [ECS Logging Go (Zap) library](https://www.elastic.co/docs/reference/ecs/logging/go-zap) | 1.0.3 and later | +| [ECS Logging Go (Zerolog) library](https://www.elastic.co/docs/reference/ecs/logging/go-zerolog) | 0.2.0 and later | +| [ECS Logging Java library](https://www.elastic.co/docs/reference/ecs/logging/java) | 1.x and later | +| [ECS Logging Node.js library](https://www.elastic.co/docs/reference/ecs/logging/nodejs) | 1.5.3 and later | +| [ECS Logging PHP library](https://www.elastic.co/docs/reference/ecs/logging/php) | 2.0.0 and later | +| [ECS Logging Python library](https://www.elastic.co/docs/reference/ecs/logging/python) | 2.2.0 and later | +| [ECS Logging Ruby library](https://www.elastic.co/docs/reference/ecs/logging/ruby) | 1.0.0 and later | +| [Elasticsearch for Apache Hadoop](https://www.elastic.co/docs/release-notes/elasticsearch-hadoop) | 9.0.0 and later | +| [Elasticsearch Curator](https://www.elastic.co/docs/reference/elasticsearch/curator) | 8.0.0 and later | +| [Elastic Cloud Control (ECCTL)](https://www.elastic.co/docs/release-notes/ecctl) | 1.14.0 and later | +| [Elastic Serverless Forwarder for AWS](https://www.elastic.co/docs/reference/aws-forwarder) | 1.20.1 and later | +| [Elastic integrations](https://www.elastic.co/docs/reference/integrations/all_integrations) | All versions | +| [Search UI JavaScript library](https://www.elastic.co/docs/reference/search-ui) | 1.24.0 and later | + +### APM agent and tool versions + +| Product | Version | +| ----- | ----- | +| [Elastic Distribution of OpenTelemetry Android](https://www.elastic.co/docs/release-notes/edot/sdks/android) | 0.1.0 and later | +| [Elastic Distribution of OpenTelemetry iOS](https://www.elastic.co/docs/release-notes/edot/sdks/ios) | 1.0.0 and later | +| [Elastic Distribution of OpenTelemetry Java](https://www.elastic.co/docs/release-notes/edot/sdks/java) | 1.0.0 and later | +| [Elastic Distribution of OpenTelemetry .NET](https://www.elastic.co/docs/release-notes/edot/sdks/dotnet) | 1.0.0 and later | +| [Elastic Distribution of OpenTelemetry Node.js](https://www.elastic.co/docs/release-notes/edot/sdks/node) | 0.1.0 and later | +| [Elastic Distribution of OpenTelemetry Python](https://www.elastic.co/docs/release-notes/edot/sdks/python) | 0.1.0 and later | +| [Elastic Distribution of OpenTelemetry PHP](https://www.elastic.co/docs/release-notes/edot/sdks/php) | 0.1.0 and later | +| [Elastic APM .NET Agent](https://www.elastic.co/docs/release-notes/apm/agents/dotnet) | 1.0.0 and later | +| [Elastic APM Go Agent](https://www.elastic.co/docs/release-notes/apm/agents/go) | 2.0.0 and later | +| [Elastic APM Java Agent](https://www.elastic.co/docs/release-notes/apm/agents/java) | 1.0.0 and later | +| [Elastic APM Node.js Agent](https://www.elastic.co/docs/release-notes/apm/agents/nodejs) | 4.0.0 and later | +| [Elastic APM PHP Agent](https://www.elastic.co/docs/release-notes/apm/agents/php) | 1.0.0 and later | +| [Elastic APM Python Agent](https://www.elastic.co/docs/release-notes/apm/agents/python) | 6.0.0 and later | +| [Elastic APM Ruby Agent](https://www.elastic.co/docs/release-notes/apm/agents/ruby) | 4.0.0 and later | +| [Elastic APM Real User Monitoring JavaScript Agent](https://www.elastic.co/docs/release-notes/apm/agents/rum-js) | 5.0.0 and later | +| [Elastic APM AWS Lambda extension](https://www.elastic.co/docs/release-notes/apm/aws-lambda/release-notes) | 1.0.0 and later | +| [Elastic APM Attacher for Kubernetes](https://www.elastic.co/docs/reference/apm/k8s-attacher) | 1.1.3 | + +## Glossary + +To help you understand the terminology used throughout our documentation, we provide a [glossary of common Elastic terms](/reference/glossary/index.md). This is a great resource for new users or anyone looking to clarify the meaning of a specific term. + +## How to contribute + +We value contributions from our community. For detailed instructions on how to contribute to both the main documentation and the API references, refer to our [contribution guide](https://www.elastic.co/docs/extend/contribute/). \ No newline at end of file diff --git a/get-started/images/elastic-platform.png b/get-started/images/elastic-platform.png new file mode 100644 index 0000000000..85fe50148c Binary files /dev/null and b/get-started/images/elastic-platform.png differ diff --git a/get-started/index.md b/get-started/index.md index 661649afa4..602f1685b8 100644 --- a/get-started/index.md +++ b/get-started/index.md @@ -7,45 +7,55 @@ mapped_pages: products: - id: elasticsearch - id: elastic-stack + - id: observability + - id: security +applies_to: + serverless: + stack: --- -# Get started -## Overview [what-is-es] +# Elastic fundamentals -[{{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. +Welcome to Elastic fundamentals! -{{es}} is the heart of the [Elastic Stack](the-stack.md). Combined with {{kib}}, it powers these Elastic solutions and use cases: +In this section, we'll walk you through the basics of what our products offer, what they do, how they can help your business, and how to set them up. You'll get a quick look at the core features and concepts, real-world use cases, and deployment options to understand how everything fits together. -* **[Elasticsearch](/solutions/search.md)**: Build powerful search and RAG applications using Elasticsearch's vector database, AI toolkit, and advanced retrieval capabilities. -* **[Observability](/solutions/observability.md)**: Resolve problems with open, flexible, and unified observability powered by advanced machine learning and analytics. -* **[Security](/solutions/security.md)**: Detect, investigate, and respond to threats with AI-driven security analytics to protect your organization at scale. +You'll also find other helpful information, such as how to use our docs, training resources, and a link to our glossary so you can familiarize yourself with our terminology. Whether you're exercising your options and are curious about what Elastic can offer, are just getting started, or are looking to dive deeper, this is a great place to begin. -:::{tip} -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. +## What is Elastic? [what-is-es] + +:::{image} /get-started/images/elastic-platform.png +:alt: The Elastic platform ::: -## Choose your deployment type +Elastic provides an open source search, analytics, and AI platform, and out-of-the-box solutions for observability and security. The Search AI platform combines the power of search and generative AI to provide near real-time search and analysis with relevance to reduce your time to value. -:::{include} /deploy-manage/_snippets/deployment-options-overview.md -::: +Elastic offers the following solutions or types of projects: + +* [{{es}}](/solutions/search.md): Build powerful search and RAG applications using Elasticsearch's vector database, AI toolkit, and advanced retrieval capabilities. +* [Elastic {{observability}}](/solutions/observability.md): Gain comprehensive visibility into applications, infrastructure, and user experience through logs, metrics, traces, and other telemetry data, all in a single interface. +* [{{elastic-sec}}](/solutions/security.md): Combine SIEM, endpoint security, and cloud security to provide comprehensive tools for threat detection and prevention, investigation, and response. + +## Explore the fundamentals -## Explore the solutions +Continue your journey with these essential guides that will help you understand and work with Elastic: -Elasticsearch supports diverse use cases. Select a solution and follow its dedicated getting-started guide: +* **[The {{stack}}](/get-started/the-stack.md)**: Dive deeper into how the {{stack}}—our suite of open-source tools, including {{es}}, {{kib}}, {{beats}}, and {{ls}}—components work together. Learn about data ingestion methods and understand the core concepts of storing, visualizing, and querying your data. -| | | -| :---: | --- | -| ![elasticsearch](images/64x64_Color_elasticsearch-logo-color-64px.png "elasticsearch =50%") | **Elasticsearch**
Create seamless search experiences for apps, websites, or workplaces.

[**Get started →**](../solutions/search/get-started.md)
| -| ![observability](images/64x64_Color_observability-logo-color-64px.png "observability =50%") | **Observability**
Monitor logs, metrics, and traces to gain insight into your systems.

[**Get started →**](../solutions/observability/get-started.md)
| -| ![security](images/64x64_Color_security-logo-color-64px.png "security =50%") | **Security**
Monitor logs, metrics, and traces to gain insight into your systems.

[**Get started →**](../solutions/security/get-started.md)
| +* **[Deployment options](/get-started/deployment-options.md)**: Explore the different ways you can deploy Elastic, from fully managed serverless solutions to self-managed installations, and choose the approach that best fits your operational needs. -## Next steps +* **[Versioning and availability](/get-started/versioning-availability.md)**: Learn how Elastic handles versioning, understand feature availability across different deployment types, and navigate our continuously updated documentation with confidence. -To learn more about our products and solutions, check out: +## Training resources -- [{{es}} and {{kib}}](introduction.md), the core components of the {{stack}}. - - [The stack](/get-started/the-stack.md) to understand the relationship between core and optional components of an Elastic deployment. -- [The out-of-the-box solutions and use cases](/solutions/index.md) that Elastic supports. -- [Deploying Elastic](./deployment-options.md) for your use case. -- [Versioning and availability](./versioning-availability.md) in Elastic deployments. +Whether you are just getting started with Elastic, an expert, or simply want to expand your knowledge, we provide role-based and solution-based training to empower you to get the most out of our solutions. You can even receive accreditation for completing our courses. +Ready to dive in? Check out [https://www.elastic.co/training](https://www.elastic.co/training) to browse our virtual and on-demand training courses. If you're unsure where to start, check out the [Elasticsearch Engineer](https://www.elastic.co/training/elasticsearch-engineer) course. + +To explore particular, more granular facets of the {{stack}}, check out our [demo gallery](https://www.elastic.co/demo-gallery). You can filter by solution or subject area and choose the training style that best suits you. + +If you prefer a deep dive where you can learn at your own pace, check out our six-part [Beginner's Crash Course to {{stack}}](https://www.youtube.com/playlist?list=PL_mJOmq4zsHZYAyK606y7wjQtC0aoE6Es) on YouTube. + +:::{tip} +Read **[How to use the documentation](/get-started/howto-use-the-docs.md)** to discover how our documentation is organized, find the right version information for your products, and understand how to contribute to our community. +::: \ No newline at end of file diff --git a/get-started/the-stack.md b/get-started/the-stack.md index 842dfc7402..77b9ae93d1 100644 --- a/get-started/the-stack.md +++ b/get-started/the-stack.md @@ -8,6 +8,8 @@ mapped_pages: products: - id: elastic-stack - id: kibana +applies_to: + stack: --- # The {{stack}} diff --git a/get-started/toc.yml b/get-started/toc.yml index b5cae382dd..41f4472933 100644 --- a/get-started/toc.yml +++ b/get-started/toc.yml @@ -4,4 +4,7 @@ toc: - file: introduction.md - file: the-stack.md - file: deployment-options.md - - file: versioning-availability.md \ No newline at end of file + - file: versioning-availability.md + - file: howto-use-the-docs.md + - title: Glossary + crosslink: docs-content://reference/glossary/index.md \ No newline at end of file diff --git a/versions.md b/versions.md index ee307f5991..0c47e1900d 100644 --- a/versions.md +++ b/versions.md @@ -2,7 +2,7 @@ In April 2025, we released our new documentation site. This site includes documentation for our latest product versions, including {{stack}} 9.0+ and {{serverless-full}}. -To review the product versions covered on elastic.co/docs, refer to [Find docs for your product version](/get-started/versioning-availability.md#find-docs-for-your-product-version). +To review the product versions covered on elastic.co/docs, refer to [Find docs for your product version](/get-started/howto-use-the-docs.md#find-docs-for-your-product-version). To access our previous documentation system, which contains the documentation for older releases including {{stack}} 8.x, use the following links.