线上监控 Rust 应用中的程序异常（使用 OpenResty XRay）
内容提要
本教程介绍了OpenResty XRay在线分析Rust应用中的程序异常，包括被捕获的异常。使用引导式分析功能，可以查看不同类型的问题并生成分析报告。OpenResty XRay是一个动态追踪产品，解决性能、行为和安全问题，并提供建议。
延伸解读
被捕获的异常也能被追踪
文章强调，OpenResty XRay 能检测 Rust 在线进程中的代码异常，包括那些被应用自身捕获、不会导致进程崩溃的异常。示例中 stat_client_usage 函数因数组下标越界触发 panic_bounds_check，但异常被捕获，应用并未崩溃，XRay 仍实时追踪到。这说明该工具不仅关注致命崩溃，也能发现被掩盖的潜在缺陷。
从火焰图到源码的定位链路
分析报告自动生成 Rust 语言级别的异常火焰图，并推导出抛出异常最多的热代码路径。报告中的 PanicInfo 结构体提供异常位置信息，用户可复制源文件路径并跳转到具体行号。示例中定位到 stat_client_usage 函数第 7 行，数组下标 client_id 可能超出 CLIENTS 大小，形成从宏观火焰图到微观源码的完整排查链路。
引导式分析与自动报告的分工
文章介绍了两种使用方式：Guided Analysis 适合开发与演示，用户手动选择应用、设置分析时间并启动多轮分析；Insights 页面则提供以日和周为周期的自动监控报告。两者互补，前者灵活可控，后者适合持续观察在线进程。分析过程对性能影响被尽量减小，因此适用于对性能和延迟敏感的生产环境。
Q&A
OpenResty XRay 能分析 Rust 应用中的哪些异常？
OpenResty XRay 能够检测和分析 Rust 在线进程中的代码异常，包括那些不会导致进程崩溃的被捕获的异常（panic）。
如何使用 OpenResty XRay 的引导式分析功能分析 Rust 程序异常？
在 Web 控制台进入 Guided Analysis 页面，选择 Errors & exceptions，点击 Next，选择目标 Rust 应用和 Whole application，语言级别选 Rust，设置最长分析时间（默认 300 秒），开始分析，系统会执行多轮分析并自动生成报告。
OpenResty XRay 生成的分析报告展示了什么内容？
报告展示了抛出最多 Rust 程序异常的代码路径，包括 internal_constructor、panic_fmt、panic_bounds_check 等函数，并附有对问题的详细解释和建议，如指出异常由范围边界访问失败引起。
OpenResty XRay 如何帮助定位 Rust 代码中的数组越界问题？
通过异常火焰图自动推导出热代码路径，报告中会显示 panic_bounds_check 函数，并给出源文件路径和行号（如第 7 行），提示数组下标 client_id 可能超出数组 CLIENTS 的大小，从而定位越界访问。
除了手动引导分析，OpenResty XRay 还能自动监控并生成报告吗？
可以。OpenResty XRay 能自动监控在线进程，并在 Insights 页面生成以日和周为周期的自动分析报告，无需使用 Guided Analysis 功能。
OpenResty XRay 是什么产品？它主要解决哪些问题？
OpenResty XRay 是一个动态追踪产品，可以自动分析运行中的应用，以解决性能问题、行为问题和安全漏洞，并提供可行的建议。它由 Y 语言驱动，支持多种运行时如 Stap+、eBPF+、GDB 和 ODB。
