clean up formatting

mdbirnstiehl · mdbirnstiehl · commit 07547f1d4965 · 2025-02-25T10:48:36.000-06:00
diff --git a/solutions/observability/apps/apm-agent-central-configuration.md b/solutions/observability/apps/apm-agent-central-configuration.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.
diff --git a/solutions/observability/apps/apm-k8s-attacher.md b/solutions/observability/apps/apm-k8s-attacher.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
 ---
 
 
diff --git a/solutions/observability/apps/applications-ui-settings.md b/solutions/observability/apps/applications-ui-settings.md
@@ -9,8 +9,7 @@ navigation_title: "Settings"
 # Applications UI settings [observability-apm-kibana-settings]
 
 
-::::{admonition} Required role
-:class: note
+::::{note}
 
 The **Editor** role or higher is required to modify settings. To learn more, refer to [Assign user roles and privileges](../../../deploy-manage/users-roles/cloud-organization/user-roles.md#general-assign-user-roles).
 
diff --git a/solutions/observability/apps/collect-application-data.md b/solutions/observability/apps/collect-application-data.md
@@ -9,14 +9,18 @@ mapped_urls:
 
 % is required role serverless only?
 
-::::{note} Required role
+::::{note}
 
-The **Admin** role or higher is required to send APM data to Elastic. To learn more, refer to [Assign user roles and privileges](../../../deploy-manage/users-roles/cloud-organization/user-roles.md#general-assign-user-roles).
+**For Observability serverless projects**, the **Admin** role or higher is required to send APM data to Elastic. To learn more, refer to [Assign user roles and privileges](../../../deploy-manage/users-roles/cloud-organization/user-roles.md#general-assign-user-roles).
 
 ::::
 
+::::{note}
+
 ![documentation icon](../../../images/serverless-documentation.svg "") Want to get started quickly? See [Get started with traces and APM](../../../solutions/observability/apps/get-started-with-apm.md).
 
+::::
+
 ## Language-specific options [_language_specific_options]
 
 Use Elastic APM agents or an OpenTelemetry language SDK to instrument a service in the language its written in:
diff --git a/solutions/observability/apps/collect-metrics.md b/solutions/observability/apps/collect-metrics.md
@@ -41,7 +41,7 @@ Use **Discover** to validate that metrics are successfully reported to {{kib}}.
 5. Narrow your search with a known OpenTelemetry field. For example, if you have an `order_value` field, add `order_value: *` to your search to return only OpenTelemetry metrics documents.
 
 
-## Visualize in {{kib}} [apm-open-telemetry-visualize]
+## Visualize your metrics[apm-open-telemetry-visualize]
 
 Use **Lens** to create visualizations for OpenTelemetry metrics. Lens enables you to build visualizations by dragging and dropping data fields. It makes smart visualization suggestions for your data, allowing you to switch between visualization types.
 
diff --git a/solutions/observability/apps/create-custom-links.md b/solutions/observability/apps/create-custom-links.md
@@ -8,10 +8,9 @@ navigation_title: "Create custom links"
 
 # Custom links in the Applications UI [apm-custom-links]
 
-::::{admonition} Required role
-:class: note
+::::{note}
 
-For serverless Observability projects, the **Editor** role or higher is required to create and manage custom links. To learn more, refer to [Assign user roles and privileges](../../../deploy-manage/users-roles/cloud-organization/user-roles.md#general-assign-user-roles).
+**For serverless Observability projects**, the **Editor** role or higher is required to create and manage custom links. To learn more, refer to [Assign user roles and privileges](../../../deploy-manage/users-roles/cloud-organization/user-roles.md#general-assign-user-roles).
 
 ::::
 
diff --git a/solutions/observability/apps/create-upload-source-maps-rum.md b/solutions/observability/apps/create-upload-source-maps-rum.md
@@ -1,6 +1,8 @@
 ---
 mapped_pages:
   - https://www.elastic.co/guide/en/observability/current/apm-source-map-how-to.html
+applies_to:
+  stack: all
 ---
 
 # Create and upload source maps (RUM) [apm-source-map-how-to]
diff --git a/solutions/observability/apps/dependencies.md b/solutions/observability/apps/dependencies.md
@@ -29,8 +29,7 @@ If your usage pattern *has* changed, the dependency view can quickly show you wh
 
 ## Operations [dependencies-operations]
 
-::::{admonition} Dependency operations is in beta
-:class: important
+::::{Warning}
 
 The Dependency operations functionality is in beta and is subject to change. The design and code is less mature than official generally available features and is being provided as-is with no warranties.
 
diff --git a/solutions/observability/apps/elastic-apm-agents.md b/solutions/observability/apps/elastic-apm-agents.md
@@ -9,8 +9,7 @@ navigation_title: "APM agents"
 # Elastic APM agents [observability-apm-agents-elastic-apm-agents]
 
 
-::::{admonition} Required role
-:class: note
+::::{note}
 
 **For Observability serverless projects**, the **Admin** role or higher is required to use APM agents. To learn more, refer to [Assign user roles and privileges](../../../deploy-manage/users-roles/cloud-organization/user-roles.md#general-assign-user-roles).
 
diff --git a/solutions/observability/apps/integrate-with-jaeger-deprecated.md b/solutions/observability/apps/integrate-with-jaeger-deprecated.md
@@ -2,6 +2,8 @@
 navigation_title: "Jaeger (deprecated)"
 mapped_pages:
   - https://www.elastic.co/guide/en/observability/current/apm-jaeger-integration.html
+applies_to:
+  stack: all
 ---
 
 
diff --git a/solutions/observability/apps/limitations.md b/solutions/observability/apps/limitations.md
@@ -34,6 +34,9 @@ The [OpenTelemetry Collector exporter for Elastic](https://github.com/open-telem
 % Statefull only for tail-based sampling?
 
 ## OpenTelemetry’s tail-based sampling [apm-open-telemetry-tbs]
+```{applies_to}
+stack: all
+```
 
 Tail-based sampling allows to make sampling decisions after all spans of a trace have been completed. This allows for more powerful and informed sampling rules.
 
diff --git a/solutions/observability/apps/overviews.md b/solutions/observability/apps/overviews.md
@@ -16,7 +16,11 @@ For a quick, high-level overview of the health and performance of your applicati
 * [Dependencies](../../../solutions/observability/apps/dependencies.md)
 * [Service Map](../../../solutions/observability/apps/service-map.md)
 
-% Stateful for mobile service?
+
+## View an individual service [apm-ui-individual-service]
+```{applies_to}
+stack: all
+```
 
 View an individual service:
 
diff --git a/solutions/observability/apps/real-user-monitoring-rum.md b/solutions/observability/apps/real-user-monitoring-rum.md
@@ -1,6 +1,8 @@
 ---
 mapped_pages:
   - https://www.elastic.co/guide/en/observability/current/apm-rum.html
+applies_to:
+  stack: all
 ---
 
 # Real User Monitoring (RUM) [apm-rum]
diff --git a/solutions/observability/apps/resource-atrributes.md b/solutions/observability/apps/resource-atrributes.md
@@ -2,6 +2,8 @@
 mapped_urls:
   - https://www.elastic.co/guide/en/observability/current/apm-open-telemetry-resource-attributes.html
   - https://www.elastic.co/guide/en/serverless/current/observability-apm-agents-opentelemetry-resource-attributes.html
+applies_to:
+  stack: all
 ---
 
 # Resource attributes [apm-open-telemetry-resource-attributes]
diff --git a/solutions/observability/apps/service-map.md b/solutions/observability/apps/service-map.md
@@ -27,6 +27,7 @@ Customize what the service map displays using either the query bar or the enviro
 
 If there’s a specific service that interests you, select that service to highlight its connections. Click **Focus map** to refocus the map on the selected service and lock the connection highlighting. Click the **Transactions** tab to jump to the Transaction overview for the selected service. You can also use the tabs at the top of the page to easily jump to the ***Errors** or **Metrics** overview.
 
+
 :::{image} ../../../images/observability-service-maps-java.png
 :alt: Example view of service maps in the Applications UI in Kibana
 :class: screenshot
@@ -74,4 +75,4 @@ Service Maps are supported for the following APM agent versions:
 | PHP agent | ≥ v1.2.0 |
 | Python agent | ≥ v5.5.0 |
 | Ruby agent | ≥ v3.6.0 |
-| Real User Monitoring (RUM) agent | ≥ v4.7.0 |
+| Real User Monitoring (RUM) agent (**Elastic Stack only**)| ≥ v4.7.0 |
diff --git a/solutions/observability/apps/service-overview.md b/solutions/observability/apps/service-overview.md
@@ -85,7 +85,7 @@ The **Dependencies** table displays a list of downstream services or external co
 % Stateful only for following note?
 
 ::::{note}
-Displaying dependencies for services instrumented with the Real User Monitoring (RUM) agent requires an agent version ≥ v5.6.3.
+**In Elastic Stack deployments**, displaying dependencies for services instrumented with the Real User Monitoring (RUM) agent requires an agent version ≥ v5.6.3.
 ::::
 
 
@@ -100,6 +100,7 @@ The cold start rate chart is currently supported for [AWS Lambda](../../../solut
 
 The **Instances** table displays a list of all the available service instances within the selected time range. Depending on how the service runs, the instance could be a host or a container. The table displays latency, throughput, failed transaction, CPU usage, and memory usage for each instance. By default, instances are sorted by *Throughput*.
 
+
 :::{image} ../../../images/observability-all-instances.png
 :alt: All instances
 :class: screenshot
@@ -110,6 +111,7 @@ The **Instances** table displays a list of all the available service instances w
 
 To view metadata relating to the service agent, and if relevant, the container and cloud provider, click on each icon located at the top of the page beside the service name.
 
+
 :::{image} ../../../images/observability-metadata-icons.png
 :alt: Service metadata
 :class: screenshot
diff --git a/solutions/observability/apps/services.md b/solutions/observability/apps/services.md
@@ -2,6 +2,9 @@
 mapped_urls:
   - https://www.elastic.co/guide/en/observability/current/apm-services.html
   - https://www.elastic.co/guide/en/serverless/current/observability-apm-services.html
+applies_to:
+  stack: all
+  serverless: all
 ---
 
 # Services [apm-services]
@@ -51,36 +54,13 @@ Group services together to build meaningful views that remove noise, simplify in
 
 To create a service group:
 
-::::{tab-set}
-:group: stack-serverless
-
-:::{tab-item} Elastic Stack
-:sync: stack
-
 1. To open **Service inventory**, find **Applications** in the main menu or use the [global search field](/explore-analyze/find-and-organize/find-apps-and-objects.md).
 2. Switch to **Service groups**.
 3. Click **Create group**.
 4. Specify a name, color, and description.
 5. Click **Select services**.
 6. Specify a [{{kib}} Query Language (KQL)](../../../explore-analyze/query-filter/languages/kql.md) query to filter services by one or more of the following dimensions: `agent.name`, `service.name`, `service.language.name`, `service.environment`, `labels.<xyz>`. Services that match the query within the last 24 hours will be assigned to the group.
 
-:::
-
-:::{tab-item} Serverless
-:sync: serverless
-
-1. In your {{obs-serverless}} project, go to **Applications** → **Service Inventory**.
-2. Switch to **Service groups**.
-3. Click **Create group**.
-4. Specify a name, color, and description.
-5. Click **Select services**.
-6. Specify a [Kibana Query Language (KQL)](../../../explore-analyze/query-filter/languages/kql.md) query to filter services by one or more of the following dimensions: `agent.name`, `service.name`, `service.language.name`, `service.environment`, `labels.<xyz>`. Services that match the query within the last 24 hours will be assigned to the group.
-
-:::
-
-::::
-
-
 ### Examples [apm-services-examples]
 
 Not sure where to get started? Here are some sample queries you can build from:
diff --git a/solutions/observability/apps/upstream-opentelemetry-collectors-language-sdks.md b/solutions/observability/apps/upstream-opentelemetry-collectors-language-sdks.md
@@ -173,7 +173,9 @@ java -javaagent:/path/to/opentelemetry-javaagent-all.jar \
      com.mycompany.checkout.CheckoutServiceServer
 ```
 
-1. [preview] The OpenTelemetry logs intake via APM Server is currently in technical preview.`OTEL_RESOURCE_ATTRIBUTES`
+1. [preview] The OpenTelemetry logs intake via APM Server is currently in technical preview.
+
+`OTEL_RESOURCE_ATTRIBUTES`
 :   Fields that describe the service and the environment that the service runs in. See [resource attributes](../../../solutions/observability/apps/resource-atrributes.md) for more information.
 
 `OTEL_EXPORTER_OTLP_ENDPOINT`
@@ -213,7 +215,9 @@ java -javaagent:/path/to/opentelemetry-javaagent-all.jar \
      com.mycompany.checkout.CheckoutServiceServer
 ```
 
-1. [preview]  The OpenTelemetry logs intake via Elastic is currently in technical preview.`OTEL_RESOURCE_ATTRIBUTES`
+1. [preview]  The OpenTelemetry logs intake via Elastic is currently in technical preview.
+
+`OTEL_RESOURCE_ATTRIBUTES`
 :   Fields that describe the service and the environment that the service runs in. See [resource attributes](../../../solutions/observability/apps/resource-atrributes.md) for more information.
 
 `OTEL_EXPORTER_OTLP_ENDPOINT`
diff --git a/solutions/observability/apps/use-opentelemetry-with-apm.md b/solutions/observability/apps/use-opentelemetry-with-apm.md
@@ -1,16 +1,15 @@
 ---
+navigation_title: "OpenTelemetry"
 mapped_urls:
   - https://www.elastic.co/guide/en/serverless/current/observability-apm-agents-opentelemetry.html
   - https://www.elastic.co/guide/en/observability/current/apm-open-telemetry.html
-
-navigation_title: "OpenTelemetry"
 ---
 
 # Use OpenTelemetry with APM [apm-open-telemetry]
 
 
 ::::{note}
-For a complete overview of using OpenTelemetry with Elastic, explore** [**Elastic Distributions of OpenTelemetry**](https://github.com/elastic/opentelemetry).
+For a complete overview of using OpenTelemetry with Elastic, explore [**Elastic Distributions of OpenTelemetry**](https://github.com/elastic/opentelemetry).
 
 ::::
 
