AWS

General AWS Attributes

This document defines generic attributes for AWS services.

AttributeTypeDescriptionExamplesStability
aws.request_idstringThe AWS request ID as returned in the response headers x-amz-request-id or x-amz-requestid.79b9da39-b7ae-508a-a6bc-864b2829c622; C9ER4AJX75574TDJExperimental

Amazon DynamoDB Attributes

This document defines attributes for AWS DynamoDB.

AttributeTypeDescriptionExamplesStability
aws.dynamodb.attribute_definitionsstring[]The JSON-serialized value of each item in the AttributeDefinitions request field.["{ \"AttributeName\": \"string\", \"AttributeType\": \"string\" }"]Experimental
aws.dynamodb.attributes_to_getstring[]The value of the AttributesToGet request parameter.["lives", "id"]Experimental
aws.dynamodb.consistent_readbooleanThe value of the ConsistentRead request parameter.Experimental
aws.dynamodb.consumed_capacitystring[]The JSON-serialized value of each item in the ConsumedCapacity response field.["{ \"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 }"]Experimental
aws.dynamodb.countintThe value of the Count response parameter.10Experimental
aws.dynamodb.exclusive_start_tablestringThe value of the ExclusiveStartTableName request parameter.Users; CatsTableExperimental
aws.dynamodb.global_secondary_index_updatesstring[]The JSON-serialized value of each item in the GlobalSecondaryIndexUpdates request field.["{ \"Create\": { \"IndexName\": \"string\", \"KeySchema\": [ { \"AttributeName\": \"string\", \"KeyType\": \"string\" } ], \"Projection\": { \"NonKeyAttributes\": [ \"string\" ], \"ProjectionType\": \"string\" }, \"ProvisionedThroughput\": { \"ReadCapacityUnits\": number, \"WriteCapacityUnits\": number } }"]Experimental
aws.dynamodb.global_secondary_indexesstring[]The JSON-serialized value of each item of the GlobalSecondaryIndexes request field["{ \"IndexName\": \"string\", \"KeySchema\": [ { \"AttributeName\": \"string\", \"KeyType\": \"string\" } ], \"Projection\": { \"NonKeyAttributes\": [ \"string\" ], \"ProjectionType\": \"string\" }, \"ProvisionedThroughput\": { \"ReadCapacityUnits\": number, \"WriteCapacityUnits\": number } }"]Experimental
aws.dynamodb.index_namestringThe value of the IndexName request parameter.name_to_groupExperimental
aws.dynamodb.item_collection_metricsstringThe JSON-serialized value of the ItemCollectionMetrics response field.{ "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 ] } ] }Experimental
aws.dynamodb.limitintThe value of the Limit request parameter.10Experimental
aws.dynamodb.local_secondary_indexesstring[]The JSON-serialized value of each item of the LocalSecondaryIndexes request field.["{ \"IndexArn\": \"string\", \"IndexName\": \"string\", \"IndexSizeBytes\": number, \"ItemCount\": number, \"KeySchema\": [ { \"AttributeName\": \"string\", \"KeyType\": \"string\" } ], \"Projection\": { \"NonKeyAttributes\": [ \"string\" ], \"ProjectionType\": \"string\" } }"]Experimental
aws.dynamodb.projectionstringThe value of the ProjectionExpression request parameter.Title; Title, Price, Color; Title, Description, RelatedItems, ProductReviewsExperimental
aws.dynamodb.provisioned_read_capacitydoubleThe value of the ProvisionedThroughput.ReadCapacityUnits request parameter.1.0; 2.0Experimental
aws.dynamodb.provisioned_write_capacitydoubleThe value of the ProvisionedThroughput.WriteCapacityUnits request parameter.1.0; 2.0Experimental
aws.dynamodb.scan_forwardbooleanThe value of the ScanIndexForward request parameter.Experimental
aws.dynamodb.scanned_countintThe value of the ScannedCount response parameter.50Experimental
aws.dynamodb.segmentintThe value of the Segment request parameter.10Experimental
aws.dynamodb.selectstringThe value of the Select request parameter.ALL_ATTRIBUTES; COUNTExperimental
aws.dynamodb.table_countintThe number of items in the TableNames response parameter.20Experimental
aws.dynamodb.table_namesstring[]The keys in the RequestItems object field.["Users", "Cats"]Experimental
aws.dynamodb.total_segmentsintThe value of the TotalSegments request parameter.100Experimental

Amazon ECS Attributes

This document defines attributes for AWS Elastic Container Service (ECS).

AttributeTypeDescriptionExamplesStability
aws.ecs.cluster.arnstringThe ARN of an ECS cluster.arn:aws:ecs:us-west-2:123456789123:cluster/my-clusterExperimental
aws.ecs.container.arnstringThe Amazon Resource Name (ARN) of an ECS container instance.arn:aws:ecs:us-west-1:123456789123:container/32624152-9086-4f0e-acae-1a75b14fe4d9Experimental
aws.ecs.launchtypestringThe launch type for an ECS task.ec2; fargateExperimental
aws.ecs.task.arnstringThe ARN of a running ECS task.arn:aws:ecs:us-west-1:123456789123:task/10838bed-421f-43ef-870a-f43feacbbb5b; arn:aws:ecs:us-west-1:123456789123:task/my-cluster/task-id/23ebb8ac-c18f-46c6-8bbe-d55d0e37cfbdExperimental
aws.ecs.task.familystringThe family name of the ECS task definition used to create the ECS task.opentelemetry-familyExperimental
aws.ecs.task.idstringThe ID of a running ECS task. The ID MUST be extracted from task.arn.10838bed-421f-43ef-870a-f43feacbbb5b; 23ebb8ac-c18f-46c6-8bbe-d55d0e37cfbdExperimental
aws.ecs.task.revisionstringThe revision for the task definition used to create the ECS task.8; 26Experimental

aws.ecs.launchtype has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.

ValueDescriptionStability
ec2ec2Experimental
fargatefargateExperimental

Amazon EKS Attributes

This document defines attributes for AWS Elastic Kubernetes Service (EKS).

AttributeTypeDescriptionExamplesStability
aws.eks.cluster.arnstringThe ARN of an EKS cluster.arn:aws:ecs:us-west-2:123456789123:cluster/my-clusterExperimental

Amazon Lambda Attributes

This document defines attributes for AWS Lambda.

AttributeTypeDescriptionExamplesStability
aws.lambda.invoked_arnstringThe full invoked ARN as provided on the Context passed to the function (Lambda-Runtime-Invoked-Function-Arn header on the /runtime/invocation/next applicable). [1]arn:aws:lambda:us-east-1:123456:function:myfunction:myaliasExperimental

[1]: This may be different from cloud.resource_id if an alias is involved.

Amazon Logs Attributes

This document defines attributes for AWS Logs.

AttributeTypeDescriptionExamplesStability
aws.log.group.arnsstring[]The Amazon Resource Name(s) (ARN) of the AWS log group(s). [2]["arn:aws:logs:us-west-1:123456789012:log-group:/aws/my/group:*"]Experimental
aws.log.group.namesstring[]The name(s) of the AWS log group(s) an application is writing to. [3]["/aws/lambda/my-function", "opentelemetry-service"]Experimental
aws.log.stream.arnsstring[]The ARN(s) of the AWS log stream(s). [4]["arn:aws:logs:us-west-1:123456789012:log-group:/aws/my/group:log-stream:logs/main/10838bed-421f-43ef-870a-f43feacbbb5b"]Experimental
aws.log.stream.namesstring[]The name(s) of the AWS log stream(s) an application is writing to.["logs/main/10838bed-421f-43ef-870a-f43feacbbb5b"]Experimental

[2]: See the log group ARN format documentation.

[3]: Multiple log groups must be supported for cases like multi-container applications, where a single application has sidecar containers, and each write to their own log group.

[4]: See the log stream ARN format documentation. One log group can contain several log streams, so these ARNs necessarily identify both a log group and a log stream.

Amazon S3 Attributes

This document defines attributes for AWS S3.

AttributeTypeDescriptionExamplesStability
aws.s3.bucketstringThe S3 bucket name the request refers to. Corresponds to the --bucket parameter of the S3 API operations. [5]some-bucket-nameExperimental
aws.s3.copy_sourcestringThe source object (in the form bucket/key) for the copy operation. [6]someFile.ymlExperimental
aws.s3.deletestringThe delete request container that specifies the objects to be deleted. [7]Objects=[{Key=string,VersionId=string},{Key=string,VersionId=string}],Quiet=booleanExperimental
aws.s3.keystringThe S3 object key the request refers to. Corresponds to the --key parameter of the S3 API operations. [8]someFile.ymlExperimental
aws.s3.part_numberintThe part number of the part being uploaded in a multipart-upload operation. This is a positive integer between 1 and 10,000. [9]3456Experimental
aws.s3.upload_idstringUpload ID that identifies the multipart upload. [10]dfRtDYWFbkRONycy.Yxwh66Yjlx.cph0gtNBtJExperimental

[5]: The bucket attribute is applicable to all S3 operations that reference a bucket, i.e. that require the bucket name as a mandatory parameter. This applies to almost all S3 operations except list-buckets.

[6]: The copy_source attribute applies to S3 copy operations and corresponds to the --copy-source parameter of the copy-object operation within the S3 API. This applies in particular to the following operations:

[7]: The delete attribute is only applicable to the delete-object operation. The delete attribute corresponds to the --delete parameter of the delete-objects operation within the S3 API.

[8]: The key attribute is applicable to all object-related S3 operations, i.e. that require the object key as a mandatory parameter. This applies in particular to the following operations:

[9]: The part_number attribute is only applicable to the upload-part and upload-part-copy operations. The part_number attribute corresponds to the --part-number parameter of the upload-part operation within the S3 API.

[10]: The upload_id attribute applies to S3 multipart-upload operations and corresponds to the --upload-id parameter of the S3 API multipart operations. This applies in particular to the following operations: