[DOCS] Clarify the frequency of config polling (#3799)

 --------- Co-authored-by: Jonas Kunz <jonas.kunz@elastic.co>

Author: lucabelluccini

apm-agent-core/src/main/java/co/elastic/apm/agent/configuration/CoreConfigurationImpl.java

@@ -25,7 +25,13 @@
 import co.elastic.apm.agent.matcher.MethodMatcherValueConverter;
 import co.elastic.apm.agent.sdk.logging.Logger;
 import co.elastic.apm.agent.sdk.logging.LoggerFactory;
-import co.elastic.apm.agent.tracer.configuration.*;
+import co.elastic.apm.agent.tracer.configuration.CoreConfiguration;
+import co.elastic.apm.agent.tracer.configuration.ListValueConverter;
+import co.elastic.apm.agent.tracer.configuration.RegexValidator;
+import co.elastic.apm.agent.tracer.configuration.RoundedDoubleConverter;
+import co.elastic.apm.agent.tracer.configuration.TimeDuration;
+import co.elastic.apm.agent.tracer.configuration.TimeDurationValueConverter;
+import co.elastic.apm.agent.tracer.configuration.WildcardMatcherValueConverter;
 import org.stagemonitor.configuration.ConfigurationOption;
 import org.stagemonitor.configuration.ConfigurationOptionProvider;
 import org.stagemonitor.configuration.converter.AbstractValueConverter;
@@ -696,7 +702,8 @@ public String toSafeString(List<WildcardMatcher> value) {
  .key("central_config")
  .tags("added[1.8.0]")
  .configurationCategory(CORE_CATEGORY)
- .description("When enabled, the agent will make periodic requests to the APM Server to fetch updated configuration.")
+ .description("When enabled, the agent will make periodic requests to the APM Server to fetch updated configuration.\n"
+ + "The frequency of the periodic request is driven by the `Cache-Control` header returned from APM Server/Integration, falling back to 5 minutes if not defined.")
  .dynamic(true)
  .buildWithDefault(true);
 

docs/configuration.asciidoc

@@ -1270,6 +1270,7 @@ Example: `0ms`.
 ==== `central_config` (added[1.8.0])
 
 When enabled, the agent will make periodic requests to the APM Server to fetch updated configuration.
+The frequency of the periodic request is driven by the `Cache-Control` header returned from APM Server/Integration, falling back to 5 minutes if not defined.
 
 <<configuration-dynamic, image:./images/dynamic-config.svg[] >>
 
@@ -4061,6 +4062,7 @@ Example: `5ms`.
 # trace_methods_duration_threshold=0ms
 
 # When enabled, the agent will make periodic requests to the APM Server to fetch updated configuration.
+# The frequency of the periodic request is driven by the `Cache-Control` header returned from APM Server/Integration, falling back to 5 minutes if not defined.
 #
 # This setting can be changed at runtime
 # Type: Boolean