网络可观测性eBPF代理——安装与使用指南

网络可观测性eBPF代理——安装与使用指南

netobserv-ebpf-agent Network Observability eBPF Agent 项目地址: https://gitcode.com/gh_mirrors/ne/netobserv-ebpf-agent

1. 项目目录结构及介绍

网络可观测性eBPF代理（netobserv-netobserv-ebpf-agent）是一个强大的工具，用于在Linux主机上收集和聚合进出流量数据，要求内核版本至少为5.8，并启用了eBPF功能。下面是对该项目主要目录结构的概览：

• bpfbpf: 包含eBPF程序的C代码。
• cmd: 启动代理的主要命令行相关代码。
• deploymentsdeployments: 部署相关的文件，可能包括Kubernetes的YAML配置。
• docsdocs: 文档资料。
• examplesexamples: 示例配置或使用示例。
• hackhack: 开发辅助脚本。
• pkgpkg: 包装器和内部库代码。
• protoproto: Protobuf定义文件，用于数据序列化。
• scriptsscripts: 辅助脚本，如构建或部署流程中使用的。
• vendorvendor: 第三方依赖库。
• MakefileMakefile, LICENSELICENSE, OWNERSOWNERS, README.mdREADME.md: 核心构建文件、许可证、所有者信息和项目说明。

每个子目录都围绕着不同方面来组织，以便于管理和维护。

2. 项目的启动文件介绍

启动文件主要是由命令行界面(CLI)操作触发的。虽然直接运行可执行文件是测试或本地部署的简单方式，但通常情况下，代理是通过Kubernetes的DaemonSet由Network Observability Operator管理启动的。

直接运行示例:

export TARGET_HOST=<目标主机>  # 可选
export TARGET_PORT=<目标端口>  # 可选
sudo -E bin/netobserv-ebpf-agent

这展示了如何直接从命令行运行bin/netobserv-ebpf-agent二进制文件。请注意，某些环境下可能需要管理员权限和正确的环境变量设置。

3. 项目的配置文件介绍

eBPF代理不直接使用传统意义上的单一配置文件，而是通过环境变量进行配置。这意味着配置信息需在运行时通过环境变量设定。详细配置选项可以在项目的文档中找到，尤其是docs/docs/configuration.md（假设该路径存在）。例如，调整日志级别、指定监听地址等都是通过设置环境变量实现的。

对于更复杂的部署场景，比如在Kubernetes环境中，配置信息可以内嵌到Pod的定义文件中，通过env字段指定这些环境变量。

示例配置环境变量:

apiVersion: apps/v1
kind: DaemonSet
metadata:
  name: netobserv-ebpf-agent
spec:
  template:
    spec:
      containers:
        - name: netobserv-ebpf-agent
          image: quay.io/netobserv/netobserv-ebpf-agent:latest
          env:
            - name: TARGET_HOST
              value: "127.0.0.1"
            - name: OTHER_CONFIG_VARIABLE
              value: "configured_value"
          securityContext:
            runAsUser: 0
            capabilities:
              add:
                - BPF
                - PERFMON
                - NET_ADMIN
                - SYS_RESOURCE

此配置片段展示了一个在Kubernetes中运行代理的例子，其中包含了必要的安全上下文以满足运行需求，并设置了环境变量。

请注意，实际部署时应依据官方最新的文档调整上述配置，以确保兼容性和最佳实践。

netobserv-ebpf-agent Network Observability eBPF Agent 项目地址: https://gitcode.com/gh_mirrors/ne/netobserv-ebpf-agent