在 Ubuntu 上升级 Filebeat 的推荐做法
一 准备与版本确认
- 备份关键数据与配置，避免升级回滚困难：
- 配置文件：sudo cp /etc/filebeat/filebeat.yml /etc/filebeat/filebeat.yml.bak
- 数据目录（如存在）：sudo cp -r /var/lib/filebeat /var/lib/filebeat.bak
- 查看当前版本：filebeat version
- 确认服务运行状态：sudo systemctl status filebeat
- 建议先在测试环境验证，再在生产环境执行升级。
二 使用 APT 升级（推荐）
- 更新索引并升级 Filebeat：
- sudo apt update
- sudo apt upgrade filebeat（或升级全部：sudo apt upgrade）
- 重启服务并验证：
- sudo systemctl restart filebeat
- filebeat version
- 如未获取到新版本，可能是未启用 Elastic 官方仓库，按下方“仓库设置”补齐后再次升级。
三 使用 DEB 包离线升级
- 下载对应架构的安装包（将 替换为目标版本）：
- wget https://artifacts.elastic.co/downloads/beats/filebeat/filebeat--linux-x86_64.deb
- 安装新包（会自动替换旧包）：
- sudo dpkg -i filebeat--linux-x86_64.deb
- 如遇依赖问题：sudo apt-get install -f
- 重启并验证：
- sudo systemctl restart filebeat
- filebeat version
四 仓库设置与版本系列选择
- 导入 GPG 密钥：
- wget -qO - https://artifacts.elastic.co/GPG-KEY-elasticsearch | sudo apt-key add -
- 添加 APT 源（示例为 7.x 系列，适用于 Ubuntu 20.04/22.04 等基于 Debian 的系统）：
- 新建文件：sudo nano /etc/apt/sources.list.d/filebeat.list
- 写入：deb https://artifacts.elastic.co/packages/7.x/apt stable main
- 更新索引并安装/升级：
- sudo apt update
- sudo apt install filebeat（已安装会自动升级）
- 如需 8.x，将仓库路径中的 7.x 替换为 8.x；注意跨大版本升级前先查阅兼容性说明。
五 升级后验证与回滚
- 功能与版本验证：
- 查看版本：filebeat version
- 查看状态：sudo systemctl status filebeat
- 查看日志：sudo journalctl -u filebeat -e --since “5m ago”
- 配置与模板：
- 若新版本引入配置项变更，按需调整 /etc/filebeat/filebeat.yml 并重新加载。
- 如使用 Elasticsearch Ingest Pipelines 或 Kibana Dashboards，建议按官方指引升级相关资产。
- 快速回滚（APT）：
- 降级到上一个版本：sudo apt install filebeat=<旧版本号>
- 重启：sudo systemctl restart filebeat
- 快速回滚（DEB）：
- 重新安装旧版 .deb：sudo dpkg -i filebeat-<旧版本号>-linux-x86_64.deb
- 重启：sudo systemctl restart filebeat。