Fix Observability APM formatting issues (#585)

Author: mdbirnstiehl

images/observability-apm-help-me-decide.svg

@@ -1,6 +1,8 @@
 ---
 mapped_pages:
   - https://www.elastic.co/guide/en/observability/current/analyze-monitors.html
+applies_to:
+  stack: all
 ---
 
 # Analyze monitors [analyze-monitors]

solutions/observability/apps/analyze-monitors.md

@@ -2,6 +2,8 @@
 navigation_title: "Analyze"
 mapped_pages:
   - https://www.elastic.co/guide/en/observability/current/uptime-analyze.html
+applies_to:
+  stack: all
 ---
 
 

solutions/observability/apps/analyze.md

@@ -1,11 +1,13 @@
 ---
 mapped_pages:
   - https://www.elastic.co/guide/en/observability/current/apm-agent-auth.html
+applies_to:
+  stack: all
 ---
 
 # APM agent authorization [apm-agent-auth]
 
-::::{admonition}
+::::{note}
 ![supported deployment methods](../../../images/observability-binary-yes-fm-yes.svg "")
 
 Most options in this section are supported by all APM Server deployment methods.
@@ -92,7 +94,7 @@ Authorization token for sending APM data. The same token must also be set in eac
 
 ## `auth.api_key.elasticsearch.*` configuration options [_auth_api_key_elasticsearch_configuration_options]
 
-::::{admonition}
+::::{note}
 ![supported deployment methods](../../../images/observability-binary-yes-fm-no.svg "")
 
 The below options are only supported by the APM Server binary.

solutions/observability/apps/apm-agent-authorization.md

@@ -2,19 +2,14 @@
 navigation_title: "Centrally configure APM agents in Kibana"
 mapped_pages:
   - https://www.elastic.co/guide/en/observability/current/apm-agent-configuration.html
+applies_to:
+  stack: all
 ---
 
 
 
 # APM agent central configuration [apm-agent-configuration]
 
-
-::::{note}
-APM agent central configuration is *not* compatible with [{{serverless-full}}](https://docs.elastic.co/serverless).
-
-::::
-
-
 APM Agent configuration allows you to fine-tune your APM agent configuration from within the Applications UI. Changes are automatically propagated to your APM agents, so there’s no need to redeploy.
 
 To get started, choose the services and environments you wish to configure. The Applications UI will let you know when your APM agents have applied your configurations.

solutions/observability/apps/apm-agent-central-configuration.md

@@ -1,15 +1,14 @@
 ---
-navigation_title: "Identify deployment details for APM agents"
 mapped_pages:
   - https://www.elastic.co/guide/en/observability/current/apm-agent-explorer.html
+applies_to:
+  stack: all
 ---
 
-
-
 # APM Agent explorer [apm-agent-explorer]
 
 
-::::{warning}
+::::{important}
 This functionality is in beta and is subject to change. The design and code is less mature than official GA features and is being provided as-is with no warranties. Beta features are not subject to the support SLA of official GA features.
 ::::
 

solutions/observability/apps/apm-agent-explorer.md

@@ -2,6 +2,8 @@
 navigation_title: "Kubernetes"
 mapped_pages:
   - https://www.elastic.co/guide/en/observability/current/apm-k8s-attacher.html
+applies_to:
+  stack: all
 ---
 
 

solutions/observability/apps/apm-k8s-attacher.md

@@ -12,32 +12,18 @@ mapped_pages:
 APM reader users typically need to view the Applications UI and dashboards and visualizations that use APM data. These users might also need to create and edit dashboards, visualizations, and machine learning jobs.
 
 
-## APM reader [apm-app-reader-full] 
+## APM reader [apm-app-reader-full]
 
 To create an APM reader user:
 
 1. Create a new role, named something like `read-apm`, and assign the following privileges:
 
-    <div class="tabs" data-tab-group="apm-app-reader">
-      <div role="tablist" aria-label="Applications UI reader">
-        <button role="tab"
-              aria-selected="true"
-              aria-controls="data-streams-tab"
-              id="data-streams">
-          Data streams
-        </button>
-        <button role="tab"
-                aria-selected="false"
-                aria-controls="classic-indices-tab"
-                id="classic-indices"
-                tabindex="-1">
-          Classic APM indices
-        </button>
-      </div>
-      <div tabindex="0"
-           role="tabpanel"
-           id="data-streams-tab"
-           aria-labelledby="data-streams">
+    ::::{tab-set}
+    :group: datastreams-classic
+
+    :::{tab-item} Data streams
+    :sync: datastreams
+
     | Type | Privilege | Purpose |
     | --- | --- | --- |
     | Index | `read` on `logs-apm*` | Read-only access to `logs-apm*` data |
@@ -47,19 +33,19 @@ To create an APM reader user:
     | Index | `read` on `traces-apm*` | Read-only access to `traces-apm*` data |
     | Index | `view_index_metadata` on `traces-apm*` | Read-only access to `traces-apm*` index metadata |
 
-      </div>
-      <div tabindex="0"
-           role="tabpanel"
-           id="classic-indices-tab"
-           aria-labelledby="classic-indices"
-           hidden="">
+    :::
+
+    :::{tab-item} Classic APM indices
+    :sync: classic
+
     | Type | Privilege | Purpose |
     | --- | --- | --- |
     | Index | `read` on `apm-*` | Read-only access to `apm-*` data |
     | Index | `view_index_metadata` on `apm-*` | Read-only access to `apm-*` index metadata |
 
-      </div>
-    </div>
+    :::
+
+    ::::
 
 2. Assign the `read-apm` role created in the previous step, and the following built-in roles to any APM reader users:
 
@@ -70,32 +56,18 @@ To create an APM reader user:
 
 
 
-## Partial APM reader [apm-app-reader-partial] 
+## Partial APM reader [apm-app-reader-partial]
 
 In some instances, you may wish to restrict certain Kibana apps that a user has access to.
 
 1. Create a new role, named something like `read-apm-partial`, and assign the following privileges:
 
-    <div class="tabs" data-tab-group="apm-app-reader">
-      <div role="tablist" aria-label="Applications UI reader">
-        <button role="tab"
-              aria-selected="true"
-              aria-controls="data-streams-tab"
-              id="data-streams">
-          Data streams
-        </button>
-        <button role="tab"
-                aria-selected="false"
-                aria-controls="classic-indices-tab"
-                id="classic-indices"
-                tabindex="-1">
-          Classic APM indices
-        </button>
-      </div>
-      <div tabindex="0"
-           role="tabpanel"
-           id="data-streams-tab"
-           aria-labelledby="data-streams">
+    ::::{tab-set}
+    :group: datastreams-classic
+
+    :::{tab-item} Data streams
+    :sync: datastreams
+
     | Type | Privilege | Purpose |
     | --- | --- | --- |
     | Index | `read` on `logs-apm*` | Read-only access to `logs-apm*` data |
@@ -105,19 +77,20 @@ In some instances, you may wish to restrict certain Kibana apps that a user has
     | Index | `read` on `traces-apm*` | Read-only access to `traces-apm*` data |
     | Index | `view_index_metadata` on `traces-apm*` | Read-only access to `traces-apm*` index metadata |
 
-      </div>
-      <div tabindex="0"
-           role="tabpanel"
-           id="classic-indices-tab"
-           aria-labelledby="classic-indices"
-           hidden="">
+    :::
+
+    :::{tab-item} Classic APM indices
+    :sync: classic
+
     | Type | Privilege | Purpose |
     | --- | --- | --- |
     | Index | `read` on `apm-*` | Read-only access to `apm-*` data |
     | Index | `view_index_metadata` on `apm-*` | Read-only access to `apm-*` index metadata |
 
-      </div>
-    </div>
+    :::
+
+    ::::
+
 
 2. Assign feature privileges to any Kibana feature that the user needs access to. Here are two examples:
 

solutions/observability/apps/apm-reader-user.md

@@ -2,6 +2,8 @@
 navigation_title: "Advanced setup"
 mapped_pages:
   - https://www.elastic.co/guide/en/observability/current/apm-setting-up-and-running.html
+applies_to:
+  stack: all
 ---
 
 

solutions/observability/apps/apm-server-advanced-setup.md

@@ -1,6 +1,8 @@
 ---
 mapped_pages:
   - https://www.elastic.co/guide/en/observability/current/get-started-with-apm-server-binary.html
+applies_to:
+  stack: all
 ---
 
 # APM Server binary [get-started-with-apm-server-binary]
@@ -36,27 +38,49 @@ To download and install APM Server, use the commands below that work with your s
 $$$apm-deb$$$
 **deb:**
 
-Version 9.0.0 of APM Server has not yet been released.
+```shell
+curl -L -O https://artifacts.elastic.co/downloads/apm-server/apm-server-{{apm_server_version}}-amd64.deb
+sudo dpkg -i apm-server-{{apm_server_version}}-amd64.deb
+```
 
 $$$apm-rpm$$$
 **RPM:**
 
-Version 9.0.0 of APM Server has not yet been released.
+```shell
+curl -L -O https://artifacts.elastic.co/downloads/apm-server/apm-server-{{apm_server_version}}-x86_64.rpm
+sudo rpm -vi apm-server-{{apm_server_version}}-x86_64.rpm
+```
 
 $$$apm-linux$$$
 **Other Linux:**
 
-Version 9.0.0 of APM Server has not yet been released.
+```shell
+curl -L -O https://artifacts.elastic.co/downloads/apm-server/apm-server-{{apm_server_version}}-linux-x86_64.tar.gz
+tar xzvf apm-server-{{apm_server_version}}-linux-x86_64.tar.gz
+```
 
 $$$apm-mac$$$
 **Mac:**
 
-Version 9.0.0 of APM Server has not yet been released.
+```shell
+curl -L -O https://artifacts.elastic.co/downloads/apm-server/apm-server-{{apm_server_version}}-darwin-x86_64.tar.gz
+tar xzvf apm-server-{{apm_server_version}}-darwin-x86_64.tar.gz
+```
 
 $$$apm-installing-on-windows$$$
 **Windows:**
 
-Version 9.0.0 of APM Server has not yet been released.
+1. Download the APM Server Windows zip file from the
+https://www.elastic.co/downloads/apm/apm-server[downloads page].
+
+1. Extract the contents of the zip file into `C:\Program Files`.
+
+1. Rename the `apm-server-<version>-windows` directory to `APM-Server`.
+
+1. Open a PowerShell prompt as an Administrator (right-click the PowerShell icon and select *Run As Administrator*).
+If you are running Windows XP, you may need to download and install PowerShell.
+
+1. From the PowerShell prompt, run the following commands to install APM Server as a Windows service:
 
 $$$apm-docker$$$
 **Docker:**