Skip to content

[Agent] Manual rollback for agent upgrades#4918

Open
karenzone wants to merge 6 commits intoelastic:mainfrom
karenzone:11536-rollback
Open

[Agent] Manual rollback for agent upgrades#4918
karenzone wants to merge 6 commits intoelastic:mainfrom
karenzone:11536-rollback

Conversation

@karenzone
Copy link
Contributor

Summary

Adds docs for Manual rollback for agent upgrades.

If a user upgrades an agent running v9.3.0 or later, they have the option to roll back to the previously installed version for seven days.

Fixes: elastic/elastic-agent#11536

Generative AI disclosure

  1. Did you use a generative AI (GenAI) tool to assist in creating this contribution?
  • Yes (content refinement)
  • No
Copilot (Claude Sonnet 4.5)

@karenzone karenzone self-assigned this Jan 30, 2026
@karenzone karenzone added the documentation Improvements or additions to documentation label Jan 30, 2026
@github-actions
Copy link
Contributor

github-actions bot commented Jan 30, 2026

✅ Vale Linting Results

No issues found on modified lines!


The Vale linter checks documentation changes against the Elastic Docs style guide.

To use Vale locally or report issues, refer to Elastic style guide for Vale.

@github-actions
Copy link
Contributor

github-actions bot commented Jan 30, 2026

@karenzone
Copy link
Contributor Author

cc:/ @pchila @jillguyonnet @nimarezainia, your early comments are welcome.

@nimarezainia
Copy link
Contributor

@karenzone the content looks good to me. Could the "Roll back an Elastic Agent upgrade for Fleet Managed agents" section have a larger font size so it's at the same hierarchical level as "Update RPM and DEB system packages" - currently it feels as though it's part of the RPM and DEB section.

Copy link
Member

@pchila pchila left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Left a couple of suggestion (minor rewording which makes the content clearer, I hope)
Left a question about the Fleet API endpoint to use in order to rollback a single agent since it doesn't look right to me.

Co-authored-by: Paolo Chilà <paolo.chila@elastic.co>
Copy link
Contributor

@jillguyonnet jillguyonnet left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM overall, left a couple of small comments.

:Call `POST /api/fleet/agents/{agentID}/rollback`.

To roll back multiple agents:
:Call `POST /api/fleet/agents/bulk_rollback`.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do we already have links to the API reference? Probably not a huge deal if not in this case since there are no options, but bulk endpoints expect agents in the request body (either a list of agent ids or a query string, see e.g. bulk migrate), making that explicit could be helpful.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If I'm reading this correctly, you are asking if we have documented rollbacks in the API docs. We have not. If that's what you are suggesting, we can open an issue for follow up.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Docs] - Document manual rollback feature

4 participants