本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 修补库以检测下游调用
修补库

**注意**  
X-Ray SDK/Daemon 维护通知 — 2026 年 2 月 25 日， Amazon X-Ray SDKs/Daemon 将进入维护模式，在该模式下，X-Ray SDK 和 Daemon 的发布 Amazon 将仅限于解决安全问题。有关支持时间表的更多信息，请参阅 [X-Ray SDK 和 Daemon Support 时间表](xray-sdk-daemon-timeline.md)。我们建议迁移到 OpenTelemetry。有关迁移到的更多信息 OpenTelemetry，请参阅[从 X-Ray 仪器迁移到 OpenTelemetry 仪器](https://docs.amazonaws.cn/xray/latest/devguide/xray-sdk-migration.html)。

要检测下游调用，请使用适用于 Ruby 的 X-Ray 开发工具包修补您的应用程序使用的库。适用于 Ruby 的 X-Ray 开发工具包可以修补以下库。

**支持的库**
+ `[net/http](https://ruby-doc.org/stdlib-2.4.2/libdoc/net/http/rdoc/Net/HTTP.html)` - 检测 HTTP 客户端。
+ `[aws-sdk](https://www.amazonaws.cn/sdk-for-ruby)`— 仪器 适用于 Ruby 的 Amazon SDK 客户。

如果您使用已修补的库，适用于 Ruby 的 X-Ray 开发工具包会为调用创建子分段，并记录请求和响应中的信息。必须通过开发工具包中间件或对 `XRay.recorder.begin_segment` 的调用提供分段，以供开发工具包创建子分段。

要修补库，请在您传递给 X-Ray 记录器的配置对象中指定这些库。

**Example main.rb - 修补库**  

```
require 'aws-xray-sdk'

config = {
  name: 'my app',
  patch: %I[net_http aws_sdk]
}

XRay.recorder.configure(config)
```