diff --git a/reference/apm/cloud/apm-settings.md b/reference/apm/cloud/apm-settings.md index 80dfc1631..d33d4ce0e 100644 --- a/reference/apm/cloud/apm-settings.md +++ b/reference/apm/cloud/apm-settings.md @@ -51,6 +51,10 @@ If a setting is not supported by {{ech}}, you will get an error message when you Some settings that could break your cluster if set incorrectly are blocklisted. The following settings are generally safe in cloud environments. For detailed information about APM settings, check the [APM documentation](/solutions/observability/apm/configure-apm-server.md). :::: +### Version 8.19+ and 9.1+ [ec_version_8_19_and_9_1] + +`apm-server.sampling.tail.ttl` +: Time-to-live (TTL) for trace events stored in the local storage of the APM Server during tail-based sampling. This TTL determines how long trace events are retained in the local storage while waiting for a sampling decision to be made. A greater TTL value increases storage space requirements. ### Version 8.0+ [ec_version_8_0_3] diff --git a/solutions/observability/apm/configure-apm-server.md b/solutions/observability/apm/configure-apm-server.md index 14a7d13cf..9599f45d4 100644 --- a/solutions/observability/apm/configure-apm-server.md +++ b/solutions/observability/apm/configure-apm-server.md @@ -74,6 +74,11 @@ If a setting is not supported on {{ecloud}}, you will get an error message when Some settings that could break your cluster if set incorrectly are blocklisted. The following settings are generally safe in cloud environments. For detailed information about APM settings, check the [APM documentation](/solutions/observability/apm/configure-apm-server.md). :::: +### Version 8.19+ and 9.1+ [ec_version_8_19_and_9_1] + +`apm-server.sampling.tail.ttl` +: Time-to-live (TTL) for trace events stored in the local storage of the APM Server during tail-based sampling. This TTL determines how long trace events are retained in the local storage while waiting for a sampling decision to be made. A greater TTL value increases storage space requirements. + ### Version 8.0+ [ec_version_8_0_3] This stack version removes support for some previously supported settings. These are all of the supported settings for this version: diff --git a/solutions/observability/apm/tail-based-sampling.md b/solutions/observability/apm/tail-based-sampling.md index 11b79da93..a4a7f1517 100644 --- a/solutions/observability/apm/tail-based-sampling.md +++ b/solutions/observability/apm/tail-based-sampling.md @@ -71,6 +71,16 @@ Synchronization interval for multiple APM Servers. Should be in the order of ten | APM Server binary | `sampling.tail.interval` | | Fleet-managed | `Interval` | +### TTL [sampling-tail-ttl-ref] + +Time-to-live (TTL) for trace events stored in the local storage of the APM Server during tail-based sampling. This TTL determines how long trace events are retained in the local storage while waiting for a sampling decision to be made. A greater TTL value increases storage space requirements. Default: `30m` (30 minutes). (duration) + +| | | +| --- |---------------------| +| APM Server binary | `sampling.tail.ttl` | +| Fleet-managed | `TTL` | + + ### Policies [sampling-tail-policies-ref] Criteria used to match a root transaction to a sample rate. diff --git a/solutions/observability/apm/transaction-sampling.md b/solutions/observability/apm/transaction-sampling.md index 0210d390e..4b492054b 100644 --- a/solutions/observability/apm/transaction-sampling.md +++ b/solutions/observability/apm/transaction-sampling.md @@ -312,6 +312,15 @@ Synchronization interval for multiple APM Servers. Should be in the order of ten | APM Server binary | `sampling.tail.interval` | | Fleet-managed | `Interval` | +##### TTL [sampling-tail-ttl] + +Time-to-live (TTL) for trace events stored in the local storage of the APM Server during tail-based sampling. This TTL determines how long trace events are retained in the local storage while waiting for a sampling decision to be made. A greater TTL value increases storage space requirements. Default: `30m` (30 minutes). (duration) + +| | | +| --- |---------------------| +| APM Server binary | `sampling.tail.ttl` | +| Fleet-managed | `TTL` | + ##### Policies [sampling-tail-policies] Criteria used to match a root transaction to a sample rate.