使用X-Ray SDK for .NET将注释和元数据添加到分段中 - AWS X-Ray
使用X-Ray SDK for .NET记录注释使用X-Ray SDK for .NET记录元数据
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 AWS 服务入门。

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

使用X-Ray SDK for .NET将注释和元数据添加到分段中

您可以记录有关请求、环境或具有注释和元数据的应用程序的其他信息。您可以向 X-Ray 开发工具包创建的分段或您创建的自定义子分段添加注释和元数据。

注释是带字符串、数字或布尔值的键值对。系统会对注释编制索引，以便与筛选表达式一起使用。使用注释记录要用于对控制台中的跟踪进行分组的数据或在调用 GetTraceSummaries API 时使用的数据。

元数据是可以拥有有任意类型值的密钥值对，包括对象和列表，但未编制索引以便与筛选表达式一同使用。使用元数据记录要存储在跟踪中但不需要用于搜索的其他数据。

使用X-Ray SDK for .NET记录注释

使用注释记录有关要为其编制索引以进行搜索的分段和子分段的信息。

注释要求

  • 密钥 – 最多 500 个字母数字字符。无空格或符号，下划线除外。

  • 值 – 最多 1,000 个 Unicode 字符。

  • 条目 – 每个跟踪最多 50 条注释。

记录注释

  1. 获取 AWSXRayRecorder 的实例。 

    using Amazon.XRay.Recorder.Core;
...
AWSXRayRecorder recorder = AWSXRayRecorder.Instance;

  2. 使用字符串键和布尔型、Int32、Int64、双精度或字符串值调用 addAnnotation。 

    recorder.AddAnnotation("mykey", "my value");

开发工具包将注释以键-值对的形式记录在分段文档的 annotations 对象中。使用相同键调用两次 addAnnotation 将覆盖同一分段或子分段上之前记录的值。

要查找具有带特定值的注释的跟踪，请在筛选条件表达式中使用 annotations.key 关键字。

使用X-Ray SDK for .NET记录元数据

使用元数据记录有关您无需为其编制索引以进行搜索的分段或子分段的信息。元数据值可以是字符串、数字、布尔值或可序列化为 JSON 对象或数组的任何其他对象。

记录元数据

  1. 获取 AWSXRayRecorder 的实例。 

    using Amazon.XRay.Recorder.Core;
...
AWSXRayRecorder recorder = AWSXRayRecorder.Instance;

  2. 使用字符串命名空间、字符串键和对象值调用 AddMetadata。 

    segment.AddMetadata("my namespace", "my key", "my value");

    或者

    调用仅带有键和值的 putMetadata。 

    segment.AddMetadata("my key", "my value");

如果您没有指定命名空间，则开发工具包将使用 default。使用相同键调用两次 AddMetadata 将覆盖同一分段或子分段上之前记录的值。