Ubuntu Filebeat如何更新和维护

Ubuntu 上 Filebeat 的更新与维护指南

一 更新前准备

• 备份关键数据与配置：配置文件默认位于**/etc/filebeat/filebeat.yml**，数据目录为**/var/lib/filebeat/，服务日志在/var/log/filebeat/**。建议先完整备份后再升级。示例：
  • 备份配置：sudo cp /etc/filebeat/filebeat.yml /etc/filebeat/filebeat.yml.bak
  • 备份数据：sudo cp -a /var/lib/filebeat /var/lib/filebeat.bak
  • 备份日志：sudo tar czf /root/filebeat-logs-$(date +%F).tar.gz -C /var/log/filebeat .
• 检查运行状态与版本：确认当前版本与运行状态，便于升级后对比验证。
  • 查看版本：filebeat version
  • 查看状态：sudo systemctl status filebeat
• 规划维护窗口：升级会重启进程，建议在业务低峰期进行，并提前告知相关方。

二 使用 APT 进行升级

• 更新索引与升级软件包：
  • 更新索引：sudo apt update
  • 仅升级 Filebeat：sudo apt install --only-upgrade filebeat
  • 或升级全部可升级包：sudo apt upgrade
• 重启并检查：
  • 重启服务：sudo systemctl restart filebeat
  • 验证版本：filebeat version
  • 查看状态：sudo systemctl status filebeat
• 回滚思路：如出现异常，可先停止服务，恢复备份配置与数据目录，再重启服务。
  • 停止：sudo systemctl stop filebeat
  • 恢复配置：sudo cp /etc/filebeat/filebeat.yml.bak /etc/filebeat/filebeat.yml
  • 恢复数据：sudo systemctl stop filebeat && sudo cp -a /var/lib/filebeat.bak /var/lib/filebeat && sudo systemctl start filebeat
• 跨小版本注意事项：若从 7.x 升级到 8.x，需同步检查仓库源是否为 8.x，并按新版要求调整配置后再启动。示例仓库配置（将 8.x 替换为目标版本）：
  • 导入 GPG：wget -qO - https://artifacts.elastic.co/GPG-KEY-elasticsearch | sudo apt-key add -
  • 写入源：echo “deb https://artifacts.elastic.co/packages/8.x/apt stable main” | sudo tee /etc/apt/sources.list.d/elastic-8.x.list
  • 更新索引并升级：sudo apt update && sudo apt install --only-upgrade filebeat

三 非 APT 方式升级

• 适用于从官方压缩包或其他方式安装的场景：
  • 下载并解压新版本（示例版本号替换为实际）：wget https://artifacts.elastic.co/downloads/beats/filebeat/filebeat--linux-x86_64.tar.gz && tar xzvf filebeat--linux-x86_64.tar.gz
  • 停止旧进程：sudo systemctl stop filebeat
  • 备份并替换二进制与配置（建议保留旧目录以便回滚）：sudo cp -a /usr/share/filebeat /usr/share/filebeat.bak && sudo rsync -a filebeat--linux-x86_64/ /usr/share/filebeat/
  • 按需合并配置变更，启动服务：sudo systemctl start filebeat
  • 验证：filebeat version 与 sudo systemctl status filebeat
  • 回滚：停止服务，恢复 /usr/share/filebeat 与 /etc/filebeat 备份后启动。

四 日常维护与巡检

• 配置与语法检查：修改配置后先本地校验，再重启。示例：sudo filebeat test config -e；必要时查看详细日志：tail -f /var/log/filebeat/filebeat.log
• 服务与版本巡检：例行检查服务是否运行、版本是否滞后。示例：sudo systemctl status filebeat；filebeat version
• 数据目录与磁盘空间：关注**/var/lib/filebeat**（registry 状态）与**/var/log/filebeat**增长，避免因磁盘占满导致采集停滞
• 升级后验证：确认新版本进程在运行、日志无异常、采集与输出链路（Elasticsearch/Logstash）正常