uptrace 0.16.2 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6e560d02dc7fff00fe1417273235f621093fddf1dd2b89fec8eb26f25ec77137
-  data.tar.gz: f4425d572581c3b8863891e7f1df56c1acc2a8df19e96d56c5fadc138b147fd6
+  metadata.gz: 72bfd8148792008a3e5b234beb4394e78aeb5daf7e1e58e4be6cf17307426c83
+  data.tar.gz: 5dcb5720cdcfd03a638c714ed5348b3a59a495e4545d77ab17c2ee8c491545c8
 SHA512:
-  metadata.gz: f9d888b255f9b97deb19d115bfc0a16eca449a79df08c6262557be002f98460a3ba1db188caf5cf2266e7cbbe92aefd5fec1567a7c398ddcd04021f4315324e2
-  data.tar.gz: d831ec671858212f78caeadba72689d0735b0c85579af3bcec992e5df83c62d40af0a447dea647f0a28c993f277f8e3ecfbaa9aa9ef348734912523ecc947f26
+  metadata.gz: 32797cae23ce4a51cf174cd2b9140398e2e824c19e2f1ddc0a90bbe6e991ec0d77ef44525979a1490fad4f5da866eef281e3bef1af0bbb62596cb8d10a0b01c8
+  data.tar.gz: 1fda6cbf14c17f2db89812bd282d24c6b0c23fcf7a74afbbfa0584e6dd06795dcd10e9a17c31552ae5e279a15d7f3d0a064ba454b0c6d87c12dbc0e66c0ace9b

data/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## v1.0.0 - 2021-10-06
+
+- Updated OpenTelemetry to
+  [v1.0.0](https://github.com/open-telemetry/opentelemetry-ruby/blob/main/api/CHANGELOG.md#v100--2021-09-29).
+
+## 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

data/README.md

@@ -3,8 +3,8 @@
 ![build workflow](https://github.com/uptrace/uptrace-ruby/actions/workflows/build.yml/badge.svg)
 [![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" />
+<a href="https://docs.uptrace.dev/guide/ruby.html">
+  <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/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.2'
+  VERSION = '1.0.0'
 end

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'

metadata

@@ -1,71 +1,57 @@
 --- !ruby/object:Gem::Specification
 name: uptrace
 version: !ruby/object:Gem::Version
-  version: 0.16.2
+  version: 1.0.0
 platform: ruby
 authors:
 - Uptrace Authors
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-03-28 00:00:00.000000000 Z
+date: 2021-10-06 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.5
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.3'
+        version: 0.20.5
 - !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
   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
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.17'
+        version: '2.2'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.17'
+        version: '2.2'
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
@@ -100,14 +86,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.10.0
+        version: 1.12.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.10.0
+        version: 1.12.0
 - !ruby/object:Gem::Dependency
   name: rubocop-minitest
   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/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

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'