opentelemetry-instrumentation-aws_sdk 0.12.0 → 0.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: be010ebe132208c78615f1de510817a27f8bad82db753cd6092683719b20ca8d
-  data.tar.gz: bd3a3cdc8c469a5f01dca2ec8c1a03e39ce030551bdf18219383c326aeedb33d
+  metadata.gz: 36475ac9d78a7aac349f55baeb62c15571fb1d4e641590178f92e3d4a7cdd1b0
+  data.tar.gz: 23f73c8044945ed782e9a10eb442f62e3f08661e91512dac617d7447a911927c
 SHA512:
-  metadata.gz: b1028f438e8708df4263060aa1776324893fc0c662efac4f58bb856ed4ed88523d1786dab1a9c40c5c04d8b918ba15946494f13fee0491d192ad77b4a5be4860
-  data.tar.gz: 2a7e7fe7b990e18518b451209c085097abdabfc6c09d996218c5064b05659bb2bc2404d60e534397624abbcd951756e21f60dc13f3ad7f92d122066a3cda1e4b
+  metadata.gz: 25c729e17716e933aebaed2d8fcf9fcb8b1841bf921b05bd1bdde464cd3e18acd55e4a72ffe1d554bdf47fc29bdb5b8acd673a2dc2735809a3d8f30dbf0b848c
+  data.tar.gz: a4b2a20ac429ee78c1b175a8366327168fd84e795f2c16751b986beea26748f4f83ff1477f498b16e4d899987f17530e8d2b5e5b70f7e946a49534143fa4f2e1

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Release History: opentelemetry-instrumentation-aws_sdk
 
+## v0.13.0 / 2026-08-18
+
+- ADDED: Add `OTEL_SEMCONV_STABILITY_OPT_IN` environment variable support for aws-sdk-dynamodb (#2135)
+
 ## v0.12.0 / 2026-04-14
 
 - BREAKING CHANGE: Min Ruby Version 3.3 (#2125)

data/README.md

@@ -82,6 +82,20 @@ The `opentelemetry-instrumentation-aws_sdk` gem source is [on github][repo-githu
 
 The OpenTelemetry Ruby gems are maintained by the OpenTelemetry Ruby special interest group (SIG). You can get involved by joining us on our [GitHub Discussions][discussions-url], [Slack Channel][slack-channel] or attending our weekly meeting. See the [meeting calendar][community-meetings] for dates and times. For more information on this and other language SIGs, see the OpenTelemetry [community page][ruby-sig].
 
+## Database semantic convention stability
+
+In the OpenTelemetry ecosystem, database semantic conventions have now reached a stable state. However, the initial aws-sdk instrumentation was introduced before this stability was achieved, which resulted in database attributes being based on an older version of the semantic conventions.
+
+To facilitate the migration to stable semantic conventions, you can use the `OTEL_SEMCONV_STABILITY_OPT_IN` environment variable. This variable allows you to opt-in to the new stable conventions, ensuring compatibility and future-proofing your instrumentation.
+
+When setting the value for `OTEL_SEMCONV_STABILITY_OPT_IN`, you can specify which conventions you wish to adopt:
+
+- `database` - Emits the stable database and networking conventions and ceases emitting the old conventions previously emitted by the instrumentation.
+- `database/dup` - Emits both the old and stable database and networking conventions, enabling a phased rollout of the stable semantic conventions.
+- Default behavior (in the absence of either value) is to continue emitting the old database and networking conventions the instrumentation previously emitted.
+
+For additional information on migration, please refer to our [documentation](https://opentelemetry.io/docs/specs/semconv/non-normative/db-migration/).
+
 ## License
 
 Apache 2.0 license. See [LICENSE][license-github] for more information.

data/lib/opentelemetry/instrumentation/aws_sdk/handler_helper.rb

@@ -32,7 +32,7 @@ module OpenTelemetry
               OpenTelemetry::SemanticConventions::Trace::RPC_SYSTEM => 'aws-api'
             }.tap do |attrs|
               attrs[OpenTelemetry::SemanticConventions::Trace::CODE_NAMESPACE] = 'Aws::Plugins::AwsSdk' if legacy
-              attrs[SemanticConventions::Trace::DB_SYSTEM] = 'dynamodb' if service_id == 'DynamoDB'
+              apply_dynamodb_attributes(attrs, context) if service_id == 'DynamoDB'
 
               MessagingHelper.apply_span_attributes(context, attrs, client_method, service_id) if MessagingHelper::SUPPORTED_SERVICES.include?(service_id)
             end
@@ -72,6 +72,25 @@ module OpenTelemetry
 
           private
 
+          def apply_dynamodb_attributes(attrs, context)
+            semconv_mode = OpenTelemetry::Instrumentation::AwsSdk::Instrumentation.instance.semconv_mode
+            table_name = context.params[:table_name]
+
+            case semconv_mode
+            when :stable
+              attrs['db.system.name'] = 'aws.dynamodb'
+              attrs['db.operation.name'] = context.operation.name
+              attrs['db.collection.name'] = table_name if table_name
+            when :dup
+              attrs[SemanticConventions::Trace::DB_SYSTEM] = 'dynamodb'
+              attrs['db.system.name'] = 'aws.dynamodb'
+              attrs['db.operation.name'] = context.operation.name
+              attrs['db.collection.name'] = table_name if table_name
+            else # :old (default)
+              attrs[SemanticConventions::Trace::DB_SYSTEM] = 'dynamodb'
+            end
+          end
+
           def legacy_service_id(context)
             # Support aws-sdk v2.0.x, which 'metadata' has a setter method only
             return context.client.class.to_s.split('::')[1] if ::Seahorse::Model::Api.instance_method(:metadata).parameters.length.positive?

data/lib/opentelemetry/instrumentation/aws_sdk/instrumentation.rb

@@ -67,6 +67,21 @@ module OpenTelemetry
           end
         end
 
+        # Returns the semconv mode based on OTEL_SEMCONV_STABILITY_OPT_IN env var
+        # @return [Symbol] :old, :stable, or :dup
+        def semconv_mode
+          @semconv_mode ||= begin
+            opt_in = ENV.fetch('OTEL_SEMCONV_STABILITY_OPT_IN', '')
+            if opt_in.include?('database/dup')
+              :dup
+            elsif opt_in.include?('database')
+              :stable
+            else
+              :old
+            end
+          end
+        end
+
         private
 
         def resolve_config(config)

data/lib/opentelemetry/instrumentation/aws_sdk/version.rb

@@ -7,7 +7,7 @@
 module OpenTelemetry
   module Instrumentation
     module AwsSdk
-      VERSION = '0.12.0'
+      VERSION = '0.13.0'
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: opentelemetry-instrumentation-aws_sdk
 version: !ruby/object:Gem::Version
-  version: 0.12.0
+  version: 0.13.0
 platform: ruby
 authors:
 - OpenTelemetry Authors
@@ -48,10 +48,10 @@ homepage: https://github.com/open-telemetry/opentelemetry-ruby-contrib
 licenses:
 - Apache-2.0
 metadata:
-  changelog_uri: https://rubydoc.info/gems/opentelemetry-instrumentation-aws_sdk/0.12.0/file/CHANGELOG.md
-  source_code_uri: https://github.com/open-telemetry/opentelemetry-ruby-contrib/tree/opentelemetry-instrumentation-aws_sdk/v0.12.0/instrumentation/aws_sdk
+  changelog_uri: https://rubydoc.info/gems/opentelemetry-instrumentation-aws_sdk/0.13.0/file/CHANGELOG.md
+  source_code_uri: https://github.com/open-telemetry/opentelemetry-ruby-contrib/tree/opentelemetry-instrumentation-aws_sdk/v0.13.0/instrumentation/aws_sdk
   bug_tracker_uri: https://github.com/open-telemetry/opentelemetry-ruby-contrib/issues
-  documentation_uri: https://rubydoc.info/gems/opentelemetry-instrumentation-aws_sdk/0.12.0
+  documentation_uri: https://rubydoc.info/gems/opentelemetry-instrumentation-aws_sdk/0.13.0
 rdoc_options: []
 require_paths:
 - lib
@@ -66,7 +66,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.6
+rubygems_version: 4.0.16
 specification_version: 4
 summary: AWS SDK instrumentation for the OpenTelemetry framework
 test_files: []