关于driver插件

driver 插件对 内核模块 进行管理,并利用用户态数据进行补充、过滤,最终生成不同的系统事件,支撑相关告警功能。

运行时要求

支持主流的Linux发行版,包括CentOS、RHEL、Debian、Ubuntu、RockyLinux、OpenSUSE等。支持x86-64与aarch64架构。

主机的内核版本需要在支持的的列表中,如果不在,需要单独编译并上传,详见 说明

快速开始

通过 elkeidup 的完整部署,此插件默认开启。

手动编译

环境要求

确认相关配置

  • 需要确保 src/config.rsDOWNLOAD_HOSTS 变量已配置为实际部署的Nginx服务地址:
    • 如果是手动部署的Server:需要确保将其配置为Nginx文件服务的地址,例如:pub const DOWNLOAD_HOSTS: &'static [&'static str] = &["http://192.168.0.1:8080"];
    • 如果是通过 elkeidup 部署的Server,可以根据部署Server机器的 ~/.elkeidup/elkeidup_config.yaml 文件获得对应配置,具体配置项为 nginx.sshhost[0].host,并将端口号设置为8080,例如:pub const DOWNLOAD_HOSTS: &'static [&'static str] = &["http://192.168.0.1:8080"];

编译

在根目录,执行:

BUILD_VERSION=1.0.0.15 bash build.sh

在编译过程中,脚本会读取 BUILD_VERSION 环境变量设置版本信息,可根据实际需要进行修改。

编译成功后,在根目录的 output 目录下,应该可以看到2个plg文件,它们分别对应不同的系统架构。

版本升级

  1. 如果没有创建过客户端类型的组件,请在 Elkeid Console-组件管理 界面新建对应组件。
  2. Elkeid Console - 组件管理 界面,找到“collector”条目,点击右侧“发布版本”,填写版本信息并上传对应平台与架构的文件,点击确认。
  3. Elkeid Console - 组件策略 界面,(如有)删除旧的“collector”版本策略,点击“新建策略”,选中刚刚发布的版本,点击确认。后续新安装的Agent的插件均会自升级到最新版本。
  4. Elkeid Console - 任务管理 界面,点击“新建任务”,选择全部主机,点击下一步,选择“同步配置”任务类型,点击确认。随后,在此页面找到刚刚创建的任务,点击运行,即可对存量旧版本插件进行升级。

License

driver plugin is distributed under the Apache-2.0 license.