Skip to main content

Linux eBPF 安装

概述

ebpf-agent 是一个基于 eBPF 内核技术的采集服务，用于采集系统和应用的 metrics、logs 数据，并将采集到的数据发送到 light-agent。

系统要求

前置条件

Lighthouse 平台版本 ≥ 1.8.0

Linux 内核版本 ≥ 4.16

# 查看内核版本
uname -r
# 或
cat /proc/version

已安装 light-agent（需要在同一台机器上）
已禁用 SELinux：sudo setenforce 0

特殊说明

如果要监控 Kubernetes 集群中的服务，需要额外安装 kube-state-metrics

安装步骤

1. 配置环境变量

必需配置

LOGS_ENDPOINT：日志上报地址
- 默认地址：127.0.0.1（light-agent 所在机器）
- 默认端口：54318
```
export LOGS_ENDPOINT=http://127.0.0.1:54318/v1/logs
```
PROFILES_ENDPOINT：性能分析数据上报地址
- 将 <Lighthouse IP> 替换为 Lighthouse 平台的实际 IP 地址
- 默认端口：8085
```
export PROFILES_ENDPOINT=http://<Lighthouse IP>:8085/profiling/v1/ebpfinput
```

可选配置

WAL_DIR：数据存储路径
```
export WAL_DIR=/tmp/ebpf-agent
```
SCRAPE_INTERVAL：数据采集间隔
```
export SCRAPE_INTERVAL=15s
```

数据传输说明

eBPF Agent 仅支持通过 HTTP 协议使用 OTEL 格式导出数据

2. 执行安装

cd /usr/local/light-agent/ebpf-agent
./ebpf-agent-install.sh

服务管理

查看服务状态

systemctl status ebpf-agent

查看服务日志

# 查看全部日志
journalctl -u ebpf-agent

# 实时查看日志
journalctl -u ebpf-agent -f

常用操作命令

# 启动服务
systemctl start ebpf-agent

# 停止服务
systemctl stop ebpf-agent

# 重启服务
systemctl restart ebpf-agent

卸载服务

/usr/local/light-agent/ebpf-agent/ebpf-agent-uninstall.sh

配置修改

修改环境变量

查看当前配置：

cat /etc/systemd/system/ebpf-agent.service.env

修改配置：

vi /etc/systemd/system/ebpf-agent.service.env

重启服务使配置生效：

systemctl restart ebpf-agent

环境变量说明

环境变量	默认值	说明
COLLECTOR_ENDPOINT	`http://0.0.0.0:4318`	数据采集基础端点
METRICS_ENDPOINT	`http://0.0.0.0:4318/v1/metrics`	指标数据端点
LOGS_ENDPOINT	`http://0.0.0.0:4318/v1/logs`	日志数据端点
PROFILES_ENDPOINT	-	性能分析数据端点
SCRAPE_INTERVAL	`15s`	数据采集间隔
DISABLE_LOG_PARSING	`false`	是否禁用容器日志解析
WAL_DIR	`/tmp/ebpf-agent`	数据存储路径

相关阅读

核心功能：基础设施监控

概述
系统要求
安装步骤
- 1. 配置环境变量
- 2. 执行安装
服务管理
配置修改
环境变量说明
相关阅读