Rebuild onboarding docs (Get Started) for obs (#1929)

This PR:

- Rebuilds the Get started structure for Obs around the [main onboarding
flow](https://www.elastic.co/getting-started/) as a supertask.
- Migrates most of the Obs content from
https://www.elastic.co/getting-started/
- Moves out some guides that don't belong to Get started (Add Splunk
data, Java tutorial, and so on).
- Adds relevant metadata to existing Quickstarts and give them a
secondary role.

Each step of the supertask should link to relevant day-2 docs within
Observability or to EDOT reference docs.

Pending: Moving EDOT narrative docs to Solutions.

---------

Co-authored-by: Mike Birnstiehl <[email protected]>

Author: theletterf

deploy-manage/deploy/elastic-cloud/create-serverless-project.md

@@ -20,6 +20,6 @@ Choose the type of project that matches your needs and we’ll help you get star
 | --- | --- |
 |  |  |
 | ![elasticsearch](../../images/64x64_Color_elasticsearch-logo-color-64px.png "elasticsearch =50%") | **Elasticsearch**<br> Build custom search applications with {{es}}.<br><br>[**View guide →**](/solutions/search/serverless-elasticsearch-get-started.md)<br> |
-| ![observability](../../images/64x64_Color_observability-logo-color-64px.png "observability =50%") | **Observability**<br> Monitor applications and systems with Elastic Observability.<br><br>[**View guide →**](/solutions/observability/get-started/create-an-observability-project.md)<br> |
+| ![observability](../../images/64x64_Color_observability-logo-color-64px.png "observability =50%") | **Observability**<br> Monitor applications and systems with Elastic Observability.<br><br>[**View guide →**](/solutions/observability/get-started.md)<br> |
 | ![security](../../images/64x64_Color_security-logo-color-64px.png "security =50%") | **Security**<br> Detect, investigate, and respond to threats with Elastic Security.<br><br>[**View guide →**](/solutions/security/get-started/create-security-project.md)<br> |
 |  |  |

deploy-manage/deploy/elastic-cloud/serverless.md

@@ -28,7 +28,7 @@ There are differences between {{es-serverless}} and {{ech}}, for a list of diffe
 Elastic provides three serverless solutions available on {{ecloud}}. Follow these guides to get started with your serverless project:
 
 * **[{{es-serverless}}](../../../solutions/search/serverless-elasticsearch-get-started.md)**: Build powerful applications and search experiences using a rich ecosystem of vector search capabilities, APIs, and libraries.
-* **[{{obs-serverless}}](../../../solutions/observability/get-started/create-an-observability-project.md)**: Monitor your own platforms and services using powerful machine learning and analytics tools with your logs, metrics, traces, and APM data.
+* **[{{obs-serverless}}](../../../solutions/observability/get-started.md)**: Monitor your own platforms and services using powerful machine learning and analytics tools with your logs, metrics, traces, and APM data.
 * **[{{sec-serverless}}](../../../solutions/security/get-started/create-security-project.md)**: Detect, investigate, and respond to threats with SIEM, endpoint protection, and AI-powered analytics capabilities.
 
 Afterwards, you can:

manage-data/ingest/ingest-reference-architectures/agent-to-es.md

@@ -35,7 +35,7 @@ Info on {{es}}:
 
 This basic architecture is a common approach for ingesting data for the [Elastic Observability](https://www.elastic.co/observability) and [Elastic Security](https://www.elastic.co/security) solutions:
 
-* [Elastic Observability tutorials](/solutions/observability/get-started.md#_get_started_with_other_features)
+* [Elastic Observability tutorials](/solutions/observability/get-started.md)
 * [Ingest data to Elastic Security](../../../solutions/security/get-started/ingest-data-to-elastic-security.md)
 
 

redirects.yml

@@ -187,7 +187,7 @@ redirects:
   'solutions/observability/apps/analyze-monitors.md': 'solutions/observability/uptime/analyze-monitors.md'
   'solutions/observability/apps/inspect-uptime-duration-anomalies.md': 'solutions/observability/uptime/inspect-duration-anomalies.md'
   'solutions/observability/apps/configure-settings.md': 'solutions/observability/uptime/configure-settings.md'
-  'solutions/observability/apps/tutorial-monitor-java-application.md': 'solutions/observability/applications/tutorial-monitor-java-application.md'
+  'solutions/observability/apps/tutorial-monitor-java-application.md': 'solutions/observability/get-started/other-tutorials/tutorial-monitor-java-application.md'
   # we can't redirect to the search-ui book so this is the next best option
   'reference/search/index.md': 'reference/index.md'
 
@@ -207,6 +207,8 @@ redirects:
   'troubleshoot/elasticsearch/elasticsearch-client-net-api/logging.md': 'troubleshoot/elasticsearch/clients.md'
   'troubleshoot/elasticsearch/elasticsearch-client-net-api/net.md': 'troubleshoot/elasticsearch/clients.md'
   'troubleshoot/elasticsearch/elasticsearch-client-ruby-api/ruby.md': 'troubleshoot/elasticsearch/clients.md'
-
+  'solutions/observability/get-started/add-data-from-splunk.md': 'solutions/observability/get-started/other-tutorials/add-data-from-splunk.md'
+  'solutions/observability/get-started/create-an-observability-project.md': 'solutions/observability/get-started.md'
+  'solutions/observability/get-started/get-started-with-dashboards.md': 'solutions/observability/get-started.md'
 # Related to https://github.com/elastic/docs-content/pull/1329
   'manage-data/ingest/transform-enrich/ingest-pipelines-serverless.md': 'manage-data/ingest/transform-enrich/ingest-pipelines.md'

reference/observability/index.md

@@ -9,6 +9,7 @@ products:
   - id: cloud-serverless
   - id: observability
 ---
+
 # Observability
 
 This section contains reference information for Elastic Observability features, including:
@@ -20,3 +21,10 @@ To interface with Elastic Observability features, you can use the following APIs
 
 * [Observability Intake Serverless APIs](https://www.elastic.co/docs/api/doc/observability-serverless)
 * [Service level objectives](https://www.elastic.co/docs/api/doc/kibana/group/endpoint-slo)
+
+You can also browse reference documentation for the following components:
+
+- [Elastic Distributions of OpenTelemetry (EDOT)](opentelemetry://reference/index.md)
+- [Fleet and Elastic Agent](/reference/fleet/index.md)
+- [Elastic APM](/reference/apm/observability/apm.md)
+- [Elastic APM agents](/reference/apm-agents/index.md)

solutions/images/Monitor_drill_down_1.png

@@ -15,39 +15,36 @@ products:
 
 # Observability
 
-{{observability}} accelerates problem resolution with open, flexible, and unified observability powered by advanced machine learning and analytics. Elastic ingests all operational and business telemetry and correlates for faster root cause detection.
+Elastic {{observability}} accelerates problem resolution with open, flexible, and unified observability powered by advanced machine learning and analytics. Elastic ingests all operational and business telemetry and correlates for faster root cause detection.
 
-## Get started [_get_started]
+For a complete overview, refer to [**What is Elastic {{observability}}**](/solutions/observability/get-started/what-is-elastic-observability.md).
 
-Read the following quickstart guides to get started with {{observability}}:
+## Get started [_get_started]
 
-* [**Get started**](/solutions/observability/get-started.md): Discover more about our observability features and how to get started.
+To start your {{observability}} journey, read the [**Get started**](/solutions/observability/get-started.md) guide, which presents all the essential steps, with links to valuable resources. You can also browse the {{observability}} [**Quickstart guides**](/solutions/observability/get-started/quickstarts.md).
 
-Ingest observability data using OpenTelemetry:
+## {{observability}} features [_observability_features]
 
-* [**Quickstart: Monitor hosts with OpenTelemetry**](/solutions/observability/get-started/quickstart-monitor-hosts-with-opentelemetry.md)
-* [**Quickstart: Monitor Kubernetes with OpenTelemetry**](/solutions/observability/get-started/quickstart-unified-kubernetes-observability-with-elastic-distributions-of-opentelemetry-edot.md)
-* [**Quickstart: Send data to the Elastic Cloud Managed OTLP Endpoint**](/solutions/observability/get-started/quickstart-elastic-cloud-otel-endpoint.md)
+Read the documentation for each of the {{observability}} features to learn more about how to use them.
 
-Use the Elastic Agent to ingest data:
+- [Log monitoring](/solutions/observability/logs.md)
+- [Infrastructure and hosts monitoring](/solutions/observability/infra-and-hosts.md)
+- [Applications performance monitoring](/solutions/observability/apm/index.md)
+- [Synthetics monitoring](/solutions/observability/synthetics/index.md)
+- [Incident management](/solutions/observability/incident-management.md)
+- [AI Assistant](/solutions/observability/observability-ai-assistant.md)
 
-* [**Quickstart: Monitor hosts with Elastic Agent**](/solutions/observability/get-started/quickstart-monitor-hosts-with-elastic-agent.md): Scan your host to detect and collect logs and metrics.
-* [**Quickstart: Monitor your Kubernetes cluster with Elastic Agent**](/solutions/observability/get-started/quickstart-monitor-kubernetes-cluster-with-elastic-agent.md): Create the Kubernetes resources that are required to monitor your cluster infrastructure.
+## Reference documentation [_reference_documentation]
 
-Explore your data:
+The {{observability}} reference documentation is available in the [Elastic reference documentation](/reference/observability/index.md). 
 
-* [**Get started with Logs**](/solutions/observability/logs/get-started-with-system-logs.md): Add your log data to {{observability}} and start exploring your logs.
-* [**Get started with traces and APM**](/solutions/observability/apm/get-started.md): Collect Application Performance Monitoring (APM) data and visualize it in real time.
-* [**Get started with metrics**](/solutions/observability/infra-and-hosts/get-started-with-system-metrics.md): Add your metrics data to {{observability}} and visualize it in real time.
+You can also browse reference documentation for the following components:
 
-## How to [_how_to]
+- [Elastic Distributions of OpenTelemetry (EDOT)](opentelemetry://reference/index.md)
+- [Fleet and Elastic Agent](/reference/fleet/index.md)
+- [Elastic APM](/reference/apm/observability/apm.md)
+- [Elastic APM agents](/reference/apm-agents/index.md)
 
-After you've collected your data, you can:
+## Release notes [_release_notes]
 
-* [**Explore log data**](/solutions/observability/logs/discover-logs.md): Use Discover to explore your log data.
-* [**Trigger alerts and triage problems**](/solutions/observability/incident-management/create-manage-rules.md): Create rules to detect complex conditions and trigger alerts.
-* [**Track and deliver on your SLOs**](/solutions/observability/incident-management/service-level-objectives-slos.md): Measure key metrics important to the business.
-* [**Detect anomalies and spikes**](/explore-analyze/machine-learning/anomaly-detection.md): Find unusual behavior in time series data.
-* [**Monitor application performance**](/solutions/observability/apm/index.md): Monitor your software services and applications in real time.
-* [**Integrate with OpenTelemetry**](/solutions/observability/apm/use-opentelemetry-with-apm.md): Reuse existing APM instrumentation to capture logs, traces, and metrics.
-* [**Monitor your hosts and services**](/solutions/observability/infra-and-hosts/analyze-compare-hosts.md): Get a metrics-driven view of your hosts backed by an interface called Lens.
+Browse the latest [{{observability}} release notes](/release-notes/elastic-observability/index.md) for more information on new features, enhancements, and fixes.

solutions/images/Monitor_drill_down_2.png

@@ -24,7 +24,7 @@ You’ll use APM agents to send APM data from your application to Elastic. Elast
 
 To send APM data to Elastic, you must install an APM agent and configure it to send data to your project:
 
-1. [Create a new {{obs-serverless}} project](/solutions/observability/get-started/create-an-observability-project.md), or open an existing one.
+1. [Create a new {{obs-serverless}} project](/solutions/observability/get-started.md), or open an existing one.
 2. To install and configure one or more APM agents, do one of following:
 
     * In your Observability project, go to **Add data** → **Application** → **Elastic APM** and follow the prompts.

solutions/images/Synthetic-Error_details.png

@@ -25,4 +25,3 @@ Explore the topics in this section to learn how to observe and monitor software
 | [Synthetic monitoring](/solutions/observability/synthetics/index.md) | Monitor the availability of network endpoints and services. |
 | [Real user monitoring](/solutions/observability/applications/user-experience.md) | Quantify and analyze the perceived performance of your web application using real-world user experiences. |
 | [Uptime monitoring (deprecated)](/solutions/observability/uptime/index.md) | Periodically check the status of your services and applications. |
-| [Tutorial: Monitor a Java application](/solutions/observability/applications/tutorial-monitor-java-application.md) | Monitor a Java application using Elastic Observability: Logs, Infrastructure metrics, APM, and Uptime. |