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的可观测性框架，用于追踪代理执行管道。在使用过程中，用户可能会遇到各种问题，本文将详细介绍常见故障的诊断方法和解决方案，帮助您快速恢复系统正常运行。

一、eBPF探针相关问题

1.1Failed to create probes错误

当您看到Failed to create probes错误时，通常是由于内核不支持BTF（BPF Type Format）导致的。BTF是eBPF程序与内核交互的重要格式，缺少它会导致探针创建失败。

解决方案：检查系统是否存在/sys/kernel/btf/vmlinux文件。如果该文件不存在，您需要升级内核到支持BTF的版本，或者重新编译内核并启用BTF支持。

1.2Failed to attach probes错误

Failed to attach probes错误一般是由于权限不足引起的。eBPF程序需要特殊权限才能附加到内核函数上。

解决方案：有两种方法可以解决权限问题：

• 使用sudo命令以root权限运行程序
• 使用setcap cap_bpf,cap_perfmon=ep命令为可执行文件设置必要的 capabilities

二、配置相关问题

2.1Failed to load config错误

Failed to load config错误表示程序无法加载配置文件，最常见的原因是配置路径不正确。

解决方案：显式传入--config参数指定配置文件路径，并确保该JSON文件具有可读权限。例如：

./witty-insight --config /path/to/your/config.json

三、依赖相关问题

3.1Tokenizer not found错误

Tokenizer not found错误说明系统中缺少必要的tokenizer组件，这通常是由于未下载tokenizer导致的。

解决方案：您可以通过两种方式解决此问题：

• 设置AGENTSIGHT_TOKENIZER_PATH环境变量，指向已下载的tokenizer目录
• 运行程序时添加自动下载tokenizer的参数，让程序自行获取所需组件

四、故障排查工具与方法

虽然项目中没有提供专门的故障排查脚本，但您可以使用系统自带的工具来辅助诊断问题。例如，使用dmesg命令查看内核日志，使用strace跟踪系统调用，这些都有助于定位问题根源。

此外，您可以参考项目文档中的开发指南docs/DEVELOPMENT.md，其中包含了更多关于项目构建和运行的详细信息。

五、获取帮助

如果您遇到的问题不在本文档范围内，或者尝试上述解决方案后问题仍然存在，建议您查看项目的官方文档或提交issue寻求帮助。在提交issue时，请尽量提供详细的错误信息、系统环境和复现步骤，以便开发人员能够快速定位并解决问题。

通过本文档介绍的方法，大多数常见问题都可以得到解决。Witty-Insight作为基于eBPF的可观测性框架，其故障排查过程可能涉及内核和系统底层知识，希望本文能为您提供有效的指导。

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