opentelemetry-exporter-otlp-common 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 625997900149fe6e2fc8fa92e781e1d7b4b548dad2cffdd1b115f2a4682be05e
-  data.tar.gz: 425f30d92374ce17154c13b9309d64f7ab7e748b0ff45c68afd3960272bf6ddb
+  metadata.gz: fc61abf6f06d4f015bbac4b02d92ba48882d9b1893f120dead8e1eba6b9265f8
+  data.tar.gz: 9a96e3ee82f013270d5f4883b44e760023141556aeebfb29b989cb716218983f
 SHA512:
-  metadata.gz: 3d2f766eb9eb534f8f57e699411cc35fe0ad815fda84ecd8deff5fda6365f8fa22059bc3f64636c22822d487a3d8d639f1daf9b0eb1db2e440344161a03b36d9
-  data.tar.gz: d125e2d11cc0ae911c777b862e0182f03262a8254ba5bdccc1f3a8c89470ebada75c1c85209b79aefad85c663b95f6fbca7cfb98e91b78fd58648419c1d3ee54
+  metadata.gz: e558088072666371f19014f89e2913f6c22dd6112285905dc4768896ca82425e4646072e1a7e950abd27a0cb92907ad50013384345e81a024a59d9a540c144ac
+  data.tar.gz: 12993bec531fd7a0f00c2b2fd0bde9badc76fe4e8c8d046e0b8f44ac29187d103e7344c9ad067a5ed00c55fd0002e1dc09b85e30cc5475efe28432b632a2c1ad

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Release History: opentelemetry-exporter-otlp-common
 
+### v0.3.0 / 2026-09-29
+
+* ADDED: Move otlp exporter uri builder to common (#2240)
+* FIXED: Normalize UTF-8 attribute strings (#2259)
+
 ### v0.2.0 / 2026-09-03
 
 * ADDED: Support InstrumentationScope, and update OTLP proto to 0.18.0 (#1345)

data/lib/opentelemetry/exporter/otlp/common/utilities.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+# Copyright The OpenTelemetry Authors
+#
+# SPDX-License-Identifier: Apache-2.0
+
+require 'opentelemetry/common'
+
+module OpenTelemetry
+  module Exporter
+    module OTLP
+      module Common
+        # Contains common utilities used by the otlp exporters
+        module Utilities
+          extend self
+
+          # Builds a url using the endpoint defined and if not present uses the configured sources
+          def build_uri(endpoint, path = '', primary_src = '', secondary_src = 'OTEL_EXPORTER_OTLP_ENDPOINT', default = 'http://localhost:4318/')
+            endpoint ||= ENV.fetch(primary_src, nil)
+            raise ArgumentError, "invalid url for OTLPExporter #{endpoint} set via #{primary_src}" unless endpoint.nil? || OpenTelemetry::Common::Utilities.valid_url?(endpoint)
+
+            if endpoint.nil?
+              endpoint = ENV.fetch(secondary_src, default)
+              raise ArgumentError, "invalid url for OTLPExporter #{endpoint} set via #{secondary_src}" unless OpenTelemetry::Common::Utilities.valid_url?(endpoint)
+
+              endpoint += '/' unless endpoint.end_with?('/')
+              URI.join(endpoint, path)
+            else
+              URI(endpoint)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/opentelemetry/exporter/otlp/common/version.rb

@@ -9,7 +9,7 @@ module OpenTelemetry
     module OTLP
       module Common
         ## Current OpenTelemetry OTLP exporter common version
-        VERSION = '0.2.0'
+        VERSION = '0.3.0'
       end
     end
   end

data/lib/opentelemetry/exporter/otlp/common.rb

@@ -5,6 +5,8 @@
 # SPDX-License-Identifier: Apache-2.0
 
 require 'opentelemetry'
+require 'opentelemetry/common'
+require 'opentelemetry/exporter/otlp/common/utilities'
 require 'opentelemetry/exporter/otlp/common/version'
 
 require 'google/rpc/status_pb'
@@ -70,7 +72,7 @@ module OpenTelemetry
 
         private
 
-        def as_otlp_span(span_data)
+        def as_otlp_span(span_data) # rubocop:disable Metrics/MethodLength
           Opentelemetry::Proto::Trace::V1::Span.new(
             trace_id: span_data.trace_id,
             span_id: span_data.span_id,
@@ -96,8 +98,9 @@ module OpenTelemetry
                 trace_id: link.span_context.trace_id,
                 span_id: link.span_context.span_id,
                 trace_state: link.span_context.tracestate.to_s,
-                attributes: link.attributes&.map { |k, v| as_otlp_key_value(k, v) }
+                attributes: link.attributes&.map { |k, v| as_otlp_key_value(k, v) },
                 # TODO: track dropped_attributes_count in Span#trim_links
+                flags: build_span_flags(link.span_context.remote?, link.span_context.trace_flags)
               )
             end,
             dropped_links_count: span_data.total_recorded_links - span_data.links&.size.to_i,
@@ -106,10 +109,31 @@ module OpenTelemetry
                 code: as_otlp_status_code(status.code),
                 message: status.description
               )
-            end
+            end,
+            flags: build_span_flags(span_data.parent_span_is_remote, span_data.trace_flags)
           )
         end
 
+        # Builds span flags based on whether the parent span context is remote.
+        # This follows the OTLP specification for span flags.
+        def build_span_flags(parent_span_is_remote, base_flags)
+          # Extract integer value from TraceFlags object if needed
+          # Derive the low 8-bit W3C trace flags using the public API.
+          base_flags_int =
+            if base_flags.sampled?
+              1
+            else
+              0
+            end
+
+          has_remote_mask = Opentelemetry::Proto::Trace::V1::SpanFlags::SPAN_FLAGS_CONTEXT_HAS_IS_REMOTE_MASK
+          is_remote_mask = Opentelemetry::Proto::Trace::V1::SpanFlags::SPAN_FLAGS_CONTEXT_IS_REMOTE_MASK
+
+          flags = base_flags_int | has_remote_mask
+          flags |= is_remote_mask if parent_span_is_remote
+          flags
+        end
+
         def as_otlp_status_code(code)
           case code
           when OpenTelemetry::Trace::Status::OK then Opentelemetry::Proto::Trace::V1::Status::StatusCode::STATUS_CODE_OK
@@ -130,9 +154,10 @@ module OpenTelemetry
         end
 
         def as_otlp_key_value(key, value)
+          key = OpenTelemetry::Common::Utilities.utf8_encode(key, placeholder: 'Encoding Error')
           Opentelemetry::Proto::Common::V1::KeyValue.new(key: key, value: as_otlp_any_value(value))
         rescue Encoding::UndefinedConversionError => e
-          encoded_value = value.encode('UTF-8', invalid: :replace, undef: :replace, replace: '�')
+          encoded_value = value.to_s.encode('UTF-8', invalid: :replace, undef: :replace, replace: '�')
           OpenTelemetry.handle_error(exception: e, message: "encoding error for key #{key} and value #{encoded_value}")
           Opentelemetry::Proto::Common::V1::KeyValue.new(key: key, value: as_otlp_any_value('Encoding Error'))
         end
@@ -141,7 +166,7 @@ module OpenTelemetry
           result = Opentelemetry::Proto::Common::V1::AnyValue.new
           case value
           when String
-            result.string_value = value
+            result.string_value = OpenTelemetry::Common::Utilities.utf8_encode(value, placeholder: value)
           when Integer
             result.int_value = value
           when Float

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: opentelemetry-exporter-otlp-common
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - OpenTelemetry Authors
@@ -51,6 +51,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.1'
+- !ruby/object:Gem::Dependency
+  name: opentelemetry-common
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.20'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.20'
 description: Common functionality for the OTLP exporters
 email:
 - cncf-opentelemetry-contributors@lists.cncf.io
@@ -64,6 +78,7 @@ files:
 - README.md
 - lib/opentelemetry-exporter-otlp-common.rb
 - lib/opentelemetry/exporter/otlp/common.rb
+- lib/opentelemetry/exporter/otlp/common/utilities.rb
 - lib/opentelemetry/exporter/otlp/common/version.rb
 - lib/opentelemetry/proto/collector/logs/v1/logs_service_pb.rb
 - lib/opentelemetry/proto/collector/metrics/v1/metrics_service_pb.rb
@@ -77,10 +92,10 @@ homepage: https://github.com/open-telemetry/opentelemetry-ruby
 licenses:
 - Apache-2.0
 metadata:
-  changelog_uri: https://rubydoc.info/gems/opentelemetry-exporter-otlp-common/0.2.0/file/CHANGELOG.md
-  source_code_uri: https://github.com/open-telemetry/opentelemetry-ruby/tree/opentelemetry-exporter-otlp-common/v0.2.0/exporter/otlp-common
+  changelog_uri: https://rubydoc.info/gems/opentelemetry-exporter-otlp-common/0.3.0/file/CHANGELOG.md
+  source_code_uri: https://github.com/open-telemetry/opentelemetry-ruby/tree/opentelemetry-exporter-otlp-common/v0.3.0/exporter/otlp-common
   bug_tracker_uri: https://github.com/open-telemetry/opentelemetry-ruby/issues
-  documentation_uri: https://rubydoc.info/gems/opentelemetry-exporter-otlp-common/0.2.0
+  documentation_uri: https://rubydoc.info/gems/opentelemetry-exporter-otlp-common/0.3.0
 rdoc_options: []
 require_paths:
 - lib
@@ -95,7 +110,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.16
+rubygems_version: 4.0.20
 specification_version: 4
 summary: Common functionality for the OTLP exporters
 test_files: []