From 1e3d0c7b7c9cd0058d0f601dce69397e85c2f86e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Paolo=20Chil=C3=A0?= <paolo.chila@elastic.co>
Date: Mon, 15 Sep 2025 21:56:28 +0200
Subject: [PATCH] Add Reason field to elastic-agent upgrade details metadata
 (#134711)

* Add Reason field to elastic-agent upgrade details metadata

Add "reason" text field to map a new upgrade details field introduced in
PR https://github.com/elastic/elastic-agent/pull/8407

* Update docs/changelog/134711.yaml

* Bump FLEET_AGENTS_MAPPINGS_VERSION

(cherry picked from commit 67676aebea29aa3e690bbe0ef38831998b446b55)

# Conflicts:
#	x-pack/plugin/fleet/src/main/java/org/elasticsearch/xpack/fleet/Fleet.java
---
 docs/changelog/134711.yaml                               | 5 +++++
 .../src/main/resources/fleet-agents.json                 | 9 +++++++++
 .../main/java/org/elasticsearch/xpack/fleet/Fleet.java   | 2 +-
 3 files changed, 15 insertions(+), 1 deletion(-)
 create mode 100644 docs/changelog/134711.yaml

diff --git a/docs/changelog/134711.yaml b/docs/changelog/134711.yaml
new file mode 100644
index 0000000000000..0789eeb4b69df
--- /dev/null
+++ b/docs/changelog/134711.yaml
@@ -0,0 +1,5 @@
+pr: 134711
+summary: Add Reason field to elastic-agent upgrade details metadata
+area: Infra/Plugins
+type: enhancement
+issues: []
diff --git a/x-pack/plugin/core/template-resources/src/main/resources/fleet-agents.json b/x-pack/plugin/core/template-resources/src/main/resources/fleet-agents.json
index 4405b443859d5..fb2c840d72c8f 100644
--- a/x-pack/plugin/core/template-resources/src/main/resources/fleet-agents.json
+++ b/x-pack/plugin/core/template-resources/src/main/resources/fleet-agents.json
@@ -308,6 +308,15 @@
                 },
                 "retry_until": {
                   "type": "date"
+                },
+                "reason": {
+                  "type":"text",
+                  "fields": {
+                    "keyword": {
+                      "type": "keyword",
+                      "ignore_above": 1024
+                    }
+                  }
                 }
               }
             }
diff --git a/x-pack/plugin/fleet/src/main/java/org/elasticsearch/xpack/fleet/Fleet.java b/x-pack/plugin/fleet/src/main/java/org/elasticsearch/xpack/fleet/Fleet.java
index c2a5fe1ebb782..65c207b3855c6 100644
--- a/x-pack/plugin/fleet/src/main/java/org/elasticsearch/xpack/fleet/Fleet.java
+++ b/x-pack/plugin/fleet/src/main/java/org/elasticsearch/xpack/fleet/Fleet.java
@@ -79,7 +79,7 @@ public class Fleet extends Plugin implements SystemIndexPlugin {
     private static final String MAPPING_VERSION_VARIABLE = "fleet.version";
     private static final List<String> ALLOWED_PRODUCTS = List.of("kibana", "fleet");
     private static final int FLEET_ACTIONS_MAPPINGS_VERSION = 2;
-    private static final int FLEET_AGENTS_MAPPINGS_VERSION = 2;
+    private static final int FLEET_AGENTS_MAPPINGS_VERSION = 4;
     private static final int FLEET_ENROLLMENT_API_KEYS_MAPPINGS_VERSION = 3;
     private static final int FLEET_SECRETS_MAPPINGS_VERSION = 1;
     private static final int FLEET_POLICIES_MAPPINGS_VERSION = 2;