Witty-Insight未来展望：路线图规划与社区贡献指南

Witty-Insight未来展望：路线图规划与社区贡献指南

【免费下载链接】witty-insightThe witty-insight is an eBPF-based observability framework for tracing agent execution pipelines.项目地址: https://gitcode.com/openeuler/witty-insight

前往项目官网免费下载：https://ar.openeuler.org/ar/

Witty-Insight是一个基于eBPF的可观测性框架，专注于追踪代理执行管道。作为openEuler生态中的重要项目，它通过高效的eBPF探针和数据分析能力，为用户提供深入的系统运行时观测体验。本文将详细介绍Witty-Insight的未来发展路线图以及如何参与社区贡献，帮助新手和普通用户更好地了解和参与到项目中来。

一、项目核心功能与技术架构 🌟

Witty-Insight采用模块化设计，主要包含以下核心组件：

• eBPF探针模块：位于src/bpf/目录，包含多种eBPF程序如filewatch.bpf.c、procmon.bpf.c等，用于高效采集系统事件
• 协议解析模块：在src/parser/中实现，支持HTTP、HTTP2、SSE等多种协议解析
• 事件聚合与分析：通过src/aggregator/和src/analyzer/处理和分析采集到的数据
• 数据存储：src/storage/目录下实现了SQLite持久化方案
• API服务：src/server/提供HTTP API接口，方便外部系统访问

项目整体架构如图所示（项目结构）：

witty-insight/ ├── src/ │ ├── bpf/ # eBPF C 程序 │ ├── probes/ # 探针管理 │ ├── parser/ # 协议解析 │ ├── aggregator/ # 事件聚合 │ ├── analyzer/ # 数据分析 │ ├── genai/ # GenAI 语义层 │ ├── storage/ # SQLite 持久化 │ ├── discovery/ # Agent 发现 │ ├── health/ # 健康检查 │ ├── tokenizer/ # Token 计数 │ ├── atif/ # ATIF 轨迹导出 │ ├── server/ # HTTP API 服务器 │ ├── bin/ # CLI 入口 │ ├── config.rs # 统一配置 │ └── unified.rs # 主编排器 ├── scripts/ # 启动脚本与 systemd 文件 ├── docs/ # 架构与开发文档 └── agentsight.json # 示例配置

二、未来发展路线图 🚀

2.1 短期目标（3-6个月）

Witty-Insight团队计划在短期内重点关注以下几个方面：

1. 性能优化：进一步提升eBPF探针的性能，减少系统开销，优化src/probes/目录下的探针实现
2. 协议支持扩展：增强协议解析能力，特别是针对AI代理相关的协议
3. 用户体验改进：简化部署流程，完善scripts/agentsight-start.sh启动脚本
4. 文档完善：扩充docs/目录下的文档，提供更详细的使用和开发指南

2.2 中期计划（6-12个月）

在中期发展阶段，项目将聚焦于：

1. 多平台支持：扩展对不同Linux发行版的支持，不仅仅局限于openEuler
2. 可视化能力：开发轻量级Web界面，方便用户直观查看观测数据
3. 告警机制：实现基于规则的告警功能，及时发现系统异常
4. 插件系统：设计灵活的插件机制，允许社区贡献者扩展功能

2.3 长期愿景（1年以上）

Witty-Insight的长期目标是成为：

1. AI代理观测标准：成为AI代理执行管道观测的行业标准框架
2. 云原生集成：深度集成云原生生态，支持Kubernetes环境下的部署和管理
3. 机器学习增强：利用机器学习技术，实现异常检测和性能预测
4. 跨平台支持：扩展到更多操作系统平台，不仅仅局限于Linux

三、社区贡献指南 🤝

3.1 贡献方式

Witty-Insight欢迎各种形式的贡献，包括但不限于：

• 代码贡献：修复bug、实现新功能、优化性能
• 文档完善：改进现有文档、编写教程和使用指南
• 测试验证：测试新功能，报告bug
• 社区支持：在社区论坛帮助其他用户

3.2 开发环境搭建

要开始贡献代码，首先需要搭建开发环境。以下是基本步骤：

1. 克隆仓库

   git clone https://gitcode.com/openeuler/witty-insight cd witty-insight

2. 安装依赖（以CentOS/Alinux为例）

   yum install -y clang llvm elfutils-libelf-devel libbpf-devel zlib-devel pkg-config

3. 安装Rust环境确保Rust版本>=1.80，可以使用rustup安装和管理Rust版本。

4. 构建项目

   cargo build --release # 或使用Makefile make build

3.3 开发流程

Witty-Insight的开发流程遵循标准的Git工作流：

1. ** Fork仓库**：在GitCode上Fork项目到自己的账号
2. 创建分支：从main分支创建特性分支，建议使用feature/xxx或bugfix/xxx命名
3. 开发代码：实现功能或修复bug，遵循项目代码规范
4. 运行测试：确保所有测试通过

   cargo test

5. 提交PR：将更改提交到自己的Fork仓库，然后创建Pull Request到主仓库

3.4 代码规范

为了保持代码质量和一致性，贡献者需要遵循以下规范：

• Rust代码：

  • 遵循标准rustfmt格式：cargo fmt
  • 使用clippy检查：cargo clippy -- -D warnings
  • 错误处理使用anyhow::Result
  • 模块组织：每个模块有mod.rs、unified.rs和对应子模块

• C代码（主要是eBPF程序）：

  • 遵循Linux内核代码风格
  • 使用适当的注释说明功能和复杂逻辑

3.5 提交规范

提交信息应清晰明了，建议遵循以下格式：

[组件名] 简短描述（不超过50字符） 详细描述，解释这次提交解决了什么问题，如何解决的，等等。 可以分多行。 相关Issue: #123

例如：

[probes] 优化procmon探针性能 减少了不必要的内核空间到用户空间的数据拷贝， 提高了高负载情况下的性能。 相关Issue: #45

四、参与社区交流 🗣️

Witty-Insight社区欢迎所有感兴趣的开发者参与交流：

• 邮件列表：可以通过openEuler邮件列表参与讨论
• Issue跟踪：在项目仓库的Issue中报告bug或提出功能建议
• 代码审查：参与Pull Request的审查，提供建设性意见

五、开始贡献的简单任务 🚩

如果你是首次参与贡献，可以从以下简单任务开始：

1. 文档改进：发现文档中的错误或不完善之处，提交修改
2. 单元测试：为现有功能添加单元测试，提高代码覆盖率
3. bug修复：查看Issue列表中标记为"good first issue"的任务
4. 代码优化：改进现有代码的可读性或性能

六、总结

Witty-Insight作为基于eBPF的可观测性框架，具有广阔的应用前景和发展空间。通过本文介绍的路线图，我们可以看到项目未来的发展方向；而社区贡献指南则为希望参与项目的开发者提供了清晰的入门路径。

无论你是经验丰富的开发者还是刚入门的新手，都可以在Witty-Insight社区中找到适合自己的贡献方式。我们期待你的加入，一起推动项目的发展，为openEuler生态系统贡献力量！ 💪

【免费下载链接】witty-insightThe witty-insight is an eBPF-based observability framework for tracing agent execution pipelines.项目地址: https://gitcode.com/openeuler/witty-insight