使用適用於 .NET 的 X-Ray AWS SDK 追蹤 SDK 呼叫 - AWS X-Ray

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

使用適用於 .NET 的 X-Ray AWS SDK 追蹤 SDK 呼叫

當您的應用程式呼叫 AWS 服務 以儲存資料、寫入佇列或傳送通知時，.NET 的 X-Ray SDK 會追蹤子區段中下游的呼叫。您在這些服務中存取的追蹤 AWS 服務 和資源 (例如，Amazon S3 儲存貯體或 Amazon SQS 佇列) 會在 X-Ray 主控台的追蹤對應上顯示為下游節點。

您可以在創建RegisterXRayForAllServices之前通過致電來檢測所有 AWS SDK for .NET 客戶。

範例 SampleController.cs-DynamoDB 端儀器
using Amazon;
using Amazon.Util;
using Amazon.DynamoDBv2;
using Amazon.DynamoDBv2.DocumentModel;
using Amazon.XRay.Recorder.Core;
using Amazon.XRay.Recorder.Handlers.AwsSdk;

namespace SampleEBWebApplication.Controllers
{
  public class SampleController : ApiController
  {
    AWSSDKHandler.RegisterXRayForAllServices();
    private static readonly Lazy<AmazonDynamoDBClient> LazyDdbClient = new Lazy<AmazonDynamoDBClient>(() =>
    {
      var client = new AmazonDynamoDBClient(EC2InstanceMetadata.Region ?? RegionEndpoint.USEast1);
      return client;
    });

若要針對某些特定服務檢測用戶端，請呼叫 RegisterXRay，而不是 RegisterXRayForAllServices。將醒目提示的文字取代為服務的用戶端界面名稱。

AWSSDKHandler.RegisterXRay<IAmazonDynamoDB>()

對於所有服務，您都可以在 X-Ray 控制台中看到調用的 API 的名稱。對於服務子集，X-Ray SDK 會將資訊新增至區段，以在服務對應中提供更多精細度。

例如，當您使用已檢測的 DynamoDB 用戶端進行呼叫時，SDK 會將資料表名稱新增至區段，以便針對以資料表為目標的呼叫。在主控台中，每個表格在服務對應中顯示為獨立節點，其中包含一般 DynamoDB 節點，用於未針對資料表的呼叫。

範例 呼叫 DynamoDB 以儲存項目的子區段
{
  "id": "24756640c0d0978a",
  "start_time": 1.480305974194E9,
  "end_time": 1.4803059742E9,
  "name": "DynamoDB",
  "namespace": "aws",
  "http": {
    "response": {
      "content_length": 60,
      "status": 200
    }
  },
  "aws": {
    "table_name": "scorekeep-user",
    "operation": "UpdateItem",
    "request_id": "UBQNSO5AEM8T4FDA4RQDEB94OVTDRVV4K4HIRGVJF66Q9ASUAAJG",
  }
}

您存取具名資源時，對以下服務的呼叫會在服務地圖中建立額外節點。未針對特定資源的呼叫，則會建立服務的一般節點。

  • Amazon DynamoDB — 表名

  • Amazon 簡單存儲服務 — 存儲桶和密鑰名稱

  • Amazon 簡單隊列服務-隊列名稱