跟踪Amazon使用适用于 .NET 的 X-Ray 开发工具包调用 - Amazon X-Ray
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 Amazon Web Services 服务入门。

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

跟踪Amazon使用适用于 .NET 的 X-Ray 开发工具包调用

当您的应用程序调用Amazon服务来存储数据、写入队列或发送通知时，适用于 .NET 的 X-Ray 开发工具包会在子分段。跟踪的数据Amazon服务和您在这些服务中访问的资源（例如，Amazon S3 存储桶或 Amazon SQS 队列），在 X-Ray 控制台的服务地图上显示为下游节点。

您可以通过在创建前调用 RegisterXRayForAllServices 来检测所有Amazon 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;
    });

要分析客户端的某些服务而非其他服务，请调用RegisterXRayINSTEAD ODRegisterXRayForAllServices。使用服务客户端接口的名称替换突出显示的文本。 

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 Simple Storage Service— 存储桶和密钥名称

  • Amazon Simple Queue Service— 队列名称