本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 修補程式庫來檢測下游呼叫
<a name="xray-sdk-ruby-patching"></a>

**注意**  
X-Ray 開發套件/協助程式維護通知 – 在 2026 年 2 月 25 日， AWS X-Ray SDKs/協助程式將進入維護模式，其中 AWS 將限制 X-Ray 開發套件和協助程式版本，以僅解決安全問題。如需支援時間軸的詳細資訊，請參閱 [X-Ray SDK 和協助程式支援時間表](xray-sdk-daemon-timeline.md)。建議您遷移至 OpenTelemetry。如需遷移至 OpenTelemetry 的詳細資訊，請參閱[從 X-Ray 檢測遷移至 OpenTelemetry 檢測](https://docs.aws.amazon.com/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://aws.amazon.com/sdk-for-ruby)` – 檢測 適用於 Ruby 的 AWS 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)
```