uptrace 1.0.0.rc1 → 1.0.0.rc3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5f9a4d977dcec234cd8810306f108488708ca23a30ce0836d71d52e5f759033b
-  data.tar.gz: 305152b04753b7febe844a76ff675f192f5d0f939f179b77dfb73a4fd21d71fe
+  metadata.gz: 56199216a5c7984c7896ed2d2480ec7d3ba062dbddc78feb1a640a8ea16d59a5
+  data.tar.gz: f63c2f468a5df9982a7fae3beb3911fe84b8743329f7c73fed8a26aa47851440
 SHA512:
-  metadata.gz: c0593e88e857717b329f4f4d21278efddd605412e3ab63d617eccb3547bbabacaf98ff3f7c68630b90215eff7712cc824c7579e2c5edb78617931b3004b1930b
-  data.tar.gz: d8c976e2e80dbaa0eb323c8c71ee919cac0b53331bec52483b34e0e393dece72914ef21810d4d5c677a1ee8bc8902a6f210d2c814366a9afe940f456ee9fa5c9
+  metadata.gz: d6ac6820d74a2df77286ae3d82cc94c91660cb31d04dfbbe5d2128ff0de645338d71e64658a32efb1e396b23ab8cb65ac86b3e1a3e2644ee00b767496627ab38
+  data.tar.gz: 1361f3804cfa101e125910035234dcc7dafd1c208babcaaca9d675ebb90e25da8c315f8631f7c9c11b832f6c49afd56a8552ba390b9a8d1a0cc939598a591431

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 # 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

data/README.md

@@ -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

@@ -2,6 +2,8 @@
 
 require 'logger'
 
+require 'opentelemetry/exporter/otlp'
+
 # Uptrace provides Uptrace exporters for OpenTelemetry.
 module Uptrace
   extend self
@@ -31,14 +33,30 @@ module Uptrace
   def configure_opentelemetry(dsn: '')
     OpenTelemetry::SDK.configure do |c|
       @client = Client.new(dsn: dsn) unless dsn.empty?
-      c.add_span_processor(client.span_processor) unless client.disabled?
+      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 = '1.0.0.rc1'
+  VERSION = '1.0.0.rc3'
 end

metadata

@@ -1,57 +1,43 @@
 --- !ruby/object:Gem::Specification
 name: uptrace
 version: !ruby/object:Gem::Version
-  version: 1.0.0.rc1
+  version: 1.0.0.rc3
 platform: ruby
 authors:
 - Uptrace Authors
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-05-22 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.4.2
+        version: 0.20.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.4.2
+        version: 0.20.2
 - !ruby/object:Gem::Dependency
   name: opentelemetry-sdk
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.0.0.rc1
+        version: 1.0.0.rc3
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.0.0.rc1
-- !ruby/object:Gem::Dependency
-  name: zstd-ruby
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 1.4.9.0
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 1.4.9.0
+        version: 1.0.0.rc3
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -179,9 +165,6 @@ files:
 - 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:

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,224 +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: span.start_timestamp,
-          endTime: 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] 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: 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