OpenResty XRay 需要以任何方式改变我的应用程序吗？

不需要。OpenResty XRay 使用动态追踪技术，不需要目标应用程序的任何配合，是 100% 非侵入的：不需要在应用程序中添加插件或模块，不需要给代码打补丁，不需要特殊的编译或启动选项（C/C++ 程序只需要标准的 -g 选项来生成 DWARF 调试符号），也不向应用程序进程注入任何代码。运行其分析器不会损害您的应用程序进程或使其崩溃，因为我们不会向进程添加任何东西。

OpenResty XRay 可以分析不在 OpenResty 上运行的应用程序吗？

可以。OpenResty XRay 是一个通用平台，可以分析任何您控制的软件（例如您可以访问其 DWARF 调试符号或源代码的软件）。目前它分析 OpenResty 和 Nginx 技术栈的效果最好。

OpenResty XRay 支持哪些应用和编程语言？

支持的编程语言与运行时：Python、Java、Rust、Perl、PHP、Erlang、Ruby、Go、LuaJIT 和 C/C++。支持的服务器与代理：OpenResty、Nginx、Envoy、Kong 和 CockroachDB。

如何为我的应用程序部署安装 OpenResty XRay？

在运行您的应用程序或容器的服务器上安装并运行 OpenResty XRay agent。agent 是一个独立的守护进程，可以检查同一服务器上的所有应用程序，同时作为 OpenResty XRay web 控制台的客户端。可以通过我们提供的 RPM 或 Deb 软件包仓库、包含全部软件包的 .tar.gz 包，或官方的 Docker 和 Kubernetes 容器镜像（通常以 DaemonSet 方式部署）来安装。请不要把 agent 安装在您自己的应用容器里：容器通常缺乏检查其他进程和容器所需的权限和文件系统访问权。

OpenResty XRay agent 的开销多大？

agent 使用事件触发的采样方法，只在真正需要时才收集数据。不采样时，对您的进程产生的额外开销严格为 0。即使在采样时，大多数分析器的开销也小于应用的 5%；对于在 web 控制台中标记为“生产”的服务器，系统还会自动调整开销较大的分析器的频率和进程范围，以尽量减少影响。

安装 agent 后，我需要重新启动我的进程吗？

不需要。动态追踪支持事后分析：新安装的 agent 可以直接分析您的应用程序和任何现有进程，无需重启，因为它不需要新的插件、新的启动选项，也不向应用程序注入代码。当某个进程进入了重启就会消失的罕见状态时，这一点尤为重要。

agent 需要安装 C 编译器工具链吗？

不需要。与 SystemTap 或 eBPF /BCC 等开源动态追踪框架不同，OpenResty XRay 不要求在目标机器上安装 gcc、clang 或任何 C/C++ 编译器工具链，也不需要安装 Linux 内核头文件。它还支持较旧的内核，例如 CentOS 7 的 3.10 内核。

我需要在我所有的服务器上安装调试符号包吗？

不需要。OpenResty XRay 会把发现的所有调试符号索引到一个远程的软件包数据库中；每当 agent 发现一个二进制可执行文件，就会自动查询对应的 DWARF 数据。我们运行爬虫程序持续索引公共软件包的调试符号，每个租户也都有自己独立的软件包数据库来索引自己的二进制文件。对于自己编译的软件，只需让 agent 在一台安装了二进制文件和调试符号的机器上运行一段时间，之后所有机器上都不再需要调试符号。