Ubuntu 上升级 Filebeat 的推荐做法
一 使用 APT 原地升级(推荐)
- 备份配置与数据目录:
- sudo cp -r /etc/filebeat /etc/filebeat.bak
- sudo cp -r /var/lib/filebeat /var/lib/filebeat.bak
- 更新软件源并升级:
- sudo apt update
- sudo apt upgrade filebeat(或 sudo apt upgrade 升级全部)
- 重启服务并验证:
- sudo systemctl restart filebeat
- filebeat version
- sudo systemctl status filebeat
- 回滚方案(如出现问题):
- 先停止服务:sudo systemctl stop filebeat
- 恢复配置与数据:sudo cp -r /etc/filebeat.bak /etc/filebeat;sudo cp -r /var/lib/filebeat.bak /var/lib/filebeat
- 重启:sudo systemctl start filebeat
- 如需降级版本:sudo apt-get install filebeat=版本号(可先用 apt-cache policy filebeat 查看可用版本)
- 查看日志:sudo tail -f /var/log/filebeat/filebeat
二 手动安装或指定版本
- 适用于没有最新版本仓库、或需要离线安装/特定版本的场景。
- 操作步骤:
- 查看可用版本:sudo apt-cache policy filebeat
- 安装指定版本:sudo apt-get install filebeat=版本号
- 或到 Elastic 官方下载 .tar.gz,停止服务后解压替换二进制,按需更新符号链接并重启:
- wget https://artifacts.elastic.co/downloads/beats/filebeat/filebeat--linux-x86_64.tar.gz
- sudo systemctl stop filebeat
- sudo tar -xzf filebeat--linux-x86_64.tar.gz -C /opt/
- 可选:sudo update-alternatives --install /usr/bin/filebeat filebeat /opt/filebeat--linux-x86_64/bin/filebeat 10
- sudo systemctl start filebeat
- filebeat version && sudo systemctl status filebeat
三 升级前后注意事项
- 升级前务必备份 /etc/filebeat 与 /var/lib/filebeat,以便快速回滚。
- 升级后重启 filebeat 并检查状态与日志,确认无报错。
- 若使用 Elasticsearch 8.x,确认已配置正确的 APT 仓库地址与 GPG 密钥,否则可能拉取不到新版本或校验失败。
- 跨小版本/大版本升级时,留意官方变更说明;必要时分阶段升级并充分回归测试。