uptrace 0.16.1 → 1.0.0.rc3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3e04833f5ff0015d78af4774cc49272db2c0c10e3cd93ce5acbe6cfc3e9e3772
-  data.tar.gz: f027f68acd8f95b550bdbde26322307420f8e833447aff1a268d06ac57b00910
+  metadata.gz: 56199216a5c7984c7896ed2d2480ec7d3ba062dbddc78feb1a640a8ea16d59a5
+  data.tar.gz: f63c2f468a5df9982a7fae3beb3911fe84b8743329f7c73fed8a26aa47851440
 SHA512:
-  metadata.gz: 1ef5879252c95a7ca008f042061ecc1d674f36822739e8f17bb19ae2385ef1f6cdc02bc2885edf3538da13d3f9d5f9feca849c3f553381de4b393f55aedf570d
-  data.tar.gz: ef03b0f10c6d992d81f5d64c0df4d9eb8c9590399c61fe9f3b9b8cc166492309940c2e2d6479f2366a9137d111caae6ce16b6c9f53c4f89f176b532345d94e2f
+  metadata.gz: d6ac6820d74a2df77286ae3d82cc94c91660cb31d04dfbbe5d2128ff0de645338d71e64658a32efb1e396b23ab8cb65ac86b3e1a3e2644ee00b767496627ab38
+  data.tar.gz: 1361f3804cfa101e125910035234dcc7dafd1c208babcaaca9d675ebb90e25da8c315f8631f7c9c11b832f6c49afd56a8552ba390b9a8d1a0cc939598a591431

data/CHANGELOG.md

@@ -0,0 +1,22 @@
+# Changelog
+
+## v1.0.0.rc3 - 2021-08-17
+
+- Updated OpenTelemetry to
+  [v1.0.0.rc3](https://github.com/open-telemetry/opentelemetry-ruby/blob/main/api/CHANGELOG.md#v100rc3--2021-08-12).
+- Switched to using OTLP protocol.
+
+## v1.0.0.rc1 - 2021-05-22
+
+- Updated OpenTelemetry to
+  [v1.0.0.rc1](https://github.com/open-telemetry/opentelemetry-ruby/blob/main/api/CHANGELOG.md#v100rc1--2021-05-21).
+
+## v0.17.0 - 2021-04-24
+
+- Updated OpenTelemetry to
+  [v0.17.0](https://github.com/open-telemetry/opentelemetry-ruby/blob/main/api/CHANGELOG.md#v0170--2021-04-22).
+
+## v0.16.2 - 2021-03-28
+
+- Updated OpenTelemetry to
+  [v0.16.0](https://github.com/open-telemetry/opentelemetry-ruby/blob/main/api/CHANGELOG.md#v0160--2021-03-17).

data/README.md

@@ -4,7 +4,7 @@
 [![Documentation](https://img.shields.io/badge/uptrace-documentation-informational)](https://docs.uptrace.dev/ruby/)
 
 <a href="https://docs.uptrace.dev/ruby/">
-  <img src="https://docs.uptrace.dev/devicons/ruby-original.svg" height="200px" />
+  <img src="https://docs.uptrace.dev/devicon/ruby-original.svg" height="200px" />
 </a>
 
 ## Introduction
@@ -30,33 +30,35 @@ require 'rubygems'
 require 'bundler/setup'
 require 'uptrace'
 
-OpenTelemetry::SDK.configure do |c|
+# Configure OpenTelemetry with sensible defaults.
+# Copy your project DSN here or use UPTRACE_DSN env var.
+Uptrace.configure_opentelemetry(dsn: '') do |c|
+  # c is OpenTelemetry::SDK::Configurator
   c.service_name = 'myservice'
   c.service_version = '1.0.0'
-
-  # Configure OpenTelemetry to export data to Uptrace.
-  # Copy your project DSN here or use UPTRACE_DSN env var.
-  Uptrace.configure_opentelemetry(c, dsn: '')
 end
 
+# Create a tracer. Usually, tracer is a global variable.
 tracer = OpenTelemetry.tracer_provider.tracer('my_app_or_gem', '0.1.0')
 
-tracer.in_span('main') do |span|
-  tracer.in_span('child1') do |child1|
+# Create a root span (a trace) to measure some operation.
+tracer.in_span('main-operation') do |main|
+  tracer.in_span('child1-of-main') do |child1|
     child1.set_attribute('key1', 'value1')
     child1.record_exception(ArgumentError.new('error1'))
   end
 
-  tracer.in_span('child2') do |child2|
+  tracer.in_span('child2-of-main') do |child2|
     child2.set_attribute('key2', '24')
     child2.set_attribute('key3', 123.456)
   end
 
-  puts("trace URL: #{Uptrace.trace_url(span)}")
+  puts("trace URL: #{Uptrace.trace_url(main)}")
 end
 
-# Send buffered spans.
+# Send buffered spans and free resources.
 OpenTelemetry.tracer_provider.shutdown
 ```
 
-Please see [uptrace-ruby documentation](https://docs.uptrace.dev/ruby/) for more details.
+For more details, please see [documentation](https://docs.uptrace.dev/ruby/) and
+[examples](example).

data/lib/uptrace.rb

@@ -1,7 +1,8 @@
 # frozen_string_literal: true
 
 require 'logger'
-require 'opentelemetry'
+
+require 'opentelemetry/exporter/otlp'
 
 # Uptrace provides Uptrace exporters for OpenTelemetry.
 module Uptrace
@@ -24,31 +25,38 @@ module Uptrace
   end
 
   # ConfigureOpentelemetry configures OpenTelemetry to export data to Uptrace.
-  # By default it:
-  #   - creates tracer provider;
-  #   - registers Uptrace span exporter;
-  #   - sets tracecontext + baggage composite context propagator.
+  # Specifically it configures and registers Uptrace span exporter.
   #
-  # @param [OpenTelemetry::SDK::Configurator] c
-  def configure_opentelemetry(c, dsn: '')
-    @client = Client.new(dsn: dsn) unless dsn.empty?
-
-    c.add_span_processor(client.span_processor) unless client.disabled?
-
-    if OpenTelemetry.propagation.nil?
-      c.injectors = [
-        OpenTelemetry::Trace::Propagation::TraceContext.text_map_injector,
-        OpenTelemetry::Baggage::Propagation.text_map_injector
-      ]
-      c.extractors = [
-        OpenTelemetry::Trace::Propagation::TraceContext.text_map_extractor,
-        OpenTelemetry::Baggage::Propagation.text_map_extractor
-      ]
+  # @param [optional String] dsn
+  # @yieldparam [OpenTelemetry::SDK::Configurator] c Yields a configurator to the
+  #   provided block
+  def configure_opentelemetry(dsn: '')
+    OpenTelemetry::SDK.configure do |c|
+      @client = Client.new(dsn: dsn) unless dsn.empty?
+      c.add_span_processor(span_processor(@client.dsn.to_s)) unless client.disabled?
+
+      yield c if block_given?
     end
   end
+
+  private
+
+  def span_processor(dsn)
+    exporter = OpenTelemetry::Exporter::OTLP::Exporter.new(
+      endpoint: 'https://otlp.uptrace.dev/v1/traces',
+      # Set the Uptrace DSN here or use UPTRACE_DSN env var.
+      headers: { 'uptrace-dsn': dsn },
+      compression: 'gzip'
+    )
+    OpenTelemetry::SDK::Trace::Export::BatchSpanProcessor.new(
+      exporter,
+      max_queue_size: 1000,
+      max_export_batch_size: 1000,
+      schedule_delay: 5_000
+    )
+  end
 end
 
 require 'uptrace/version'
 require 'uptrace/dsn'
 require 'uptrace/client'
-require 'uptrace/trace'

data/lib/uptrace/client.rb

@@ -5,6 +5,8 @@ require 'opentelemetry/sdk'
 module Uptrace
   # Uptrace client that configures OpenTelemetry SDK to use Uptrace exporter.
   class Client
+    attr_reader :dsn
+
     # @param [string] dsn
     def initialize(dsn: '')
       dsn = ENV.fetch('UPTRACE_DSN', '') if dsn.empty?
@@ -32,16 +34,5 @@ module Uptrace
       trace_id = span.context.hex_trace_id
       "#{@dsn.scheme}://#{host}/search/#{@dsn.project_id}?q=#{trace_id}"
     end
-
-    # @return [OpenTelemetry::SDK::Trace::Export::BatchSpanProcessor]
-    def span_processor
-      exp = Uptrace::Trace::Exporter.new(@dsn)
-      OpenTelemetry::SDK::Trace::Export::BatchSpanProcessor.new(
-        exp,
-        max_queue_size: 1000,
-        max_export_batch_size: 1000,
-        schedule_delay: 5_000
-      )
-    end
   end
 end

data/lib/uptrace/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Uptrace
-  VERSION = '0.16.1'
+  VERSION = '1.0.0.rc3'
 end

metadata

@@ -1,71 +1,57 @@
 --- !ruby/object:Gem::Specification
 name: uptrace
 version: !ruby/object:Gem::Version
-  version: 0.16.1
+  version: 1.0.0.rc3
 platform: ruby
 authors:
 - Uptrace Authors
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-03-23 00:00:00.000000000 Z
+date: 2021-08-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: msgpack
+  name: opentelemetry-exporter-otlp
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.3'
+        version: 0.20.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.3'
+        version: 0.20.2
 - !ruby/object:Gem::Dependency
   name: opentelemetry-sdk
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.16.0
+        version: 1.0.0.rc3
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.16.0
-- !ruby/object:Gem::Dependency
-  name: zstd-ruby
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 1.4.5.0
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 1.4.5.0
+        version: 1.0.0.rc3
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.17'
+        version: 2.1.4
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.17'
+        version: 2.1.4
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
@@ -172,15 +158,13 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".yardopts"
+- CHANGELOG.md
 - LICENSE
 - README.md
 - RELEASE.md
 - lib/uptrace.rb
 - lib/uptrace/client.rb
 - lib/uptrace/dsn.rb
-- lib/uptrace/metric.rb
-- lib/uptrace/trace.rb
-- lib/uptrace/trace/exporter.rb
 - lib/uptrace/version.rb
 homepage: https://github.com/uptrace/uptrace-ruby
 licenses:
@@ -197,9 +181,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.4
 signing_key: 

data/lib/uptrace/metric.rb

@@ -1,7 +0,0 @@
-# frozen_string_literal: true
-
-module Uptrace
-  # Metric module provides metric exporter for OpenTelemetry.
-  module Metric
-  end
-end

data/lib/uptrace/trace.rb

@@ -1,9 +0,0 @@
-# frozen_string_literal: true
-
-module Uptrace
-  # Trace module provides trace exporter for OpenTelemetry.
-  module Trace
-  end
-end
-
-require 'uptrace/trace/exporter'

data/lib/uptrace/trace/exporter.rb

@@ -1,232 +0,0 @@
-# frozen_string_literal: true
-
-require 'uri'
-require 'net/http'
-require 'json'
-
-require 'opentelemetry/sdk'
-require 'msgpack'
-require 'zstd-ruby'
-
-module Uptrace
-  module Trace
-    # Exporter is a span exporter for OpenTelemetry.
-    class Exporter
-      SUCCESS = OpenTelemetry::SDK::Trace::Export::SUCCESS
-      FAILURE = OpenTelemetry::SDK::Trace::Export::FAILURE
-      TIMEOUT = OpenTelemetry::SDK::Trace::Export::TIMEOUT
-      private_constant(:SUCCESS, :FAILURE, :TIMEOUT)
-
-      ##
-      # @param [Config] cfg
-      #
-      def initialize(dsn)
-        @dsn = dsn
-        @endpoint = "/api/v1/tracing/#{@dsn.project_id}/spans"
-
-        @http = Net::HTTP.new(@dsn.host, 443)
-        @http.use_ssl = true
-        @http.open_timeout = 5
-        @http.read_timeout = 5
-        @http.keep_alive_timeout = 30
-      end
-
-      # Called to export sampled {OpenTelemetry::SDK::Trace::SpanData} structs.
-      #
-      # @param [Enumerable<OpenTelemetry::SDK::Trace::SpanData>] spans the
-      #   list of recorded {OpenTelemetry::SDK::Trace::SpanData} structs to be
-      #   exported.
-      # @param [optional Numeric] timeout An optional timeout in seconds.
-      # @return [Integer] the result of the export.
-      def export(spans, timeout: nil)
-        return SUCCESS if @disabled
-        return FAILURE if @shutdown
-
-        out = []
-
-        spans.each do |span|
-          out.push(uptrace_span(span))
-        end
-
-        send({ spans: out }, timeout: timeout)
-      end
-
-      # Called when {OpenTelemetry::SDK::Trace::TracerProvider#force_flush} is called, if
-      # this exporter is registered to a {OpenTelemetry::SDK::Trace::TracerProvider}
-      # object.
-      #
-      # @param [optional Numeric] timeout An optional timeout in seconds.
-      def force_flush(timeout: nil) # rubocop:disable Lint/UnusedMethodArgument
-        SUCCESS
-      end
-
-      # Called when {OpenTelemetry::SDK::Trace::Tracer#shutdown} is called, if
-      # this exporter is registered to a {OpenTelemetry::SDK::Trace::Tracer}
-      # object.
-      #
-      # @param [optional Numeric] timeout An optional timeout in seconds.
-      def shutdown(timeout: nil) # rubocop:disable Lint/UnusedMethodArgument
-        @shutdown = true
-        @http.finish if @http.started?
-        SUCCESS
-      end
-
-      private
-
-      ##
-      # @return [hash]
-      #
-      def uptrace_span(span)
-        out = {
-          id: span.span_id.unpack1('Q'),
-          traceId: span.trace_id,
-
-          name: span.name,
-          kind: kind_as_str(span.kind),
-          startTime: as_unix_nano(span.start_timestamp),
-          endTime: as_unix_nano(span.end_timestamp),
-
-          resource: uptrace_resource(span.resource),
-          attrs: span.attributes
-        }
-
-        out[:parentId] = span.parent_span_id.unpack1('Q') if span.parent_span_id
-
-        out[:events] = uptrace_events(span.events) unless span.events.nil?
-        out[:links] = uptrace_links(span.links) unless span.links.nil?
-
-        status = span.status
-        out[:statusCode] = status_code_as_str(status.code)
-        out[:statusMessage] = status.description unless status.description.empty?
-
-        il = span.instrumentation_library
-        out[:tracerName] = il.name
-        out[:tracerVersion] = il.name unless il.version.empty?
-
-        out
-      end
-
-      def send(data, timeout: nil) # rubocop:disable Lint/UnusedMethodArgument
-        req = build_request(data)
-
-        begin
-          resp = @http.request(req)
-        rescue Net::OpenTimeout, Net::ReadTimeout
-          return FAILURE
-        end
-
-        case resp
-        when Net::HTTPOK
-          resp.body # Read and discard body
-          SUCCESS
-        when Net::HTTPBadRequest
-          data = JSON.parse(resp.body)
-          Uptrace.logger.error("status=#{data['status']}: #{data['message']}")
-          FAILURE
-        when Net::HTTPInternalServerError
-          resp.body
-          FAILURE
-        else
-          @http.finish
-          FAILURE
-        end
-      end
-
-      ##
-      # @param [Hash] data
-      # @return [Net::HTTP::Post]
-      #
-      def build_request(data)
-        data = MessagePack.pack(data)
-        data = Zstd.compress(data, 3)
-
-        req = Net::HTTP::Post.new(@endpoint)
-        req.add_field('Authorization', "Bearer #{@dsn.token}")
-        req.add_field('Content-Type', 'application/msgpack')
-        req.add_field('Content-Encoding', 'zstd')
-        req.add_field('Connection', 'keep-alive')
-        req.body = data
-
-        req
-      end
-
-      # @param [SpanKind] kind
-      # @return [String]
-      def kind_as_str(kind)
-        case kind
-        when OpenTelemetry::Trace::SpanKind::SERVER
-          'server'
-        when OpenTelemetry::Trace::SpanKind::CLIENT
-          'client'
-        when OpenTelemetry::Trace::SpanKind::PRODUCER
-          'producer'
-        when OpenTelemetry::Trace::SpanKind::CONSUMER
-          'consumer'
-        else
-          'internal'
-        end
-      end
-
-      ##
-      # @param [Integer] timestamp
-      # @return [Integer]
-      #
-      def as_unix_nano(timestamp)
-        (timestamp.to_r * 1_000_000_000).to_i
-      end
-
-      ##
-      # @param [Integer] code
-      # @return [String]
-      #
-      def status_code_as_str(code)
-        case code
-        when OpenTelemetry::Trace::Status::OK
-          'ok'
-        when OpenTelemetry::Trace::Status::ERROR
-          'error'
-        else
-          'unset'
-        end
-      end
-
-      ##
-      # @param [OpenTelemetry::SDK::Resources::Resource] resource
-      # @return [Hash]
-      #
-      def uptrace_resource(resource)
-        out = {}
-        resource.attribute_enumerator.map { |key, value| out[key] = value }
-        out
-      end
-
-      def uptrace_events(events)
-        out = []
-        events.each do |event|
-          out.push(
-            {
-              name: event.name,
-              attrs: event.attributes,
-              time: as_unix_nano(event.timestamp)
-            }
-          )
-        end
-        out
-      end
-
-      def uptrace_links(links)
-        out = []
-        links.each do |link|
-          out.push(
-            {
-              trace_id => link.span_context.trace_id,
-              span_id => link.span_context.span_id.unpack1('Q'),
-              attrs => link.attributes
-            }
-          )
-        end
-        out
-      end
-    end
-  end
-end