AWS DynamoDB 客户端操作的语义约定

状态: 开发中

AWS DynamoDB 的语义约定扩展并覆盖了通用的 AWS SDK 语义约定 和 数据库语义约定。

Span

表示对 AWS DynamoDB 调用而产生的 Span 遵循通用的 数据库客户端 Span 的语义约定。

DynamoDB.BatchGetItem

状态:

此 Span 代表一次 DynamoDB.BatchGetItem 调用。

db.system.name 必须设置为 "aws.dynamodb"，并且应在**创建 Span 时**提供。

**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.dynamodb.consumed_capacity		推荐	string[]	ConsumedCapacity 响应字段中每个项目的 JSON 序列化值。	["{ \"CapacityUnits\": number, \"GlobalSecondaryIndexes\": { \"string\" : { \"CapacityUnits\": number, \"ReadCapacityUnits\": number, \"WriteCapacityUnits\": number } }, \"LocalSecondaryIndexes\": { \"string\" : { \"CapacityUnits\": number, \"ReadCapacityUnits\": number, \"WriteCapacityUnits\": number } }, \"ReadCapacityUnits\": number, \"Table\": { \"CapacityUnits\": number, \"ReadCapacityUnits\": number, \"WriteCapacityUnits\": number }, \"TableName\": \"string\", \"WriteCapacityUnits\": number }"]
aws.dynamodb.table_names		推荐	string[]	RequestItems 对象字段中的键。	["Users", "Cats"]
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)

DynamoDB.BatchWriteItem

状态:

此 Span 代表一次 DynamoDB.BatchWriteItem 调用。

db.system.name 必须设置为 "aws.dynamodb"，并且应在**创建 Span 时**提供。

**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.dynamodb.consumed_capacity		推荐	string[]	ConsumedCapacity 响应字段中每个项目的 JSON 序列化值。	["{ \"CapacityUnits\": number, \"GlobalSecondaryIndexes\": { \"string\" : { \"CapacityUnits\": number, \"ReadCapacityUnits\": number, \"WriteCapacityUnits\": number } }, \"LocalSecondaryIndexes\": { \"string\" : { \"CapacityUnits\": number, \"ReadCapacityUnits\": number, \"WriteCapacityUnits\": number } }, \"ReadCapacityUnits\": number, \"Table\": { \"CapacityUnits\": number, \"ReadCapacityUnits\": number, \"WriteCapacityUnits\": number }, \"TableName\": \"string\", \"WriteCapacityUnits\": number }"]
aws.dynamodb.item_collection_metrics		推荐	字符串	ItemCollectionMetrics 响应字段的 JSON 序列化值。	{ "string" : [ { "ItemCollectionKey": { "string" : { "B": blob, "BOOL": boolean, "BS": [ blob ], "L": [ "AttributeValue" ], "M": { "string" : "AttributeValue" }, "N": "string", "NS": [ "string" ], "NULL": boolean, "S": "string", "SS": [ "string" ] } }, "SizeEstimateRangeGB": [ number ] } ] }
aws.dynamodb.table_names		推荐	string[]	RequestItems 对象字段中的键。	["Users", "Cats"]
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)

DynamoDB.CreateTable

状态:

此 Span 代表一次 DynamoDB.CreateTable 调用。

db.system.name 必须设置为 "aws.dynamodb"，并且应在**创建 Span 时**提供。

**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.dynamodb.consumed_capacity		推荐	string[]	ConsumedCapacity 响应字段中每个项目的 JSON 序列化值。	["{ \"CapacityUnits\": number, \"GlobalSecondaryIndexes\": { \"string\" : { \"CapacityUnits\": number, \"ReadCapacityUnits\": number, \"WriteCapacityUnits\": number } }, \"LocalSecondaryIndexes\": { \"string\" : { \"CapacityUnits\": number, \"ReadCapacityUnits\": number, \"WriteCapacityUnits\": number } }, \"ReadCapacityUnits\": number, \"Table\": { \"CapacityUnits\": number, \"ReadCapacityUnits\": number, \"WriteCapacityUnits\": number }, \"TableName\": \"string\", \"WriteCapacityUnits\": number }"]
aws.dynamodb.global_secondary_indexes		推荐	string[]	GlobalSecondaryIndexes 请求字段中每个项目的 JSON 序列化值。	["{ \"IndexName\": \"string\", \"KeySchema\": [ { \"AttributeName\": \"string\", \"KeyType\": \"string\" } ], \"Projection\": { \"NonKeyAttributes\": [ \"string\" ], \"ProjectionType\": \"string\" }, \"ProvisionedThroughput\": { \"ReadCapacityUnits\": number, \"WriteCapacityUnits\": number } }"]
aws.dynamodb.item_collection_metrics		推荐	字符串	ItemCollectionMetrics 响应字段的 JSON 序列化值。	{ "string" : [ { "ItemCollectionKey": { "string" : { "B": blob, "BOOL": boolean, "BS": [ blob ], "L": [ "AttributeValue" ], "M": { "string" : "AttributeValue" }, "N": "string", "NS": [ "string" ], "NULL": boolean, "S": "string", "SS": [ "string" ] } }, "SizeEstimateRangeGB": [ number ] } ] }
aws.dynamodb.local_secondary_indexes		推荐	string[]	LocalSecondaryIndexes 请求字段中每个项目的 JSON 序列化值。	["{ \"IndexArn\": \"string\", \"IndexName\": \"string\", \"IndexSizeBytes\": number, \"ItemCount\": number, \"KeySchema\": [ { \"AttributeName\": \"string\", \"KeyType\": \"string\" } ], \"Projection\": { \"NonKeyAttributes\": [ \"string\" ], \"ProjectionType\": \"string\" } }"]
aws.dynamodb.provisioned_read_capacity		推荐	double	ProvisionedThroughput.ReadCapacityUnits 请求参数的值。	1.0; 2.0
aws.dynamodb.provisioned_write_capacity		推荐	double	ProvisionedThroughput.WriteCapacityUnits 请求参数的值。	1.0; 2.0
aws.dynamodb.table_names		推荐	string[]	包含 TableName 请求参数值的单元素数组。	["Users"]
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)

DynamoDB.DeleteItem

状态:

此 Span 代表一次 DynamoDB.DeleteItem 调用。

db.system.name 必须设置为 "aws.dynamodb"，并且应在**创建 Span 时**提供。

**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.dynamodb.consumed_capacity		推荐	string[]	ConsumedCapacity 响应字段中每个项目的 JSON 序列化值。	["{ \"CapacityUnits\": number, \"GlobalSecondaryIndexes\": { \"string\" : { \"CapacityUnits\": number, \"ReadCapacityUnits\": number, \"WriteCapacityUnits\": number } }, \"LocalSecondaryIndexes\": { \"string\" : { \"CapacityUnits\": number, \"ReadCapacityUnits\": number, \"WriteCapacityUnits\": number } }, \"ReadCapacityUnits\": number, \"Table\": { \"CapacityUnits\": number, \"ReadCapacityUnits\": number, \"WriteCapacityUnits\": number }, \"TableName\": \"string\", \"WriteCapacityUnits\": number }"]
aws.dynamodb.item_collection_metrics		推荐	字符串	ItemCollectionMetrics 响应字段的 JSON 序列化值。	{ "string" : [ { "ItemCollectionKey": { "string" : { "B": blob, "BOOL": boolean, "BS": [ blob ], "L": [ "AttributeValue" ], "M": { "string" : "AttributeValue" }, "N": "string", "NS": [ "string" ], "NULL": boolean, "S": "string", "SS": [ "string" ] } }, "SizeEstimateRangeGB": [ number ] } ] }
aws.dynamodb.table_names		推荐	string[]	包含 TableName 请求参数值的单元素数组。	["Users"]
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)

DynamoDB.DeleteTable

状态:

此 Span 代表一次 DynamoDB.DeleteTable 调用。

db.system.name 必须设置为 "aws.dynamodb"，并且应在**创建 Span 时**提供。

**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.dynamodb.table_names		推荐	string[]	包含 TableName 请求参数值的单元素数组。	["Users"]
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)

DynamoDB.DescribeTable

状态:

此 Span 代表一次 DynamoDB.DescribeTable 调用。

db.system.name 必须设置为 "aws.dynamodb"，并且应在**创建 Span 时**提供。

**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.dynamodb.table_names		推荐	string[]	包含 TableName 请求参数值的单元素数组。	["Users"]
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)

DynamoDB.GetItem

状态:

此 Span 代表一次 DynamoDB.GetItem 调用。

db.system.name 必须设置为 "aws.dynamodb"，并且应在**创建 Span 时**提供。

**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.dynamodb.consistent_read		推荐	布尔值	ConsistentRead 请求参数的值。
aws.dynamodb.consumed_capacity		推荐	string[]	ConsumedCapacity 响应字段中每个项目的 JSON 序列化值。	["{ \"CapacityUnits\": number, \"GlobalSecondaryIndexes\": { \"string\" : { \"CapacityUnits\": number, \"ReadCapacityUnits\": number, \"WriteCapacityUnits\": number } }, \"LocalSecondaryIndexes\": { \"string\" : { \"CapacityUnits\": number, \"ReadCapacityUnits\": number, \"WriteCapacityUnits\": number } }, \"ReadCapacityUnits\": number, \"Table\": { \"CapacityUnits\": number, \"ReadCapacityUnits\": number, \"WriteCapacityUnits\": number }, \"TableName\": \"string\", \"WriteCapacityUnits\": number }"]
aws.dynamodb.projection		推荐	字符串	ProjectionExpression 请求参数的值。	Title; Title, Price, Color; Title, Description, RelatedItems, ProductReviews
aws.dynamodb.table_names		推荐	string[]	包含 TableName 请求参数值的单元素数组。	["Users"]
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)

DynamoDB.ListTables

状态:

此 Span 代表一次 DynamoDB.ListTables 调用。

db.system.name 必须设置为 "aws.dynamodb"，并且应在**创建 Span 时**提供。

**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.dynamodb.exclusive_start_table		推荐	字符串	ExclusiveStartTableName 请求参数的值。	Users; CatsTable
aws.dynamodb.limit		推荐	int	Limit 请求参数的值。	10
aws.dynamodb.table_count		推荐	int	TableNames 响应参数中的项目数量。	20
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)

DynamoDB.PutItem

状态:

此 Span 代表一次 DynamoDB.PutItem 调用。

db.system.name 必须设置为 "aws.dynamodb"，并且应在**创建 Span 时**提供。

**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.dynamodb.consumed_capacity		推荐	string[]	ConsumedCapacity 响应字段中每个项目的 JSON 序列化值。	["{ \"CapacityUnits\": number, \"GlobalSecondaryIndexes\": { \"string\" : { \"CapacityUnits\": number, \"ReadCapacityUnits\": number, \"WriteCapacityUnits\": number } }, \"LocalSecondaryIndexes\": { \"string\" : { \"CapacityUnits\": number, \"ReadCapacityUnits\": number, \"WriteCapacityUnits\": number } }, \"ReadCapacityUnits\": number, \"Table\": { \"CapacityUnits\": number, \"ReadCapacityUnits\": number, \"WriteCapacityUnits\": number }, \"TableName\": \"string\", \"WriteCapacityUnits\": number }"]
aws.dynamodb.item_collection_metrics		推荐	字符串	ItemCollectionMetrics 响应字段的 JSON 序列化值。	{ "string" : [ { "ItemCollectionKey": { "string" : { "B": blob, "BOOL": boolean, "BS": [ blob ], "L": [ "AttributeValue" ], "M": { "string" : "AttributeValue" }, "N": "string", "NS": [ "string" ], "NULL": boolean, "S": "string", "SS": [ "string" ] } }, "SizeEstimateRangeGB": [ number ] } ] }
aws.dynamodb.table_names		推荐	string[]	RequestItems 对象字段中的键。	["Users", "Cats"]
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)

DynamoDB.Query

状态:

此 Span 代表一次 DynamoDB.Query 调用。

db.system.name 必须设置为 "aws.dynamodb"，并且应在**创建 Span 时**提供。

**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.dynamodb.attributes_to_get		推荐	string[]	AttributesToGet 请求参数的值。	["lives", "id"]
aws.dynamodb.consistent_read		推荐	布尔值	ConsistentRead 请求参数的值。
aws.dynamodb.consumed_capacity		推荐	string[]	ConsumedCapacity 响应字段中每个项目的 JSON 序列化值。	["{ \"CapacityUnits\": number, \"GlobalSecondaryIndexes\": { \"string\" : { \"CapacityUnits\": number, \"ReadCapacityUnits\": number, \"WriteCapacityUnits\": number } }, \"LocalSecondaryIndexes\": { \"string\" : { \"CapacityUnits\": number, \"ReadCapacityUnits\": number, \"WriteCapacityUnits\": number } }, \"ReadCapacityUnits\": number, \"Table\": { \"CapacityUnits\": number, \"ReadCapacityUnits\": number, \"WriteCapacityUnits\": number }, \"TableName\": \"string\", \"WriteCapacityUnits\": number }"]
aws.dynamodb.index_name		推荐	字符串	IndexName 请求参数的值。	name_to_group
aws.dynamodb.limit		推荐	int	Limit 请求参数的值。	10
aws.dynamodb.projection		推荐	字符串	ProjectionExpression 请求参数的值。	Title; Title, Price, Color; Title, Description, RelatedItems, ProductReviews
aws.dynamodb.scan_forward		推荐	布尔值	ScanIndexForward 请求参数的值。
aws.dynamodb.select		推荐	字符串	Select 请求参数的值。	ALL_ATTRIBUTES; COUNT
aws.dynamodb.table_names		推荐	string[]	包含 TableName 请求参数值的单元素数组。	["Users"]
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)

DynamoDB.Scan

状态:

此 Span 代表一次 DynamoDB.Scan 调用。

db.system.name 必须设置为 "aws.dynamodb"，并且应在**创建 Span 时**提供。

**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.dynamodb.attributes_to_get		推荐	string[]	AttributesToGet 请求参数的值。	["lives", "id"]
aws.dynamodb.consistent_read		推荐	布尔值	ConsistentRead 请求参数的值。
aws.dynamodb.consumed_capacity		推荐	string[]	ConsumedCapacity 响应字段中每个项目的 JSON 序列化值。	["{ \"CapacityUnits\": number, \"GlobalSecondaryIndexes\": { \"string\" : { \"CapacityUnits\": number, \"ReadCapacityUnits\": number, \"WriteCapacityUnits\": number } }, \"LocalSecondaryIndexes\": { \"string\" : { \"CapacityUnits\": number, \"ReadCapacityUnits\": number, \"WriteCapacityUnits\": number } }, \"ReadCapacityUnits\": number, \"Table\": { \"CapacityUnits\": number, \"ReadCapacityUnits\": number, \"WriteCapacityUnits\": number }, \"TableName\": \"string\", \"WriteCapacityUnits\": number }"]
aws.dynamodb.count		推荐	int	Count 响应参数的值。	10
aws.dynamodb.index_name		推荐	字符串	IndexName 请求参数的值。	name_to_group
aws.dynamodb.limit		推荐	int	Limit 请求参数的值。	10
aws.dynamodb.projection		推荐	字符串	ProjectionExpression 请求参数的值。	Title; Title, Price, Color; Title, Description, RelatedItems, ProductReviews
aws.dynamodb.scanned_count		推荐	int	ScannedCount 响应参数的值。	50
aws.dynamodb.segment		推荐	int	Segment 请求参数的值。	10
aws.dynamodb.select		推荐	字符串	Select 请求参数的值。	ALL_ATTRIBUTES; COUNT
aws.dynamodb.table_names		推荐	string[]	包含 TableName 请求参数值的单元素数组。	["Users"]
aws.dynamodb.total_segments		推荐	int	TotalSegments 请求参数的值。	100
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)

DynamoDB.UpdateItem

状态:

此 Span 代表一次 DynamoDB.UpdateItem 调用。

db.system.name 必须设置为 "aws.dynamodb"，并且应在**创建 Span 时**提供。

**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.dynamodb.consumed_capacity		推荐	string[]	ConsumedCapacity 响应字段中每个项目的 JSON 序列化值。	["{ \"CapacityUnits\": number, \"GlobalSecondaryIndexes\": { \"string\" : { \"CapacityUnits\": number, \"ReadCapacityUnits\": number, \"WriteCapacityUnits\": number } }, \"LocalSecondaryIndexes\": { \"string\" : { \"CapacityUnits\": number, \"ReadCapacityUnits\": number, \"WriteCapacityUnits\": number } }, \"ReadCapacityUnits\": number, \"Table\": { \"CapacityUnits\": number, \"ReadCapacityUnits\": number, \"WriteCapacityUnits\": number }, \"TableName\": \"string\", \"WriteCapacityUnits\": number }"]
aws.dynamodb.item_collection_metrics		推荐	字符串	ItemCollectionMetrics 响应字段的 JSON 序列化值。	{ "string" : [ { "ItemCollectionKey": { "string" : { "B": blob, "BOOL": boolean, "BS": [ blob ], "L": [ "AttributeValue" ], "M": { "string" : "AttributeValue" }, "N": "string", "NS": [ "string" ], "NULL": boolean, "S": "string", "SS": [ "string" ] } }, "SizeEstimateRangeGB": [ number ] } ] }
aws.dynamodb.table_names		推荐	string[]	包含 TableName 请求参数值的单元素数组。	["Users"]
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)

DynamoDB.UpdateTable

状态:

此 Span 代表一次 DynamoDB.UpdateTable 调用。

db.system.name 必须设置为 "aws.dynamodb"，并且应在**创建 Span 时**提供。

**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.dynamodb.attribute_definitions		推荐	string[]	AttributeDefinitions 请求字段中每个项目的 JSON 序列化值。	["{ \"AttributeName\": \"string\", \"AttributeType\": \"string\" }"]
aws.dynamodb.consumed_capacity		推荐	string[]	ConsumedCapacity 响应字段中每个项目的 JSON 序列化值。	["{ \"CapacityUnits\": number, \"GlobalSecondaryIndexes\": { \"string\" : { \"CapacityUnits\": number, \"ReadCapacityUnits\": number, \"WriteCapacityUnits\": number } }, \"LocalSecondaryIndexes\": { \"string\" : { \"CapacityUnits\": number, \"ReadCapacityUnits\": number, \"WriteCapacityUnits\": number } }, \"ReadCapacityUnits\": number, \"Table\": { \"CapacityUnits\": number, \"ReadCapacityUnits\": number, \"WriteCapacityUnits\": number }, \"TableName\": \"string\", \"WriteCapacityUnits\": number }"]
aws.dynamodb.global_secondary_index_updates		推荐	string[]	GlobalSecondaryIndexUpdates 请求字段中每个项目的 JSON 序列化值。	["{ \"Create\": { \"IndexName\": \"string\", \"KeySchema\": [ { \"AttributeName\": \"string\", \"KeyType\": \"string\" } ], \"Projection\": { \"NonKeyAttributes\": [ \"string\" ], \"ProjectionType\": \"string\" }, \"ProvisionedThroughput\": { \"ReadCapacityUnits\": number, \"WriteCapacityUnits\": number } }"]
aws.dynamodb.provisioned_read_capacity		推荐	double	ProvisionedThroughput.ReadCapacityUnits 请求参数的值。	1.0; 2.0
aws.dynamodb.provisioned_write_capacity		推荐	double	ProvisionedThroughput.WriteCapacityUnits 请求参数的值。	1.0; 2.0
aws.dynamodb.table_names		推荐	string[]	包含 TableName 请求参数值的单元素数组。	["Users"]
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 DynamoDB 客户端的仪器化应根据通用的 数据库客户端指标的语义约定来收集指标。

db.system.name 必须设置为 "aws.dynamodb"。