Skip to content

Rebuild onboarding docs (Get Started) for obs #1929

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 31 commits into from
Jul 1, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
31 commits
Select commit Hold shift + click to select a range
45317a0
Initial move
theletterf Jun 26, 2025
37be6ce
Add Synthetic
theletterf Jun 26, 2025
eb2cbab
Add Synthetic guide
theletterf Jun 26, 2025
30a4556
Add descriptions
theletterf Jun 26, 2025
d3d4faa
Headings
theletterf Jun 26, 2025
7524410
Add K8s tutorial
theletterf Jun 27, 2025
b15e742
Add APM quickstart
theletterf Jun 27, 2025
ce4ed93
Add get started
theletterf Jun 27, 2025
d626c47
Merge branch 'main' into new-onboarding-path-obs
theletterf Jun 27, 2025
5415c9e
Fix links
theletterf Jun 27, 2025
2243ce7
Fix more links
theletterf Jun 27, 2025
fe66ae0
Rename image
theletterf Jun 27, 2025
9739c31
Workaround for stepper
theletterf Jun 27, 2025
a4c2c4d
Add workaround to Synth
theletterf Jun 27, 2025
2badc6d
Restore steps
theletterf Jun 30, 2025
fd187d1
Update solutions/observability/get-started.md
theletterf Jul 1, 2025
40de55a
Update solutions/observability/get-started.md
theletterf Jul 1, 2025
40a0558
Edits
theletterf Jul 1, 2025
4f71de0
Merge branch 'new-onboarding-path-obs' of https://github.com/elastic/…
theletterf Jul 1, 2025
899981b
Replace images
theletterf Jul 1, 2025
16c3346
Merge branch 'main' into new-onboarding-path-obs
theletterf Jul 1, 2025
a45f813
Reorg collection step
theletterf Jul 1, 2025
ca4ecc2
Intro
theletterf Jul 1, 2025
6ad2b58
Fix link
theletterf Jul 1, 2025
05b6868
Reorder
theletterf Jul 1, 2025
23cf010
Imagees
theletterf Jul 1, 2025
f629263
Redo index and add dropdowns
theletterf Jul 1, 2025
8cb3c29
Fix link
theletterf Jul 1, 2025
7958d23
Add What is
theletterf Jul 1, 2025
50f8701
Clarify EDOT and Agent roles
theletterf Jul 1, 2025
36e403c
Merge branch 'main' into new-onboarding-path-obs
theletterf Jul 1, 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
Original file line number Diff line number Diff line change
Expand Up @@ -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> |
| | |
2 changes: 1 addition & 1 deletion deploy-manage/deploy/elastic-cloud/serverless.md
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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)


Expand Down
6 changes: 4 additions & 2 deletions redirects.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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'

Expand All @@ -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'
8 changes: 8 additions & 0 deletions reference/observability/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,7 @@ products:
- id: cloud-serverless
- id: observability
---

# Observability

This section contains reference information for Elastic Observability features, including:
Expand All @@ -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)
Binary file added solutions/images/Monitor_drill_down_1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added solutions/images/Monitor_drill_down_2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added solutions/images/Synthetic-Error_details.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
21 changes: 0 additions & 21 deletions solutions/images/observability-get-started.svg

This file was deleted.

Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added solutions/images/synth-monitors.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
45 changes: 21 additions & 24 deletions solutions/observability.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
2 changes: 1 addition & 1 deletion solutions/observability/apm/get-started-serverless.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
1 change: 0 additions & 1 deletion solutions/observability/applications/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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. |
Loading
Loading