我们将逐步展示如何通过 APT 包仓库方式，在 Ubuntu 上安装 OpenResty XRay 的 Agent 服务，从而自动分析和诊断系统中所有不同类型的应用和容器。

登录控制台

首先，登录账号。输入您的账号名称。

输入密码。

点击 “Sign in”。

点击 “Go to console”。它会带您进入 Agent 安装的向导页面。

通过 Deb 包安装 Agent

让我来展示如何通过 Deb 包进行安装。

首先，选择操作系统。这次的例子中选择的是 Ubuntu。

选择 Ubuntu 操作系统的版本号。

选择 “Network installation”，直接通过网络进行安装。

确保您的机器可以联网。

如果您的 curl 命令不可用，可以用这条命令安装它。

您也可以用这条命令将 ca-certificates 包升级到最新版本。

这是 Agent 的安装命令。

点击图标复制这条命令。

在终端上，粘贴刚才复制的内容。运行这条命令安装 OpenResty XRay 的 Agent。

这可能需要一些时间，具体取决于您的网络状况。请耐心等待。

Agent 的安装命令已经完成。回到 Web 控制台。

检查 Agent 状态和日志

这条命令可以检查 Agent 服务的运行状态。

点击复制它。

粘贴并运行这条命令检查 Agent 服务的状态。

可以看到 Agent 在正常运行。

也可以用这条命令检查错误日志。

复制它。

粘贴并运行这条命令来检查错误日志。

好极了！没有任何错误消息！让我们回到向导页面。

配置和检测应用

在非生产模式下，系统将采取更激进的分析方式，以便更快地获得结果。

生产模式用于分析线上生产环境，它会尽可能减少对目标应用和服务器性能的影响。不过这也意味着分析时间可能会更长。

偏执模式与生产模式类似，不过它会尝试进一步降低对目标服务器请求延时的性能影响。相应地，采样的时间会更久。

下面来自动检测目标系统中正在运行的应用和容器。

这些是自动检测到的目标应用。

如果要添加未检测到的新应用，可以配置自定义应用。

您可以在这里输入新应用的名称。

选择应用的类型。

您可以在这个进程列表中选择新应用对应的进程。

启动分析器和查看分析结果

点击这里开始运行分析器。

分析器已经开始运行。

点击 “Traffic and Load”。

系统检测到目标机器上有足够的流量和负载。只有目标应用有负载有流量时，我们的系统才能进行有意义的分析。

进入 dashboard 页面。

进入 “Insights” 页面。

等待第一份分析报告生成，因为第一个 Agent 刚刚完成安装。 “Insights” 页面里的分析报告是汇总所有 Agent 上的所有应用生成的。

您可以观察生成的实时进度。

可以看到，第一份全自动的分析报告已经生成好了！

未来会定期自动生成日报和周报。

切换到 “Dashboard” 页面。

可以看到各种不同类型应用的火焰图和其他图表，比如 Go、OpenResty 和 Python 等应用。

安装另一个 Agent

如果要安装另一个 Agent，只需点击这里。

这里使用的步骤和我们之前在 Ubuntu 上安装时的步骤相同。

如果需要在其他操作系统上安装，或者改用容器安装方式，可以点击这里。

回到了我们之前看到的向导页面，在这里可以选择不同的安装方式或操作系统。

如果你喜欢这个教程，请订阅这个博客网站和我们的 YouTube 频道 或 B 站频道。谢谢！

关于 OpenResty XRay

OpenResty XRay 是一个动态追踪产品，它可以自动分析运行中的应用，以解决性能问题、行为问题和安全漏洞，并提供可行的建议。在底层实现上，OpenResty XRay 由我们的 Y 语言驱动，可以在不同环境下支持多种不同的运行时，如 Stap+、eBPF+、GDB 和 ODB。

关于作者

章亦春是开源 OpenResty^® 项目创始人兼 OpenResty Inc. 公司 CEO 和创始人。

章亦春（Github ID: agentzh），生于中国江苏，现定居美国湾区。他是中国早期开源技术和文化的倡导者和领军人物，曾供职于多家国际知名的高科技企业，如 Cloudflare、雅虎、阿里巴巴, 是 “边缘计算“、”动态追踪 “和 “机器编程 “的先驱，拥有超过 22 年的编程及 16 年的开源经验。作为拥有超过 4000 万全球域名用户的开源项目的领导者。他基于其 OpenResty^® 开源项目打造的高科技企业 OpenResty Inc. 位于美国硅谷中心。其主打的两个产品 OpenResty XRay（利用动态追踪技术的非侵入式的故障剖析和排除工具）和 OpenResty Edge（最适合微服务和分布式流量的全能型网关软件），广受全球众多上市及大型企业青睐。在 OpenResty 以外，章亦春为多个开源项目贡献了累计超过百万行代码，其中包括，Linux 内核、Nginx、LuaJIT、GDB、SystemTap、LLVM、Perl 等，并编写过 60 多个开源软件库。

关注我们

如果您喜欢本文，欢迎关注我们 OpenResty Inc. 公司的博客网站 。也欢迎扫码关注我们的微信公众号：

翻译

我们提供了 英文版 原文和中译版（本文）。我们也欢迎读者提供其他语言的翻译版本，只要是全文翻译不带省略，我们都将会考虑采用，非常感谢！