docs: Document sampling behavior on TBS storage limit reached (#11663)

Document sampling behavior on TBS storage limit reached.
elastic · Sep 20, 2023 · f33e218 · f33e218
1 parent 148079b
commit f33e218
Showing 1 changed file with 3 additions and 0 deletions.
diff --git a/docs/configure/sampling.asciidoc b/docs/configure/sampling.asciidoc
@@ -65,6 +65,9 @@ This final policy is used to catch remaining trace events that don't match a str
 [id="sampling-tail-storage_limit-{input-type}"]
 == Storage limit
 The amount of storage space allocated for trace events matching tail sampling policies. Caution: Setting this limit higher than the allowed space may cause APM Server to become unhealthy.
+
+If the configured storage limit is insufficient, it logs "configured storage limit reached". The event will bypass sampling and will always be indexed when storage limit is reached.
+
 Default: `3GB`. (text)
 
 |====