使用适用于.NET 的 X-Ray SD AWS K 追踪 SDK 调用 - AWS X-Ray

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

使用适用于.NET 的 X-Ray SD AWS K 追踪 SDK 调用

当您的应用程序调用 AWS 服务 以存储数据、写入队列或发送通知时,X-Ray SDK for .NET 会按子分段跟踪下游的调用。在这些服务(例如,Amazon S3 存储桶或 Amazon SQS 队列)中跟踪的资源 AWS 服务 和访问的资源在 X-Ray 控制台的跟踪地图上显示为下游节点。

在创建 AWS SDK for .NET 客户RegisterXRayForAllServices之前,您可以通过致电来检测所有客户。

例 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 开发工具包会为一部分服务将信息添加到分段,从而在服务地图中提供更高的粒度。

例如,当使用经过检测的 DynamoDB 客户端发出调用时,对于针对表的调用,开发工具包会将表名称添加到分段中。在控制台中,每个表在服务地图中显示为一个独立的节点,以及没有表作为目标的调用的一般 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 - 队列名称