Skip to content

Commit fc431a3

Browse files
Clarify Elastic Agent upgrade rollouts (#2579)
Adding a couple of clarifications regarding upgrading Elastic Agents with a rollout period: 1. Agents in the rollout but not actually upgrading yet have status `Updating` in Fleet. 2. For auto-upgrades, the rollout period is automatically calculated based on the number of agents (less than 10 agents: no rollout; more than 10 agents: rollout duration of 10 min or nAgents * 0.03 seconds, whichever is higher). --------- Co-authored-by: Visha Angelova <[email protected]>
1 parent d0cce8b commit fc431a3

File tree

1 file changed

+4
-1
lines changed

1 file changed

+4
-1
lines changed

reference/fleet/upgrade-elastic-agent.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -101,6 +101,7 @@ You can do rolling upgrades to avoid exhausting network resources when updating
101101

102102
5. Upgrade the agents.
103103

104+
Note that agents in a rollout period have the status `Updating` until the upgrade is complete, even if the upgrade has not started yet.
104105

105106
## Schedule an upgrade [schedule-agent-upgrade]
106107

@@ -245,7 +246,9 @@ To configure an automatic rollout of a new minor or patch version to a percentag
245246
7. You can then add a different target version, and specify the percentage of agents you want to be upgraded to that version. The total percentage of agents to be upgraded cannot exceed 100%.
246247
8. Click **Save**.
247248

248-
Once the configuration is saved, an asynchronous task runs every 30 minutes, gradually upgrading the agents in the policy to the specified target version.
249+
Once the configuration is saved, an asynchronous task runs every 30 minutes, upgrading the agents in the policy to the specified target version.
250+
251+
If the number of agents to be upgraded is greater than or equal to 10, a rollout period is automatically applied. The rollout duration is either 10 minutes or `nAgents * 0.03` seconds, whichever is greater.
249252

250253
In case of any failed upgrades, the upgrades are retried with exponential backoff mechanism until the upgrade is successful, or the maximum number of retries is reached. Note that the maximum number of retries is the number of [configured retry delays](#auto-upgrade-settings).
251254

0 commit comments

Comments
 (0)