gala-gopher

介绍

gala-gopher是基于eBPF的低负载探针框架，致力于提供裸机/虚机/容器场景下的云原生观测引擎（cloud observation engine），帮助业务快速创新；

快速开始

基于rpm包安装运行

• yum源配置

  由于gala-gopher最新版本还没有正式发布，如果需要可以在OBS获取，OBS链接如下：

  openEuler-20.03-LTS : https://117.78.1.88/package/show/home:zpublic:branches:openEuler:20.03:LTS:SP1/gala-gopher-20.03lts
  openEuler-20.03-LTS-SP1 : https://117.78.1.88/package/show/home:zpublic:branches:openEuler:20.03:LTS:SP1/gala-gopher
  openEuler-22.03-LTS : https://117.78.1.88/package/show/home:zpublic:branches:openEuler:22.03:LTS:Next/gala-gopher
  EulerOS-V2R9C00 : https://117.78.1.88/package/show/home:zpublic:branches:openEuler:20.03:LTS:SP1/gala-gopher-v2r9

• rpm安装

  yum localinstall gala-gopher-v1.1.0-2.x86_64.rpm

  安装依赖包如下：librdkafka-devel 、libmicrohttpd-devel 、libconfig-devel 、uthash-devel 、

  ​ libbpf >= 0.3 、libbpf-devel

  上述依赖包在openEuler各个版本均有提供，如果EulerOS-V2R9缺包可以从openEuler-20.03-LTS源获取；

  三方探针依赖libbpf，现在22.03-LTS以下的版本中libbpf版本较低，可以在OBS获取libbpf v0.3版本，OBS链接如下：

  openEuler-20.03-LTS :
  https://117.78.1.88/package/show/home:zpublic:branches:openEuler:20.03:LTS/libbpf
  openEuler-20.03-LTS-SP1 :
  https://117.78.1.88/package/show/home:zpublic:branches:openEuler:20.03:LTS:SP1/libbpf

• 运行

  直接运行命令，

  gala-gopher

  或者通过 systemd 启动，

  systemctl start gala-gopher.service

基于源码编译、安装、运行

​ 建议在最低openEuler-20.03-LTS-SP1的环境执行编译动作，这是因为gala-gopher中ebpf探针编译依赖clang和llvm，大多数的bpf功能需要clang 10或者更高版本才可以正常工作，而20.03-SP1以下的发布版本中clang版本较低(低于10)。

• 安装依赖

  该步骤会检查安装架构感知框架所有的依赖包，涉及三方探针编译、运行的依赖包会在编译构建中检查安装。

  sh build.sh --check

• 构建

  sh build.sh --clean
  sh build.sh --release	# RELEASE模式
  # 或者
  sh build.sh --debug		# DEBUG模式

  注：在编译过程中出现如下信息，表示bpf探针编译需要的vmlinux.h文件缺失；

  

  ​ vmlinux.h文件包含了系统运行Linux内核源码中使用的所有类型定义，可以利用bpftool工具生成；我们已经预生成了几个LTS版本的vmlinux.h文件在src\probes\extends\ebpf.probe\src\include目录，请根据内核版本、CPU架构选择相应的文件，并手动软链接到vmlinux.h；例如：

  [root@master ~]# uname -r
  4.19.90-2012.5.0.0054.oe1.x86_64
  [root@master ~]# ln -s linux_4.19.90-2012.5.0.0053.oe1.x86_64.h vmlinux.h

  生成vmlinux.h文件后再次执行编译命令。

• 安装

  sh install.sh

• 运行

  gala-gopher

REST API使用

• 默认提供的REST API地址为：

  http://localhost:port

  其中port可以在配置文件gala-gopher.conf 中配置，默认配置为8888。

总体介绍

gala-gopher是基于eBPF的低负载探针框架，并集成了常用的native探针、知名中间件探针；gala-gopher有良好的扩展性，能方便的集成各种类型的探针程序，发挥社区的力量丰富探针框架的能力；gala-gopher中的几个主要部件：

• gala-gopher框架

  gala-gopher的基础框架，负责配置文件解析、native探针/三方探针的管理、探针数据收集管理、探针数据上报对接、集成测试等；

• native探针

  原生探针，主要是基于linux的proc文件系统收集的系统观测指标；

• 三方探针

  支持shell/java/python/c等不同语言的第三方探针程序，仅需满足轻量的数据上报格式即可集成到gala-gopher框架中；方便满足各种应用场景下的观测诉求；目前已实现知名中间件程序的探针观测及指标上报，如：lvs、nginx、haproxy、dnsmasq、dnsbind、kafka、rabbitmq等；

• 部署配置文件

  gala-gopher启动配置文件，可自定义具体使能的探针、指定数据上报的对接服务信息（kafka/promecheus等）

后续会详细针对各部件/关键流程展开介绍；

运行架构

探针开发构建流程

详细介绍

开发指南

开发指南

配置文件介绍

配置文件介绍

如何开发一个探针

如何开发一个探针

eBPF探针开发指南

eBPF探针开发指南

如何实现探针编译裁剪

如何实现探针编译裁剪

测试框架介绍

测试框架介绍

负载测试

使用示例

CDN视频直播环境部署运行架构感知

基于CDN简化场景部署架构感知服务做了拓扑绘制的效果演示如下。

gala-gopher路标