From b1fddeeecac5aaf1afe548ca689ebc60780acff4 Mon Sep 17 00:00:00 2001 From: Arianna Laudazzi Date: Wed, 18 Feb 2026 17:23:54 +0100 Subject: [PATCH] Add known limitations --- .../synthetics-private-location.asciidoc | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/docs/en/observability/synthetics-private-location.asciidoc b/docs/en/observability/synthetics-private-location.asciidoc index da3d3d17e8..0ddb028a4b 100644 --- a/docs/en/observability/synthetics-private-location.asciidoc +++ b/docs/en/observability/synthetics-private-location.asciidoc @@ -175,6 +175,17 @@ These limits are for simultaneous tests, not total tests. For example, if However, it is a good practice to set up execution slots with extra capacity. A good starting point would be to over-allocate by a factor of 5. In the previous example that would mean allocating 5 slots. +[discrete] +[[synthetics-known-limitations-vertical-scaling]] +== Known limitations on vertical scaling + +- A single private location will not scale beyond 10,000 monitors. Exceeding this number will result in agent degradation and inconsistent execution, regardless of the resources allocated. + +- Complex monitor configuration can disproportionately increase the private location policy size, leading to agent communication errors and degradation even if the limit mentioned above hasn't been reached. In these edge cases, increasing the `server.limits.checkin_limit.max_body_byte_size` setting on Fleet Server to 8 MB or 16 MB (or setting it to -1 to turn off the limit entirely) might help prevent communication errors. + +If you're facing one of these scenarios, it is likely that the private location has grown too large and needs to be split into smaller locations, each alloted a portion of the original location monitors. + + [discrete] [[synthetics-private-location-next]] = Next steps