使用适用于 Go 的 X-Ray 软件开发工具包将注释和元数据 - Amazon X-Ray
使用适用于 Go 的 X-Ray 开发工具包用适用于 Go 的 X-Ray 开发工具包记录您可以使用适用于 Go 的 X-Ray 开发工具包
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

使用适用于 Go 的 X-Ray 软件开发工具包将注释和元数据

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

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

Metadata键值对可以具有任何类型的值（包括对象和列表达式）但不编制索引以便与筛选表达式一起使用。使用元数据记录要存储在跟踪中但不需要与搜索一起使用的其他数据。

除了注释和元数据之外，您还可以记录用户 ID 字符串在分段上。用户 ID 记录在分段的单独字段中，并且不会为其编制索引以用于搜索。

使用适用于 Go 的 X-Ray 开发工具包

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

注释要求

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

  • 值— 最多 1000 个 Unicode 字符。

  • Entries— 每个跟踪最多 50 个注释。

要记录注释，请使用一个包含您要与分段关联的元数据的字符串来调用 AddAnnotation。

xray.AddAnnotation(key string, value interface{})

开发工具包将注释记录为键值对annotations区段文档中的对象。使用相同键调用两次 AddAnnotation 将覆盖同一分段上之前记录的值。

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

用适用于 Go 的 X-Ray 开发工具包记录

使用元数据记录有关您无需为其编制索引以进行搜索的分段的信息。

要记录元数据，请使用一个包含您要与分段关联的元数据的字符串来调用 AddMetadata。

xray.AddMetadata(key string, value interface{})

您可以使用适用于 Go 的 X-Ray 开发工具包

记录请求分段上的用户 ID 以标识发送请求的用户。

记录用户 ID

  1. 从 AWSXRay 获取对当前分段的引用。

    import (
  "context"
  "github.com/aws/aws-xray-sdk-go/xray"
)

mySegment := xray.GetSegment(context)

  2. 使用发送请求的用户的字符串 ID 调用 setUser。

    mySegment.User = "U12345"

要查找用户 ID 的跟踪，请在user筛选表达式中使用 关键字。