Rewrite APM get started docs (elastic#2310)

Fixes elastic#2309

Author: theletterf

redirects.yml

@@ -13,9 +13,9 @@ redirects:
   'solutions/observability/apps.md': 'solutions/observability/applications/index.md'
   'solutions/observability/apps/application-performance-monitoring-apm.md': 'solutions/observability/apm/index.md'
   'solutions/observability/apps/get-started-with-apm.md': 'solutions/observability/apm/get-started.md'
-  'solutions/observability/apps/get-started-apm-serverless.md': 'solutions/observability/apm/get-started-serverless.md'
-  'solutions/observability/apps/fleet-managed-apm-server.md': 'solutions/observability/apm/get-started-fleet-managed-apm-server.md'
-  'solutions/observability/apps/apm-server-binary.md': 'solutions/observability/apm/get-started-apm-server-binary.md'
+  'solutions/observability/apps/get-started-apm-serverless.md': 'solutions/observability/apm/get-started.md'
+  'solutions/observability/apps/fleet-managed-apm-server.md': 'reference/fleet/get-started-managed-apm-server.md'
+  'solutions/observability/apps/apm-server-binary.md': 'reference/fleet/get-started-apm-server-binary.md'
   'solutions/observability/apps/learn-about-application-data-types.md': 'solutions/observability/apm/data-types.md'
   'solutions/observability/apps/spans.md': 'solutions/observability/apm/spans.md'
   'solutions/observability/apps/transactions.md': 'solutions/observability/apm/transactions.md'
@@ -294,4 +294,9 @@ redirects:
   'solutions/search/retrievers-examples.md': 'elasticsearch://reference/elasticsearch/rest-apis/retrievers/retrievers-examples.md'
 
 # Related to https://github.com/elastic/docs-content/pull/2136
-  'deploy-manage/security/fips-140-2.md': 'deploy-manage/security/fips.md'
+  'deploy-manage/security/fips-140-2.md': 'deploy-manage/security/fips.md'
+
+# Related to
+  'solutions/observability/apm/get-started-serverless.md': 'solutions/observability/apm/get-started.md'
+  'solutions/observability/apm/get-started-fleet-managed-apm-server.md': 'reference/fleet/get-started-managed-apm-server.md'
+  'solutions/observability/apm/get-started-apm-server-binary.md': 'reference/fleet/get-started-apm-server-binary.md'

reference/apm/observability/apm.md

@@ -21,7 +21,7 @@ Metrics are another vital source of information when debugging production system
 
 ## Give Elastic APM a try [_give_elastic_apm_a_try]
 
-Use [Get started with application traces and APM](/solutions/observability/apm/get-started-fleet-managed-apm-server.md) to quickly spin up an APM deployment. Want to host everything yourself instead? See [Get started](/solutions/observability/apm/get-started.md).
+Use [Fleet-managed APM Server](/reference/fleet/get-started-managed-apm-server.md) to quickly spin up an APM deployment. Want to host everything yourself instead? See [Get started for APM](/solutions/observability/apm/get-started.md).
 
 
 

solutions/observability/apm/get-started-apm-server-binary.md renamed to reference/fleet/get-started-apm-server-binary.md

@@ -23,7 +23,7 @@ You’ll need:
 
 We recommend you use the same version of {{es}}, {{kib}}, and APM Server. See [Installing the {{stack}}](/get-started/the-stack.md) for more information about installing these products.
 
-:::{image} /solutions/images/observability-apm-architecture-diy.png
+:::{image} /reference/fleet/images/observability-apm-architecture-diy.png
 :alt: Install Elastic APM yourself
 :::
 
@@ -746,7 +746,7 @@ For more information on how to combine Elastic and OpenTelemetry, see [OpenTelem
 
 Once you have at least one {{apm-agent}} sending data to APM Server, you can start visualizing your data in the [{{kib}} Applications UI](/solutions/observability/apm/overviews.md).
 
-:::{image} /solutions/images/observability-kibana-apm-sample-data.png
+:::{image} /reference/fleet/images/observability-kibana-apm-sample-data.png
 :alt: Applications UI with data
 :screenshot:
 :::

solutions/observability/apm/get-started-fleet-managed-apm-server.md renamed to reference/fleet/get-started-managed-apm-server.md

@@ -10,6 +10,11 @@ products:
 
 # Fleet-managed APM Server [get-started-with-fleet-apm-server]
 
+Fleet is a web-based UI in {{kib}} that is used to centrally manage {{agent}}s. In this deployment model, use {{agent}} to spin up APM Server instances that can be centrally-managed in a custom-curated user interface.
+
+:::{image} /reference/fleet/images/observability-fm-ov.png
+:alt: APM Server fleet overview
+
 This guide will explain how to set up and configure a Fleet-managed APM Server.
 
 ## Prerequisites [_prerequisites_6]
@@ -71,7 +76,7 @@ You can install only a single {{agent}} per host, which means you cannot run {{f
 4. Save and apply the settings.
 5. Click the **Agents** tab and follow the in-product instructions to add a {{fleet}} server:
 
-    :::{image} /solutions/images/observability-add-fleet-server.png
+    :::{image} /reference/fleet/images/observability-add-fleet-server.png
     :alt: In-product instructions for adding a {{fleet-server}}
     :screenshot:
     :::
@@ -110,14 +115,14 @@ If you don’t have a {{fleet}} setup already in place, the easiest way to get s
 1. In {{kib}}, find **Integrations** in the main menu or use the [global search field](/explore-analyze/find-and-organize/find-apps-and-objects.md).
 2. Select **Elastic APM**.
 
-    :::{image} /solutions/images/observability-kibana-fleet-integrations-apm.png
+    :::{image} /reference/fleet/images/observability-kibana-fleet-integrations-apm.png
     :alt: {{fleet}} showing APM integration
     :screenshot:
     :::
 
 3. Click **Add Elastic APM**.
 
-    :::{image} /solutions/images/observability-kibana-fleet-integrations-apm-overview.png
+    :::{image} /reference/fleet/images/observability-kibana-fleet-integrations-apm-overview.png
     :alt: {{fleet}} showing APM integration overview
     :screenshot:
     :::
@@ -132,7 +137,7 @@ If you don’t have a {{fleet}} setup already in place, the easiest way to get s
 6. Click **Save and continue**. This step takes a minute or two to complete. When it’s done, you’ll have an agent policy that contains an APM integration policy for the configuration you just specified.
 7. To view the new policy, click **Agent policy 1**.
 
-    :::{image} /solutions/images/observability-apm-agent-policy-1.png
+    :::{image} /reference/fleet/images/observability-apm-agent-policy-1.png
     :alt: {{fleet}} showing apm policy
     :screenshot:
     :::
@@ -787,7 +792,7 @@ For more information on how to combine Elastic and OpenTelemetry, see [OpenTelem
 
 Back in {{kib}}, under {{observability}}, select APM. You should see application performance monitoring data flowing into the {{stack}}!
 
-:::{image} /solutions/images/observability-kibana-apm-sample-data.png
+:::{image} /reference/fleet/images/observability-kibana-apm-sample-data.png
 :alt: Applications UI with data
 :screenshot:
 :::