Add applies_to statements (#4196)

* Add applies_to metadataa

* Add section applies

* Remove products

* Update docs/reference/config-metrics.md

Co-authored-by: Colleen McGinnis <[email protected]>

* Update docs/reference/method-sampling-based.md

Co-authored-by: Colleen McGinnis <[email protected]>

* Update docs/reference/how-to-find-slow-methods.md

Co-authored-by: Colleen McGinnis <[email protected]>

* Update docs/reference/how-to-find-slow-methods.md

Co-authored-by: Colleen McGinnis <[email protected]>

---------

Co-authored-by: Colleen McGinnis <[email protected]>

Author: theletterf

apm-agent-builds/apm-agent/src/test/resources/config-reference-properties-file.md.ftl

@@ -1,6 +1,12 @@
 ---
 mapped_pages:
   - https://www.elastic.co/guide/en/apm/agent/java/current/config-reference-properties-file.html
+applies_to:
+  stack:
+  serverless:
+    observability:
+  product:
+    apm_agent_java: ga
 ---
 
 # Property file reference [config-reference-properties-file]

docs/reference/aws-lambda.md

@@ -4,6 +4,12 @@ mapped_pages:
 sub:
   apm-lambda-ext-v: ver-1-5-7
   apm-java-v: ver-1-52-2
+applies_to:
+  stack:
+  serverless:
+    observability:
+  product:
+    apm_agent_java: ga
 ---
 
 # Monitoring AWS Lambda Java Functions [aws-lambda]

docs/reference/community-plugins.md

@@ -1,6 +1,12 @@
 ---
 mapped_pages:
   - https://www.elastic.co/guide/en/apm/agent/java/current/community-plugins.html
+applies_to:
+  stack:
+  serverless:
+    observability:
+  product:
+    apm_agent_java: ga
 ---
 
 # Community plugins [community-plugins]

docs/reference/config-circuit-breaker.md

@@ -2,13 +2,21 @@
 navigation_title: "Circuit-Breaker"
 mapped_pages:
   - https://www.elastic.co/guide/en/apm/agent/java/current/config-circuit-breaker.html
+applies_to:
+  stack:
+  serverless:
+    observability:
+  product:
+    apm_agent_java: ga
 ---
 
 # Circuit-Breaker configuration options [config-circuit-breaker]
 
+## `circuit_breaker_enabled` [config-circuit-breaker-enabled]
 
-
-## `circuit_breaker_enabled` ([1.14.0] performance) [config-circuit-breaker-enabled]
+```{applies_to}
+apm_agent_java: ga 1.14.0
+```
 
 A boolean specifying whether the circuit breaker should be enabled or not. When enabled, the agent periodically polls stress monitors to detect system/process/JVM stress state. If ANY of the monitors detects a stress indication, the agent will become inactive, as if the [`recording`](/reference/config-core.md#config-recording) configuration option has been set to `false`, thus reducing resource consumption to a minimum. When inactive, the agent continues polling the same monitors in order to detect whether the stress state has been relieved. If ALL monitors approve that the system/process/JVM is not under stress anymore, the agent will resume and become fully functional.
 

docs/reference/config-core.md

@@ -2,13 +2,23 @@
 navigation_title: "Datastore"
 mapped_pages:
   - https://www.elastic.co/guide/en/apm/agent/java/current/config-datastore.html
+applies_to:
+  stack:
+  serverless:
+    observability:
+  product:
+    apm_agent_java: ga
 ---
 
 # Datastore configuration options [config-datastore]
 
 
 
-## `elasticsearch_capture_body_urls` ([1.37.0]) [config-elasticsearch-capture-body-urls]
+## `elasticsearch_capture_body_urls` [config-elasticsearch-capture-body-urls]
+
+```{applies_to}
+apm_agent_java: ga 1.37.0
+```
 
 The URL path patterns for which the APM agent will capture the request body of outgoing requests to Elasticsearch made with the `elasticsearch-restclient` instrumentation. The default setting captures the body for Elasticsearch REST APIs searches and counts.
 

docs/reference/config-datastore.md

@@ -2,13 +2,23 @@
 navigation_title: "HTTP"
 mapped_pages:
   - https://www.elastic.co/guide/en/apm/agent/java/current/config-http.html
+applies_to:
+  stack:
+  serverless:
+    observability:
+  product:
+    apm_agent_java: ga
 ---
 
 # HTTP configuration options [config-http]
 
 
 
-## `capture_body_content_types` ([1.5.0] performance) [config-capture-body-content-types]
+## `capture_body_content_types` (performance) [config-capture-body-content-types]
+
+```{applies_to}
+apm_agent_java: ga 1.5.0
+```
 
 Configures which content types should be recorded.
 
@@ -46,7 +56,11 @@ This option supports the wildcard `*`, which matches zero or more characters. Ex
 | `elastic.apm.transaction_ignore_urls` | `transaction_ignore_urls` | `ELASTIC_APM_TRANSACTION_IGNORE_URLS` |
 
 
-## `transaction_ignore_user_agents` ([1.22.0]) [config-transaction-ignore-user-agents]
+## `transaction_ignore_user_agents` [config-transaction-ignore-user-agents]
+
+```{applies_to}
+apm_agent_java: ga 1.22.0
+```
 
 Used to restrict requests from certain User-Agents from being instrumented.
 
@@ -65,7 +79,11 @@ This option supports the wildcard `*`, which matches zero or more characters. Ex
 | `elastic.apm.transaction_ignore_user_agents` | `transaction_ignore_user_agents` | `ELASTIC_APM_TRANSACTION_IGNORE_USER_AGENTS` |
 
 
-## `use_path_as_transaction_name` ([1.0.0]) [config-use-path-as-transaction-name]
+## `use_path_as_transaction_name` [config-use-path-as-transaction-name]
+
+```{applies_to}
+apm_agent_java: ga 1.0.0
+```
 
 If set to `true`, transaction names of unsupported or partially-supported frameworks will be in the form of `$method $path` instead of just `$method unknown route`.
 
@@ -106,7 +124,11 @@ This option supports the wildcard `*`, which matches zero or more characters. Ex
 | `elastic.apm.url_groups` | `url_groups` | `ELASTIC_APM_URL_GROUPS` |
 
 
-## `capture_http_client_request_body_size` ([1.52.0] experimental) [config-capture-http-client-request-body-size]
+## `capture_http_client_request_body_size` (experimental) [config-capture-http-client-request-body-size]
+
+```{applies_to}
+apm_agent_java: ga 1.52.0
+```
 
 ::::{note}
 This feature is currently experimental, which means it is disabled by default and it is not guaranteed to be backwards compatible in future releases.
@@ -129,7 +151,11 @@ Currently only support for Apache Http Client v4 and v5, HttpUrlConnection, Spri
 | `elastic.apm.capture_http_client_request_body_size` | `capture_http_client_request_body_size` | `ELASTIC_APM_CAPTURE_HTTP_CLIENT_REQUEST_BODY_SIZE` |
 
 
-## `capture_http_client_request_body_as_label` ([1.54.0]) [config-capture-http-client-request-body-as-label]
+## `capture_http_client_request_body_as_label` [config-capture-http-client-request-body-as-label]
+
+```{applies_to}
+apm_agent_java: ga 1.54.0
+```
 
 ::::{note}
 This feature is currently experimental, which means it is disabled by default and it is not guaranteed to be backwards compatible in future releases.

docs/reference/config-http.md

@@ -2,13 +2,27 @@
 navigation_title: "Huge Traces"
 mapped_pages:
   - https://www.elastic.co/guide/en/apm/agent/java/current/config-huge-traces.html
+applies_to:
+  stack:
+  serverless:
+    observability:
+  product:
+    apm_agent_java: ga
+products:
+  - id: cloud-serverless
+  - id: observability
+  - id: apm  
 ---
 
 # Huge Traces configuration options [config-huge-traces]
 
 
 
-## `span_compression_enabled` ([1.30.0]) [config-span-compression-enabled]
+## `span_compression_enabled` [config-span-compression-enabled]
+
+```{applies_to}
+apm_agent_java: ga 1.30.0
+```
 
 Setting this option to true will enable span compression feature. Span compression reduces the collection, processing, and storage overhead, and removes clutter from the UI. The tradeoff is that some information such as DB statements of all the compressed spans will not be collected.
 
@@ -23,7 +37,11 @@ Setting this option to true will enable span compression feature. Span compressi
 | `elastic.apm.span_compression_enabled` | `span_compression_enabled` | `ELASTIC_APM_SPAN_COMPRESSION_ENABLED` |
 
 
-## `span_compression_exact_match_max_duration` ([1.30.0]) [config-span-compression-exact-match-max-duration]
+## `span_compression_exact_match_max_duration` [config-span-compression-exact-match-max-duration]
+
+```{applies_to}
+apm_agent_java: ga 1.30.0
+```
 
 Consecutive spans that are exact match and that are under this threshold will be compressed into a single composite span. This option does not apply to composite spans. This reduces the collection, processing, and storage overhead, and removes clutter from the UI. The tradeoff is that the DB statements of all the compressed spans will not be collected.
 
@@ -40,7 +58,11 @@ Supports the duration suffixes `ms`, `s` and `m`. Example: `50ms`.
 | `elastic.apm.span_compression_exact_match_max_duration` | `span_compression_exact_match_max_duration` | `ELASTIC_APM_SPAN_COMPRESSION_EXACT_MATCH_MAX_DURATION` |
 
 
-## `span_compression_same_kind_max_duration` ([1.30.0]) [config-span-compression-same-kind-max-duration]
+## `span_compression_same_kind_max_duration` [config-span-compression-same-kind-max-duration]
+
+```{applies_to}
+apm_agent_java: ga 1.30.0
+```
 
 Consecutive spans to the same destination that are under this threshold will be compressed into a single composite span. This option does not apply to composite spans. This reduces the collection, processing, and storage overhead, and removes clutter from the UI. The tradeoff is that the DB statements of all the compressed spans will not be collected.
 
@@ -57,7 +79,11 @@ Supports the duration suffixes `ms`, `s` and `m`. Example: `0ms`.
 | `elastic.apm.span_compression_same_kind_max_duration` | `span_compression_same_kind_max_duration` | `ELASTIC_APM_SPAN_COMPRESSION_SAME_KIND_MAX_DURATION` |
 
 
-## `exit_span_min_duration` ([1.30.0]) [config-exit-span-min-duration]
+## `exit_span_min_duration` [config-exit-span-min-duration]
+
+```{applies_to}
+apm_agent_java: ga 1.30.0
+```
 
 Exit spans are spans that represent a call to an external service, like a database. If such calls are very short, they are usually not relevant and can be ignored.
 

docs/reference/config-huge-traces.md

@@ -2,6 +2,12 @@
 navigation_title: "JAX-RS"
 mapped_pages:
   - https://www.elastic.co/guide/en/apm/agent/java/current/config-jax-rs.html
+applies_to:
+  stack:
+  serverless:
+    observability:
+  product:
+    apm_agent_java: ga
 ---
 
 # JAX-RS configuration options [config-jax-rs]
@@ -21,7 +27,11 @@ By default, the agent will scan for @Path annotations on the whole class hierarc
 | `elastic.apm.enable_jaxrs_annotation_inheritance` | `enable_jaxrs_annotation_inheritance` | `ELASTIC_APM_ENABLE_JAXRS_ANNOTATION_INHERITANCE` |
 
 
-## `use_jaxrs_path_as_transaction_name` ([1.8.0]) [config-use-jaxrs-path-as-transaction-name]
+## `use_jaxrs_path_as_transaction_name` [config-use-jaxrs-path-as-transaction-name]
+
+```{applies_to}
+apm_agent_java: ga 1.8.0
+```
 
 By default, the agent will use `ClassName#methodName` for the transaction name of JAX-RS requests. If you want to use the URI template from the `@Path` annotation, set the value to `true`.
 

docs/reference/config-jax-rs.md

@@ -2,13 +2,23 @@
 navigation_title: "JMX"
 mapped_pages:
   - https://www.elastic.co/guide/en/apm/agent/java/current/config-jmx.html
+applies_to:
+  stack:
+  serverless:
+    observability:
+  product:
+    apm_agent_java: ga
 ---
 
 # JMX configuration options [config-jmx]
 
 
 
-## `capture_jmx_metrics` ([1.11.0]) [config-capture-jmx-metrics]
+## `capture_jmx_metrics` [config-capture-jmx-metrics]
+
+```{applies_to}
+apm_agent_java: ga 1.11.0
+```
 
 Report metrics from JMX to the APM Server