AWS SDK Client Span 的语义约定
状态: 开发中
上下文传播
请参阅 兼容性。
AWS SDK Span
状态:
此 Span 描述了一次 AWS SDK 客户端调用。
Span 名称 必须符合 AWS HTTP API 的 Service.Operation 格式，例如 DynamoDB.GetItem、S3.ListBuckets。这等同于将 rpc.service 和 rpc.method 用 . 连接起来，并且与 RPC 客户端 Span 的命名指南一致。
AWS SDK Span 属性基于 AWS SDK API 调用中的请求或响应参数。这些约定是根据 AWS 用户对跟踪的反馈而随着时间的推移收集的，并且在发现新的有趣约定后会继续增加。
**Span 类型**应为 CLIENT。
**Span 状态**应遵循 记录错误文档。
Attributes
| 键 | Stability | 需求级别 | Value Type | 描述 | Example Values |
|---|---|---|---|---|---|
rpc.system |  | 必需 | 字符串 | 值 aws-api。 | aws-api |
aws.extended_request_id | | 有条件必需 如果可用。 | 字符串 | 在响应头 x-amz-id-2 中返回的 AWS 扩展请求 ID。 | wzHcyEWfmOGDIE5QOhTAqFDoDWP3y8IUvpNINCwL9N4TEHbUw0/gZJ+VZTmCNCWR7fezEN3eCiQ= |
aws.request_id | | 推荐 | 字符串 | 在响应头 x-amzn-requestid、x-amzn-request-id 或 x-amz-request-id 中返回的 AWS 请求 ID。 | 79b9da39-b7ae-508a-a6bc-864b2829c622; C9ER4AJX75574TDJ |
cloud.region | | 推荐 | 字符串 | 正在访问所请求服务的 AWS 区域。[1] | us-east-1; us-west-2 |
rpc.method | | 推荐 | 字符串 | 由 AWS SDK 返回的对应于请求的操作名称。 | GetItem; PutItem |
rpc.service | | 推荐 | 字符串 | 由 AWS SDK 返回的请求所目标的服务名称。 | DynamoDB; S3 |
[1] cloud.region: 指定 SDK 客户端针对给定 AWS 服务调用的 AWS 区域。该属性的值应遵循 AWS 文档中概述的 AWS 区域代码。
rpc.system 具有以下已知值列表。如果其中一个适用，则必须使用相应的值；否则，可以改用自定义值。
| 值 | 描述 | Stability |
|---|---|---|
apache_dubbo | Apache Dubbo | |
connect_rpc | Connect RPC | |
dotnet_wcf | .NET WCF | |
grpc | gRPC | |
java_rmi | Java RMI | |
jsonrpc | JSON-RPC | |
onc_rpc | ONC RPC (Sun RPC) | |
AWS 服务特定属性
以下语义约定扩展了通用的 AWS SDK 属性，以用于特定的 AWS 服务。
- AWS DynamoDB：AWS DynamoDB 的语义约定。
- AWS S3：AWS S3 的语义约定。
- AWS Bedrock：AWS Bedrock 的语义约定。
- AWS SNS：AWS SNS 的语义约定。
- AWS SQS：AWS SQS 的语义约定。