opentelemetry-sdk 0.17.0 → 1.0.0.rc1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4be88dba1f3a925ceb97494267f2d27cfb24f5f89e417236d5cca698c0388b9b
-  data.tar.gz: 8e43a87d87dc739c1323acecaa18e93dac8a911fc28a119c016e5e834ca74615
+  metadata.gz: e5e0b06b7a072f462eeef975e4342a9e9800fb85794e2625f454d17eb20ef2be
+  data.tar.gz: a42a11084a981f147bdc5a3c5d21f1a4a1752d5a971819658573cb4964d43f49
 SHA512:
-  metadata.gz: 672426fc31d0c6cce4f363509085b40bddf66d6c6516048e40ae1661fefaf2a6a3482acfe9a6dcff8db328675fb2e5ec02c9fe89d91486f551bf029bcb390f6b
-  data.tar.gz: 42b693687ddfdf1221c972d902e9249fcec6a947bb48416b4627fbd805859ac8bc5fcdb18ac44e4fb628bfd56f67bf42d028465f6e34c4c679844a7c1027515d
+  metadata.gz: 670059ca8ef7d7aeba579c6b70a8217ac5e4fa879b39afee715b4ff1852e8643bf87581943b70d949480a728c531d20efc8ed42fa878f0a5291d55f31cc22607
+  data.tar.gz: 604feaa8d9952cce4a0eff45b743601b85ea2a5f7b03af316c5ae45c6df2fd57a2712d43d417a30a2df44b493fd6c8bc03f8924014a75d2fd29b9bfe513c7adf

data/CHANGELOG.md

@@ -1,127 +1,137 @@
 # Release History: opentelemetry-sdk
 
+### v1.0.0.rc1 / 2021-05-21
+
+* BREAKING CHANGE: Remove optional parent_context from in_span
+* BREAKING CHANGE: Replace Time.now with Process.clock_gettime
+
+* FIXED: Remove optional parent_context from in_span
+* FIXED: Replace Time.now with Process.clock_gettime
+* FIXED: Rename cloud.zone to cloud.availability_zone
+* FIXED: Improve attribute error messages
+
 ### v0.17.0 / 2021-04-22
 
 * BREAKING CHANGE: Replace TextMapInjector/TextMapExtractor pairs with a TextMapPropagator.
 
   [Check the propagator documentation](https://open-telemetry.github.io/opentelemetry-ruby/) for the new usage.
 
-* ADDED: Add zipkin exporter 
-* ADDED: Processors validate exporters on init. 
-* ADDED: Add configurable truncation of span and event attribute values  
-* ADDED: Add simple 'recording' attr_accessor to InMemorySpanExporter 
-* FIXED: Typo in error message 
-* FIXED: Improve configuration error reporting 
-* FIXED: Refactor propagators to add #fields 
+* ADDED: Add zipkin exporter
+* ADDED: Processors validate exporters on init.
+* ADDED: Add configurable truncation of span and event attribute values
+* ADDED: Add simple 'recording' attr_accessor to InMemorySpanExporter
+* FIXED: Typo in error message
+* FIXED: Improve configuration error reporting
+* FIXED: Refactor propagators to add #fields
 
 ### v0.16.0 / 2021-03-17
 
-* BREAKING CHANGE: Update SDK BaggageManager to match API 
-* BREAKING CHANGE: Implement Exporter#force_flush 
+* BREAKING CHANGE: Update SDK BaggageManager to match API
+* BREAKING CHANGE: Implement Exporter#force_flush
 
-* ADDED: Add force_flush to SDK's TracerProvider 
-* ADDED: Add k8s node to gcp resource detector 
-* ADDED: Add console option for OTEL_TRACES_EXPORTER 
-* ADDED: Span#add_attributes 
-* ADDED: Implement Exporter#force_flush 
-* FIXED: Update SDK BaggageManager to match API 
-* DOCS: Replace Gitter with GitHub Discussions 
+* ADDED: Add force_flush to SDK's TracerProvider
+* ADDED: Add k8s node to gcp resource detector
+* ADDED: Add console option for OTEL_TRACES_EXPORTER
+* ADDED: Span#add_attributes
+* ADDED: Implement Exporter#force_flush
+* FIXED: Update SDK BaggageManager to match API
+* DOCS: Replace Gitter with GitHub Discussions
 
 ### v0.15.0 / 2021-02-18
 
-* BREAKING CHANGE: Streamline processor pipeline 
+* BREAKING CHANGE: Streamline processor pipeline
 
-* ADDED: Add instrumentation config validation 
-* FIXED: Streamline processor pipeline 
-* FIXED: OTEL_TRACE -> OTEL_TRACES env vars 
-* FIXED: Change limits from 1000 to 128 
-* FIXED: OTEL_TRACES_EXPORTER and OTEL_PROPAGATORS 
-* FIXED: Add thread error handling to the BSP 
-* DOCS: Clarify nil attribute values not allowed 
+* ADDED: Add instrumentation config validation
+* FIXED: Streamline processor pipeline
+* FIXED: OTEL_TRACE -> OTEL_TRACES env vars
+* FIXED: Change limits from 1000 to 128
+* FIXED: OTEL_TRACES_EXPORTER and OTEL_PROPAGATORS
+* FIXED: Add thread error handling to the BSP
+* DOCS: Clarify nil attribute values not allowed
 
 ### v0.14.0 / 2021-02-03
 
-* BREAKING CHANGE: Replace getter and setter callables and remove rack specific propagators 
+* BREAKING CHANGE: Replace getter and setter callables and remove rack specific propagators
 
-* ADDED: Replace getter and setter callables and remove rack specific propagators 
+* ADDED: Replace getter and setter callables and remove rack specific propagators
 
 ### v0.13.1 / 2021-02-01
 
-* FIXED: Leaky test 
-* FIXED: Allow env var override of service.name 
+* FIXED: Leaky test
+* FIXED: Allow env var override of service.name
 
 ### v0.13.0 / 2021-01-29
 
-* BREAKING CHANGE: Remove MILLIS from BatchSpanProcessor vars 
+* BREAKING CHANGE: Remove MILLIS from BatchSpanProcessor vars
 
-* ADDED: Process.runtime resource 
-* ADDED: Provide default resource in SDK 
-* ADDED: Add optional attributes to record_exception 
-* FIXED: Resource.merge consistency 
-* FIXED: Remove MILLIS from BatchSpanProcessor vars 
+* ADDED: Process.runtime resource
+* ADDED: Provide default resource in SDK
+* ADDED: Add optional attributes to record_exception
+* FIXED: Resource.merge consistency
+* FIXED: Remove MILLIS from BatchSpanProcessor vars
 
 ### v0.12.1 / 2021-01-13
 
-* FIXED: Fix several BatchSpanProcessor errors related to fork safety 
-* FIXED: Define default value for traceid ratio 
+* FIXED: Fix several BatchSpanProcessor errors related to fork safety
+* FIXED: Define default value for traceid ratio
 
 ### v0.12.0 / 2020-12-24
 
-* ADDED: Structured error handling 
-* ADDED: Pluggable ID generation 
-* FIXED: BSP dropped span buffer full reporting 
-* FIXED: Implement SDK environment variables 
-* FIXED: Remove incorrect TODO 
+* ADDED: Structured error handling
+* ADDED: Pluggable ID generation
+* FIXED: BSP dropped span buffer full reporting
+* FIXED: Implement SDK environment variables
+* FIXED: Remove incorrect TODO
 
 ### v0.11.1 / 2020-12-16
 
-* FIXED: BSP dropped span buffer full reporting 
+* FIXED: BSP dropped span buffer full reporting
 
 ### v0.11.0 / 2020-12-11
 
-* ADDED: Metrics reporting from trace export 
-* FIXED: Copyright comments to not reference year 
+* ADDED: Metrics reporting from trace export
+* FIXED: Copyright comments to not reference year
 
 ### v0.10.0 / 2020-12-03
 
-* BREAKING CHANGE: Allow samplers to modify tracestate 
+* BREAKING CHANGE: Allow samplers to modify tracestate
 
-* FIXED: Allow samplers to modify tracestate 
+* FIXED: Allow samplers to modify tracestate
 
 ### v0.9.0 / 2020-11-27
 
-* BREAKING CHANGE: Pass full Context to samplers 
-* BREAKING CHANGE: Add timeout for force_flush and shutdown 
+* BREAKING CHANGE: Pass full Context to samplers
+* BREAKING CHANGE: Add timeout for force_flush and shutdown
 
-* ADDED: Add OTEL_RUBY_BSP_START_THREAD_ON_BOOT env var 
-* ADDED: Add timeout for force_flush and shutdown 
-* FIXED: Signal at batch_size 
-* FIXED: SDK Span.recording? after finish 
-* FIXED: Pass full Context to samplers 
-* DOCS: Add documentation on usage scenarios for span processors 
+* ADDED: Add OTEL_RUBY_BSP_START_THREAD_ON_BOOT env var
+* ADDED: Add timeout for force_flush and shutdown
+* FIXED: Signal at batch_size
+* FIXED: SDK Span.recording? after finish
+* FIXED: Pass full Context to samplers
+* DOCS: Add documentation on usage scenarios for span processors
 
 ### v0.8.0 / 2020-10-27
 
-* BREAKING CHANGE: Move context/span methods to Trace module 
-* BREAKING CHANGE: Remove 'canonical' from status codes 
-* BREAKING CHANGE: Assorted SpanContext fixes 
+* BREAKING CHANGE: Move context/span methods to Trace module
+* BREAKING CHANGE: Remove 'canonical' from status codes
+* BREAKING CHANGE: Assorted SpanContext fixes
 
-* FIXED: Move context/span methods to Trace module 
-* FIXED: Remove 'canonical' from status codes 
-* FIXED: Assorted SpanContext fixes 
+* FIXED: Move context/span methods to Trace module
+* FIXED: Remove 'canonical' from status codes
+* FIXED: Assorted SpanContext fixes
 
 ### v0.7.0 / 2020-10-07
 
-* ADDED: Add service_name setter to configurator 
-* ADDED: Add service_version setter to configurator 
-* FIXED: Fork safety for batch processor 
-* FIXED: Don't generate a span ID unnecessarily 
-* DOCS: Fix Configurator#add_span_processor 
-* DOCS: Standardize toplevel docs structure and readme 
+* ADDED: Add service_name setter to configurator
+* ADDED: Add service_version setter to configurator
+* FIXED: Fork safety for batch processor
+* FIXED: Don't generate a span ID unnecessarily
+* DOCS: Fix Configurator#add_span_processor
+* DOCS: Standardize toplevel docs structure and readme
 
 ### v0.6.0 / 2020-09-10
 
-* BREAKING CHANGE: Rename Resource labels to attributes 
+* BREAKING CHANGE: Rename Resource labels to attributes
 * BREAKING CHANGE: Export resource from Span/SpanData instead of library_resource
 * BREAKING CHANGE: Rename CorrelationContext to Baggage
 * BREAKING CHANGE: Rename Text* to TextMap* (propagators, injectors, extractors)
@@ -131,7 +141,7 @@
 
 * ADDED: Add OTLP exporter
 * ADDED: Add support for OTEL_LOG_LEVEL env var
-* FIXED: Rename Resource labels to attributes 
+* FIXED: Rename Resource labels to attributes
 * ADDED: Environment variable resource detection
 * ADDED: BatchSpanProcessor environment variable support
 * FIXED: Remove semver prefix

data/lib/opentelemetry/sdk/internal.rb

@@ -44,13 +44,13 @@ module OpenTelemetry
         valid_simple_value?(value) || valid_array_value?(value)
       end
 
-      def valid_attributes?(attrs)
+      def valid_attributes?(owner, kind, attrs)
         attrs.nil? || attrs.all? do |k, v|
           if !valid_key?(k)
-            OpenTelemetry.handle_error(message: "invalid attribute key type #{k.class}")
+            OpenTelemetry.handle_error(message: "invalid #{kind} attribute key type #{k.class} on span '#{owner}'")
             false
           elsif !valid_value?(v)
-            OpenTelemetry.handle_error(message: "invalid attribute value type #{v.class}")
+            OpenTelemetry.handle_error(message: "invalid #{kind} attribute value type #{v.class} for key '#{k}' on span '#{owner}'")
             false
           else
             true

data/lib/opentelemetry/sdk/resources/constants.rb

@@ -196,8 +196,8 @@ module OpenTelemetry
           # A specific geographical location where different entities can run.
           region: 'cloud.region',
 
-          # Zones are a sub set of the region connected through low-latency links.
-          zone: 'cloud.zone'
+          # Availability zones are a sub set of the region connected through low-latency links.
+          availability_zone: 'cloud.availability_zone'
         }.freeze
       end
     end

data/lib/opentelemetry/sdk/trace/event.rb

@@ -7,42 +7,13 @@
 module OpenTelemetry
   module SDK
     module Trace
-      # A text annotation with a set of attributes and a timestamp.
-      class Event
-        EMPTY_ATTRIBUTES = {}.freeze
-
-        private_constant :EMPTY_ATTRIBUTES
-
-        # Returns the name of this event
-        #
-        # @return [String]
-        attr_reader :name
-
-        # Returns the frozen attributes for this event
-        #
-        # @return [Hash{String => String, Numeric, Boolean, Array<String, Numeric, Boolean>}]
-        attr_reader :attributes
-
-        # Returns the timestamp for this event
-        #
-        # @return [Time]
-        attr_reader :timestamp
-
-        # Returns a new immutable {Event}.
-        #
-        # @param [String] name The name of this event
-        # @param [optional Hash{String => String, Numeric, Boolean, Array<String, Numeric, Boolean>}]
-        #   attributes A hash of attributes for this event. Attributes will be
-        #   frozen during Event initialization.
-        # @param [optional Time] timestamp The timestamp for this event.
-        #   Defaults to Time.now.
-        # @return [Event]
-        def initialize(name:, attributes: nil, timestamp: nil)
-          @name = name
-          @attributes = attributes.freeze || EMPTY_ATTRIBUTES
-          @timestamp = timestamp || Time.now
-        end
-      end
+      # A text annotation with a set of attributes and a timestamp for export.
+      #
+      # Field types are as follows:
+      #  name: String
+      #  attributes: frozen Hash{String => String, Numeric, Boolean, Array<String, Numeric, Boolean>}
+      #  timestamp: Integer nanoseconds since Epoch
+      Event = Struct.new(:name, :attributes, :timestamp)
     end
   end
 end

data/lib/opentelemetry/sdk/trace/export/batch_span_processor.rb

@@ -101,7 +101,7 @@ module OpenTelemetry
           # @return [Integer] SUCCESS if no error occurred, FAILURE if a
           #   non-specific failure occurred, TIMEOUT if a timeout occurred.
           def force_flush(timeout: nil) # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity, Metrics/MethodLength
-            start_time = Time.now
+            start_time = OpenTelemetry::Common::Utilities.timeout_timestamp
             snapshot = lock do
               reset_on_fork if @keep_running
               spans.shift(spans.size)
@@ -137,7 +137,7 @@ module OpenTelemetry
           # @return [Integer] SUCCESS if no error occurred, FAILURE if a
           #   non-specific failure occurred, TIMEOUT if a timeout occurred.
           def shutdown(timeout: nil)
-            start_time = Time.now
+            start_time = OpenTelemetry::Common::Utilities.timeout_timestamp
             thread = lock do
               @keep_running = false
               @condition.signal

data/lib/opentelemetry/sdk/trace/export/multi_span_exporter.rb

@@ -26,7 +26,7 @@ module OpenTelemetry
           # @param [optional Numeric] timeout An optional timeout in seconds.
           # @return [Integer] the result of the export.
           def export(spans, timeout: nil)
-            start_time = Time.now
+            start_time = OpenTelemetry::Common::Utilities.timeout_timestamp
             results = @span_exporters.map do |span_exporter|
               span_exporter.export(spans, timeout: OpenTelemetry::Common::Utilities.maybe_timeout(timeout, start_time))
             rescue => e # rubocop:disable Style/RescueStandardError
@@ -43,7 +43,7 @@ module OpenTelemetry
           # @return [Integer] SUCCESS if no error occurred, FAILURE if a
           #   non-specific failure occurred, TIMEOUT if a timeout occurred.
           def force_flush(timeout: nil)
-            start_time = Time.now
+            start_time = OpenTelemetry::Common::Utilities.timeout_timestamp
             results = @span_exporters.map do |processor|
               remaining_timeout = OpenTelemetry::Common::Utilities.maybe_timeout(timeout, start_time)
               return TIMEOUT if remaining_timeout&.zero?
@@ -60,7 +60,7 @@ module OpenTelemetry
           # @return [Integer] SUCCESS if no error occurred, FAILURE if a
           #   non-specific failure occurred, TIMEOUT if a timeout occurred.
           def shutdown(timeout: nil)
-            start_time = Time.now
+            start_time = OpenTelemetry::Common::Utilities.timeout_timestamp
             results = @span_exporters.map do |processor|
               remaining_timeout = OpenTelemetry::Common::Utilities.maybe_timeout(timeout, start_time)
               return TIMEOUT if remaining_timeout&.zero?

data/lib/opentelemetry/sdk/trace/multi_span_processor.rb

@@ -55,7 +55,7 @@ module OpenTelemetry
         # @return [Integer] Export::SUCCESS if no error occurred, Export::FAILURE if
         #   a non-specific failure occurred, Export::TIMEOUT if a timeout occurred.
         def force_flush(timeout: nil)
-          start_time = Time.now
+          start_time = OpenTelemetry::Common::Utilities.timeout_timestamp
           results = @span_processors.map do |processor|
             remaining_timeout = OpenTelemetry::Common::Utilities.maybe_timeout(timeout, start_time)
             return Export::TIMEOUT if remaining_timeout&.zero?
@@ -71,7 +71,7 @@ module OpenTelemetry
         # @return [Integer] Export::SUCCESS if no error occurred, Export::FAILURE if
         #   a non-specific failure occurred, Export::TIMEOUT if a timeout occurred.
         def shutdown(timeout: nil)
-          start_time = Time.now
+          start_time = OpenTelemetry::Common::Utilities.timeout_timestamp
           results = @span_processors.map do |processor|
             remaining_timeout = OpenTelemetry::Common::Utilities.maybe_timeout(timeout, start_time)
             return Export::TIMEOUT if remaining_timeout&.zero?

data/lib/opentelemetry/sdk/trace/span.rb

@@ -17,8 +17,9 @@ module OpenTelemetry
       # rubocop:disable Metrics/ClassLength
       class Span < OpenTelemetry::Trace::Span
         DEFAULT_STATUS = OpenTelemetry::Trace::Status.new(OpenTelemetry::Trace::Status::UNSET)
+        EMPTY_ATTRIBUTES = {}.freeze
 
-        private_constant(:DEFAULT_STATUS)
+        private_constant :DEFAULT_STATUS, :EMPTY_ATTRIBUTES
 
         # The following readers are intended for the use of SpanProcessors and
         # should not be considered part of the public interface for instrumentation.
@@ -70,7 +71,6 @@ module OpenTelemetry
         #
         # @return [self] returns itself
         def set_attribute(key, value)
-          super
           @mutex.synchronize do
             if @ended
               OpenTelemetry.logger.warn('Calling set_attribute on an ended Span.')
@@ -99,7 +99,6 @@ module OpenTelemetry
         #
         # @return [self] returns itself
         def add_attributes(attributes)
-          super
           @mutex.synchronize do
             if @ended
               OpenTelemetry.logger.warn('Calling add_attributes on an ended Span.')
@@ -132,8 +131,7 @@ module OpenTelemetry
         #
         # @return [self] returns itself
         def add_event(name, attributes: nil, timestamp: nil)
-          super
-          event = Event.new(name: name, attributes: truncate_attribute_values(attributes), timestamp: timestamp || Time.now)
+          event = Event.new(name, truncate_attribute_values(attributes), wall_clock(timestamp))
 
           @mutex.synchronize do
             if @ended
@@ -179,7 +177,6 @@ module OpenTelemetry
         #
         # @return [void]
         def status=(status)
-          super
           @mutex.synchronize do
             if @ended
               OpenTelemetry.logger.warn('Calling status= on an ended Span.')
@@ -199,7 +196,6 @@ module OpenTelemetry
         #
         # @return [void]
         def name=(new_name)
-          super
           @mutex.synchronize do
             if @ended
               OpenTelemetry.logger.warn('Calling name= on an ended Span.')
@@ -234,7 +230,7 @@ module OpenTelemetry
               OpenTelemetry.logger.warn('Calling finish on an ended Span.')
               return self
             end
-            @end_timestamp = end_timestamp || Time.now
+            @end_timestamp = wall_clock(end_timestamp)
             @attributes = validated_attributes(@attributes).freeze
             @events.freeze
             @ended = true
@@ -292,7 +288,7 @@ module OpenTelemetry
           @total_recorded_events = 0
           @total_recorded_links = links&.size || 0
           @total_recorded_attributes = attributes&.size || 0
-          @start_timestamp = start_timestamp
+          @start_timestamp = wall_clock(start_timestamp)
           @end_timestamp = nil
           @attributes = attributes.nil? ? nil : Hash[attributes] # We need a mutable copy of attributes.
           trim_span_attributes(@attributes)
@@ -306,7 +302,7 @@ module OpenTelemetry
         private
 
         def validated_attributes(attrs)
-          return attrs if Internal.valid_attributes?(attrs)
+          return attrs if Internal.valid_attributes?(name, 'span', attrs)
 
           attrs.keep_if { |key, value| Internal.valid_key?(key) && Internal.valid_value?(value) }
         end
@@ -321,7 +317,7 @@ module OpenTelemetry
         end
 
         def truncate_attribute_values(attrs)
-          return if attrs.nil?
+          return EMPTY_ATTRIBUTES if attrs.nil?
 
           max_attributes_length = @trace_config.max_attributes_length
           attrs.each { |key, value| attrs[key] = OpenTelemetry::Common::Utilities.truncate(value, max_attributes_length) } if max_attributes_length
@@ -333,7 +329,7 @@ module OpenTelemetry
           return nil if links.nil?
 
           if links.size <= max_links_count &&
-             links.all? { |link| link.attributes.size <= max_attributes_per_link && Internal.valid_attributes?(link.attributes) }
+             links.all? { |link| link.attributes.size <= max_attributes_per_link && Internal.valid_attributes?(name, 'link', link.attributes) }
             return links.frozen? ? links : links.clone.freeze
           end
 
@@ -350,7 +346,7 @@ module OpenTelemetry
         def append_event(events, event) # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
           max_events_count = @trace_config.max_events_count
           max_attributes_per_event = @trace_config.max_attributes_per_event
-          valid_attributes = Internal.valid_attributes?(event.attributes)
+          valid_attributes = Internal.valid_attributes?(name, 'event', event.attributes)
 
           # Fast path (likely) common case.
           if events.size < max_events_count &&
@@ -369,10 +365,15 @@ module OpenTelemetry
             attrs.keep_if { |key, value| Internal.valid_key?(key) && Internal.valid_value?(value) }
             excess = attrs.size - max_attributes_per_event
             excess.times { attrs.shift } if excess.positive?
-            event = Event.new(name: event.name, attributes: attrs, timestamp: event.timestamp)
+            event = Event.new(event.name, attrs.freeze, event.timestamp)
           end
           events << event
         end
+
+        def wall_clock(timestamp)
+          timestamp = (timestamp.to_r * 1_000_000_000).to_i unless timestamp.nil?
+          timestamp || Process.clock_gettime(Process::CLOCK_REALTIME, :nanosecond)
+        end
       end
       # rubocop:enable Metrics/ClassLength
     end

data/lib/opentelemetry/sdk/trace/span_data.rb

@@ -10,24 +10,24 @@ module OpenTelemetry
     # implementation.
     module Trace
       # SpanData is a Struct containing {Span} data for export.
-      SpanData = Struct.new(:name,
-                            :kind,
-                            :status,
-                            :parent_span_id,
-                            :total_recorded_attributes,
-                            :total_recorded_events,
-                            :total_recorded_links,
-                            :start_timestamp,
-                            :end_timestamp,
-                            :attributes,
-                            :links,
-                            :events,
-                            :resource,
-                            :instrumentation_library,
-                            :span_id,
-                            :trace_id,
-                            :trace_flags,
-                            :tracestate) do
+      SpanData = Struct.new(:name,                      # String
+                            :kind,                      # Symbol: :internal, :producer, :consumer, :client, :server
+                            :status,                    # Status
+                            :parent_span_id,            # String (8 byte binary), may be OpenTelemetry::Trace::INVALID_SPAN_ID
+                            :total_recorded_attributes, # Integer
+                            :total_recorded_events,     # Integer
+                            :total_recorded_links,      # Integer
+                            :start_timestamp,           # Integer nanoseconds since Epoch
+                            :end_timestamp,             # Integer nanoseconds since Epoch
+                            :attributes,                # optional Hash{String => String, Numeric, Boolean, Array<String, Numeric, Boolean>}
+                            :links,                     # optional Array[OpenTelemetry::Trace::Link]
+                            :events,                    # optional Array[Event]
+                            :resource,                  # OpenTelemetry::SDK::Resources::Resource
+                            :instrumentation_library,   # OpenTelemetry::SDK::InstrumentationLibrary
+                            :span_id,                   # String (8 byte binary)
+                            :trace_id,                  # String (16-byte binary)
+                            :trace_flags,               # Integer (8-bit byte of bit flags)
+                            :tracestate) do             # OpenTelemetry::Trace::Tracestate
                               # Returns the lowercase [hex encoded](https://tools.ietf.org/html/rfc4648#section-8) span ID.
                               #
                               # @return [String] A 16-hex-character lowercase string.
@@ -41,6 +41,13 @@ module OpenTelemetry
                               def hex_trace_id
                                 trace_id.unpack1('H*')
                               end
+
+                              # Returns the lowercase [hex encoded](https://tools.ietf.org/html/rfc4648#section-8) parent span ID.
+                              #
+                              # @return [String] A 16-hex-character lowercase string.
+                              def hex_parent_span_id
+                                parent_span_id.unpack1('H*')
+                              end
                             end
     end
   end

data/lib/opentelemetry/sdk/trace/tracer.rb

@@ -66,7 +66,7 @@ module OpenTelemetry
               tracer_provider.active_span_processor,
               attributes,
               links,
-              start_timestamp || Time.now,
+              start_timestamp,
               tracer_provider.resource,
               @instrumentation_library
             )

data/lib/opentelemetry/sdk/version.rb

@@ -7,6 +7,6 @@
 module OpenTelemetry
   module SDK
     ## Current OpenTelemetry version
-    VERSION = '0.17.0'
+    VERSION = '1.0.0.rc1'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: opentelemetry-sdk
 version: !ruby/object:Gem::Version
-  version: 0.17.0
+  version: 1.0.0.rc1
 platform: ruby
 authors:
 - OpenTelemetry Authors
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-04-23 00:00:00.000000000 Z
+date: 2021-05-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: opentelemetry-api
@@ -16,42 +16,42 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.17.0
+        version: 1.0.0.rc1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.17.0
+        version: 1.0.0.rc1
 - !ruby/object:Gem::Dependency
   name: opentelemetry-common
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.17.0
+        version: 0.18.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.17.0
+        version: 0.18.0
 - !ruby/object:Gem::Dependency
   name: opentelemetry-instrumentation-base
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.17.0
+        version: 0.18.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.17.0
+        version: 0.18.0
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -100,14 +100,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.17.0
+        version: 0.18.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.17.0
+        version: 0.18.0
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -226,10 +226,10 @@ homepage: https://github.com/open-telemetry/opentelemetry-ruby
 licenses:
 - Apache-2.0
 metadata:
-  changelog_uri: https://open-telemetry.github.io/opentelemetry-ruby/opentelemetry-sdk/v0.17.0/file.CHANGELOG.html
+  changelog_uri: https://open-telemetry.github.io/opentelemetry-ruby/opentelemetry-sdk/v1.0.0.rc1/file.CHANGELOG.html
   source_code_uri: https://github.com/open-telemetry/opentelemetry-ruby/tree/main/sdk
   bug_tracker_uri: https://github.com/open-telemetry/opentelemetry-ruby/issues
-  documentation_uri: https://open-telemetry.github.io/opentelemetry-ruby/opentelemetry-sdk/v0.17.0
+  documentation_uri: https://open-telemetry.github.io/opentelemetry-ruby/opentelemetry-sdk/v1.0.0.rc1
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -241,9 +241,9 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: 2.5.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - ">"
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 1.3.1
 requirements: []
 rubygems_version: 3.1.6
 signing_key: