Add allow_older_versions setting (#1205) (#1209)

* Add setting * Add note about Fleet Server * higher -> later * split lines * split lines * rephrase (cherry picked from commit 023f7cf) Co-authored-by: David Kilfoyle <[email protected]>
elastic · Jul 29, 2024 · 6f2edad · 6f2edad
1 parent 369d240
commit 6f2edad
Show file tree

Hide file tree

Showing 2 changed files with 32 additions and 0 deletions.
diff --git a/...st-management/elastic-agent/configuration/outputs/output-elasticsearch.asciidoc b/...st-management/elastic-agent/configuration/outputs/output-elasticsearch.asciidoc
@@ -51,6 +51,8 @@ category. Many of these settings have sensible defaults that allow you to run
 
 * <<output-elasticsearch-authentication-settings>>
 
+* <<output-elasticsearch-compatibility-setting>>
+
 * <<output-elasticsearch-data-parsing-settings>>
 
 * <<output-elasticsearch-http-settings>>
@@ -295,6 +297,32 @@ options. Based on this configuration, the name would be:
 
 include::../authentication/kerberos-shared-settings.asciidoc[tag=kerberos-all-settings]
 
+[[output-elasticsearch-compatibility-setting]]
+=== Compatibility setting
+
+[cols="2*<a"]
+|===
+| Setting | Description
+
+// tag::allow_older_versions-setting[]
+|
+[id="{type}-allow_older_versions-setting"]
+`allow_older_versions`
+
+| Allow {agent} to connect and send output to an {es} instance that is running an earlier version than the agent version.
+
+Note that this setting does not affect {agent}'s ability to connect to {fleet-server}.
+{fleet-server} will not accept a connection from an agent at a later major or minor version.
+It will accept a connection from an agent at a later patch version.
+For example, an {agent} at version 8.14.3 can connect to a {fleet-server} on version 8.14.0, but an agent at version 8.15.0 or later is not able to connect.
+
+*Default:* `true`
+// end::allow_older_versions-setting[]
+
+// =============================================================================
+
+|===
+
 [[output-elasticsearch-data-parsing-settings]]
 === Data parsing, filtering, and manipulation settings
 

diff --git a/docs/en/ingest-management/fleet/fleet-settings-output-elasticsearch.asciidoc b/docs/en/ingest-management/fleet/fleet-settings-output-elasticsearch.asciidoc
@@ -123,6 +123,10 @@ When you create an {agent} policy using this output, the output will use the bal
 |===
 | Setting | Description
 
+include::../elastic-agent/configuration/outputs/output-elasticsearch.asciidoc[tag=allow_older_versions-setting]
+
+// =============================================================================
+
 include::../elastic-agent/configuration/outputs/output-elasticsearch.asciidoc[tag=backoff.init-setting]
 
 // =============================================================================