使用 X-Ray SDK 進行的 X-Ray SDK 來追蹤對下游 HTTP Web 服務進行的呼叫

當您的應用程式呼叫微服務或公有 HTTP API 時，您可以使用 X-Ray SDK 進行的 X-Ray SDKGetResponseTraced的延伸方法System.Net.HttpWebRequest來檢測這些呼叫，並將 API 做為下游服務新增到服務圖表。

範例 HttpWebRequest

using System.Net;
using Amazon.XRay.Recorder.Core;
using Amazon.XRay.Recorder.Handlers.System.Net;

private void MakeHttpRequest()
{
  HttpWebRequest request = (HttpWebRequest)WebRequest.Create("http://names.example.com/api");
  request.GetResponseTraced();
}

針對非同步呼叫，請使用 GetAsyncResponseTraced。

request.GetAsyncResponseTraced();

若您使用 system.net.http.httpclient，請使用 HttpClientXRayTracingHandler 委派處理常式來記錄呼叫。

範例 HttpClient

using System.Net.Http;
using Amazon.XRay.Recorder.Core;
using Amazon.XRay.Recorder.Handlers.System.Net;

private void MakeHttpRequest()
{
  var httpClient = new HttpClient(new HttpClientXRayTracingHandler(new HttpClientHandler()));
  httpClient.GetAsync(URL);
}

當您檢測對下游 Web API 進行的呼叫時，The X-Ray SDK for .NET 的 X-Ray SDK) 會記錄附帶 HTTP 請求和回應相關資訊。X-Ray 會使用子區段來產生 API 的推論區段。

範例 下游 HTTP 呼叫的子區段

{
  "id": "004f72be19cddc2a",
  "start_time": 1484786387.131,
  "end_time": 1484786387.501,
  "name": "names.example.com",
  "namespace": "remote",
  "http": {
    "request": {
      "method": "GET",
      "url": "https://names.example.com/"
    },
    "response": {
      "content_length": -1,
      "status": 200
    }
  }
}

範例 下游 HTTP 呼叫的推斷區段

{
  "id": "168416dc2ea97781",
  "name": "names.example.com",
  "trace_id": "1-62be1272-1b71c4274f39f122afa64eab",
  "start_time": 1484786387.131,
  "end_time": 1484786387.501,
  "parent_id": "004f72be19cddc2a",
  "http": {
    "request": {
      "method": "GET",
      "url": "https://names.example.com/"
    },
    "response": {
      "content_length": -1,
      "status": 200
    }
  },
  "inferred": true
}