Grafana Beyla 开源项目教程

1. 项目介绍

Grafana Beyla 是一个基于 eBPF 技术的开源自动检测工具，旨在帮助用户轻松开始应用程序的可观测性。Beyla 通过 eBPF 自动检测应用程序的可执行文件和操作系统网络层，捕获 HTTP/S 和 gRPC 服务的关键可观测性事件。从这些捕获的 eBPF 事件中，Beyla 生成 OpenTelemetry 的 Web 事务跟踪跨度和 Rate-Errors-Duration (RED) 指标。与其他 eBPF 工具一样，所有数据捕获和检测过程都不需要修改应用程序代码或配置。

2. 项目快速启动

2.1 环境准备

• Linux 内核版本 5.8 或更高，且 BTF 已启用。
• eBPF 已启用。
• 对于 Go 程序，编译时使用的 Go 版本至少为 1.17。

2.2 下载并运行示例服务

首先，下载并运行一个示例 HTTP 服务：

curl -OL https://raw.githubusercontent.com/grafana/beyla/main/examples/example-http-service/example-http-service.go
go run ./example-http-service.go

2.3 生成一些流量

使用以下命令每两秒触发一次 GET 请求：

watch curl -s http://localhost:8080

2.4 下载并运行 Beyla

下载并解压最新版本的 Beyla：

curl -L https://github.com/grafana/beyla/releases/latest/download/beyla.tar.gz | tar xz

设置环境变量并运行 Beyla：

export BEYLA_PROMETHEUS_PORT=9400
export BEYLA_OPEN_PORT=8080
sudo -E ./beyla

现在，你应该可以在 http://localhost:9400/metrics 看到生成的指标。

3. 应用案例和最佳实践

3.1 在 Kubernetes 中使用 Beyla

在 Kubernetes 中，你可以通过 Sidecar 模式将 Beyla 与应用程序一起部署。以下是一个简单的示例：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: example-app
spec:
  replicas: 1
  selector:
    matchLabels:
      app: example-app
  template:
    metadata:
      labels:
        app: example-app
    spec:
      containers:
      - name: example-app
        image: your-example-app-image
      - name: beyla
        image: grafana/beyla:latest
        env:
        - name: BEYLA_PROMETHEUS_PORT
          value: "9400"
        - name: BEYLA_OPEN_PORT
          value: "8080"

3.2 最佳实践

• 权限管理：在生产环境中，确保 Beyla 以最小权限运行，避免使用 sudo。
• 监控与告警：结合 Grafana 和 Prometheus，设置监控和告警规则，及时发现和处理问题。

4. 典型生态项目

4.1 Grafana

Grafana 是一个开源的可视化和监控平台，支持多种数据源，包括 Prometheus、Loki、Tempo 等。Beyla 生成的指标和跟踪数据可以直接导入 Grafana 进行可视化和分析。

4.2 Prometheus

Prometheus 是一个开源的监控和告警工具，Beyla 生成的指标可以直接通过 Prometheus 进行收集和存储。

4.3 OpenTelemetry

OpenTelemetry 是一个开源的可观测性框架，Beyla 生成的跟踪数据符合 OpenTelemetry 标准，可以与其他 OpenTelemetry 工具无缝集成。

通过以上步骤，你可以快速上手并深入了解 Grafana Beyla 的使用和最佳实践。