opentelemetry-exporter-google_cloud_trace 0.a → 0.1.1

data/Rakefile

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+# Copyright 2023 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new :test do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList["test/**/*_test.rb"]
+end
+
+require "yard"
+require "yard/rake/yardoc_task"
+YARD::Rake::YardocTask.new do |y|
+  # y.options << "--fail-on-warning"
+end
+
+task :acceptance, :project, :keyfile do |_t, args|
+  project = args[:project]
+  project ||= ENV["TRACE_EXPORTER_TEST_PROJECT"] || ENV["GCLOUD_TEST_PROJECT"]
+  keyfile = args[:keyfile]
+  keyfile ||= ENV["TRACE_EXPORTER_TEST_KEYFILE"] || ENV["GCLOUD_TEST_KEYFILE"]
+  if keyfile
+    keyfile = File.read keyfile
+  end
+  if project.nil? || keyfile.nil?
+    raise "You must provide a project and keyfile. e.g. rake acceptance[test123, /path/to/keyfile.json] or " \
+          "TRACE_EXPORTER_TEST_PROJECT=test123 TRACE_EXPORTER_TEST_KEYFILE=/path/to/keyfile.json rake acceptance"
+  end
+
+  Rake::Task["acceptance:run"].invoke
+end
+
+namespace :acceptance do
+  Rake::TestTask.new :run do |t|
+    t.libs << "acceptance"
+    t.libs << "lib"
+    t.test_files = FileList["acceptance/**/*_test.rb"]
+  end
+end
+
+require "rubocop/rake_task"
+
+RuboCop::RakeTask.new
+
+task default: [:test, :rubocop]

data/acceptance/sinatra/gcp_trace_exporter_test.rb

@@ -0,0 +1,99 @@
+# frozen_string_literal: true
+
+# Copyright 2023 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require "test_helper"
+require "webrick"
+require "fileutils"
+require "google/protobuf/well_known_types"
+
+# Test the Sinatra server for the Cloud Scheduler sample.
+describe "Opentelemety exporter for Google Cloud Trace" do
+  before :all do
+    @project_id = ENV["TRACE_EXPORTER_TEST_PROJECT"] || ENV["GCLOUD_TEST_PROJECT"]
+    Google::Cloud.configure do |config|
+      config.project_id = @project_id
+      config.credentials = ENV["TRACE_EXPORTER_TEST_KEYFILE"] || ENV["GCLOUD_TEST_KEYFILE"]
+    end
+
+    @pid = Process.spawn "bundle exec ruby acceptance/sinatra/sinatra_app.rb"
+
+    # wait for server to start
+    sleep 10
+    @trace_client = Google::Cloud::Trace::V1::TraceService::Client.new
+  end
+
+  after :all do
+    Process.kill "KILL", @pid
+    Process.wait2 @pid
+  end
+
+  it "test_returns_hello_world" do
+    uri = URI("http://127.0.0.1:4567")
+    start_time = Google::Protobuf::Timestamp.from_time Time.now
+    res = Net::HTTP.get uri
+    assert_match "Hello !", res
+    sleep 10 # wait for trace to be sent
+    end_time = Google::Protobuf::Timestamp.from_time Time.now
+
+    assert_trace start_time, end_time
+  end
+end
+
+def assert_trace start_time, end_time
+  result = @trace_client.list_traces project_id: @project_id, start_time: start_time, end_time: end_time
+  traces = result.response.traces
+  test_span = nil
+  parent_span = nil
+
+  traces.each do |trace|
+    full_trace = @trace_client.get_trace project_id: @project_id, trace_id: trace.trace_id
+    full_trace.spans.each do |span|
+      if span.name === "test_span"
+        test_span = span
+        break
+      end
+    end
+
+    if test_span
+      parent_span = full_trace.spans.find { |span| span.span_id === test_span.parent_span_id }
+      break
+    end
+  end
+
+  assert_child_span test_span
+  assert_parent_span parent_span
+end
+
+def assert_child_span span
+  refute_nil span
+  assert_equal span.labels["span_attr"], "span_value"
+end
+
+def assert_parent_span span
+  refute_nil span
+  assert_equal span.kind, :RPC_SERVER
+  assert_equal span.name, "GET /"
+  assert_equal span.labels["g.co/agent"], "opentelemetry-ruby #{OpenTelemetry::SDK::VERSION};" \
+                                          "google-cloud-trace-exporter " \
+                                          "#{OpenTelemetry::Exporter::GoogleCloudTrace::VERSION}"
+  assert_equal span.labels["/http/client_protocol"], "http"
+  assert_equal span.labels["/http/status_code"], "200"
+  assert_equal span.labels["http.target"], "/"
+  assert_equal span.labels["/http/method"], "GET"
+  assert_equal span.labels["/http/host"], "127.0.0.1:4567"
+  assert_equal span.labels["/http/route"], "/"
+  assert_equal span.labels["/http/user_agent"], "Ruby"
+end

data/acceptance/sinatra/sinatra_app.rb

@@ -0,0 +1,25 @@
+require "sinatra"
+require "opentelemetry-sdk"
+require "opentelemetry/instrumentation/sinatra"
+require "opentelemetry/instrumentation/rack"
+require "opentelemetry/exporter/google_cloud_trace"
+
+OpenTelemetry::SDK.configure do |c|
+  c.service_name = "test_app"
+  c.add_span_processor(
+    OpenTelemetry::SDK::Trace::Export::BatchSpanProcessor.new(
+      OpenTelemetry::Exporter::GoogleCloudTrace::SpanExporter.new
+    )
+  )
+  c.use "OpenTelemetry::Instrumentation::Sinatra"
+end
+
+get "/" do
+  test_tracer = OpenTelemetry.tracer_provider.tracer "test_tracer"
+  span_to_link_from = OpenTelemetry::Trace.current_span
+  link = OpenTelemetry::Trace::Link.new(span_to_link_from.context, { "some.attribute" => 12 })
+  test_tracer.in_span "test_span", attributes: { "span_attr" => "span_value" }, links: [link] do |span|
+    span.add_event "Creating test span event!!", attributes: { "event_attr" => "event_value" }
+  end
+  "Hello !"
+end

data/acceptance/test_helper.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+# Copyright 2023 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+require "minitest/autorun"
+require "minitest/focus"
+require "minitest/hooks/default"
+require "minitest/rg"
+require "ostruct"
+require "google/cloud"
+require "google/cloud/trace/v1"
+require "opentelemetry/exporter/google_cloud_trace"

data/lib/opentelemetry/exporter/google_cloud_trace/span_exporter.rb

@@ -0,0 +1,145 @@
+# frozen_string_literal: true
+
+# Copyright 2023 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+require "google/cloud/trace/v2/trace_service"
+require "opentelemetry/exporter/google_cloud_trace/translator"
+require "google/cloud/env"
+
+module OpenTelemetry
+  module Exporter
+    module GoogleCloudTrace
+      ##
+      # This provides an implementation of span exporter for Google Cloud Trace
+      # It will convert the Opentelemetry span data into Clould Trace spans
+      # and publish them to the Cloud trace service.
+      class SpanExporter
+        SUCCESS = OpenTelemetry::SDK::Trace::Export::SUCCESS
+        FAILURE = OpenTelemetry::SDK::Trace::Export::FAILURE
+        private_constant :SUCCESS, :FAILURE
+
+
+        ##
+        # Creates a new object for google cloud trace
+        # opentelemetry span exporter. It creates client for
+        # Google cloud trace service to be used for publihing span.
+        #
+        #
+        # @param [String] project_id Project identifier for the Trace service
+        #   you are connecting to. If not present, the default project for the
+        #   credentials is used.
+        # @param [String, Hash, Google::Auth::Credentials] credentials The path to
+        #   the keyfile as a String, the contents of the keyfile as a Hash, or a
+        #   Google::Auth::Credentials object.
+        # @param [String, Array<String>] scope The OAuth 2.0 scopes controlling
+        #   the set of resources and operations that the connection can access.
+        #   See [Using OAuth 2.0 to Access Google
+        #   APIs](https://developers.google.com/identity/protocols/OAuth2).
+        #
+        #   The default scope is:
+        #
+        #   * `https://www.googleapis.com/auth/trace.append`
+        # @param [Numeric] timeout Default timeout to use in requests. Optional.
+        # @param [String] endpoint Override of the endpoint host name. Optional.
+        #   If the param is nil, uses the default endpoint.
+        #
+        # @return [OpenTelemetry::Exporter::GoogleCloudTrace::SpanExporter]
+        #
+        # @example
+        #   require 'opentelemetry/sdk'
+        #   require 'opentelemetry/instrumentation/all'
+        #   require 'opentelemetry/exporter/google_cloud_trace'
+        #   OpenTelemetry::SDK.configure do |c|
+        #     c.service_name = 'test_app'
+        #     c.add_span_processor(
+        #          OpenTelemetry::SDK::Trace::Export::BatchSpanProcessor.new(
+        #            OpenTelemetry::Exporter::GoogleCloudTrace::SpanExporter.new
+        #          )
+        #        )
+        #     c.use_all() # enables all instrumentation!
+        #   end
+        #
+        def initialize project_id: nil,
+                       credentials: nil,
+                       scope: nil,
+                       timeout: nil,
+                       endpoint: nil
+
+          @client = ::Google::Cloud::Trace::V2::TraceService::Client.new do |config|
+            config.project_id = project_id if project_id
+            config.credentials = credentials if credentials
+            config.scope = scope if scope
+            config.timeout = timeout if timeout
+            config.endpoint = endpoint if endpoint
+          end
+          @project_id = (project_id || default_project_id || credentials&.project_id)
+          @project_id = @project_id.to_s
+          raise ArgumentError, "project_id is missing" if @project_id.empty?
+          @shutdown = false
+          @translator = Translator.new @project_id
+        end
+
+        # rubocop:disable Lint/UnusedMethodArgument
+        # timeout is needed to match Opentelemetry exporter interface
+
+        # Called to export sampled {OpenTelemetry::SDK::Trace::SpanData} structs.
+        #
+        # @param [Enumerable<OpenTelemetry::SDK::Trace::SpanData>] span_data the
+        #   list of recorded {OpenTelemetry::SDK::Trace::SpanData} structs to be
+        #   exported.
+        # @return [Integer] the result of the export.
+        def export span_data, timeout: nil
+          return FAILURE if @shutdown
+
+          begin
+            batch_request = @translator.create_batch span_data
+            @client.batch_write_spans batch_request
+            SUCCESS
+          rescue StandardError
+            FAILURE
+          end
+        end
+
+        # Called when {OpenTelemetry::SDK::Trace::TracerProvider#force_flush} is called, if
+        # this exporter is registered to a {OpenTelemetry::SDK::Trace::TracerProvider}
+        # object.
+        def force_flush timeout: nil
+          SUCCESS
+        end
+
+        # Called when {OpenTelemetry::SDK::Trace::TracerProvider#shutdown} is called, if
+        # this exporter is registered to a {OpenTelemetry::SDK::Trace::TracerProvider}
+        # object.
+        def shutdown timeout: nil
+          @shutdown = true
+          SUCCESS
+        end
+
+        # rubocop:enable Lint/UnusedMethodArgument
+
+        private
+
+        def default_project_id
+          Google::Cloud.env.project_id
+        end
+
+        def shutdown?
+          @shutdown
+        end
+      end
+    end
+  end
+end

data/lib/opentelemetry/exporter/google_cloud_trace/translator.rb

@@ -0,0 +1,239 @@
+# frozen_string_literal: true
+
+# Copyright 2023 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+require "google/protobuf/well_known_types"
+require "google/rpc/status_pb"
+require "google/rpc/code_pb"
+require "opentelemetry/trace/status"
+require "opentelemetry/trace/span_kind"
+require "opentelemetry/exporter/google_cloud_trace/version"
+
+module OpenTelemetry
+  module Exporter
+    module GoogleCloudTrace
+      ##
+      # @private
+      # This class helps translating the opentelemetry
+      # span data [Enumerable<OpenTelemetry::SDK::Trace::SpanData>] into
+      # cloud trace spans [Google::Cloud::Trace::V2::Span]
+      class Translator
+        MAX_LINKS = 128
+        MAX_EVENTS = 32
+        MAX_EVENT_ATTRIBUTES = 4
+        MAX_LINK_ATTRIBUTES = 32
+        MAX_SPAN_ATTRIBUTES = 32
+        MAX_ATTRIBUTES_KEY_BYTES = 128
+        MAX_ATTRIBUTES_VAL_BYTES = 16 * 1024 # 16 kilobytes
+        MAX_DISPLAY_NAME_BYTE_COUNT = 128
+        MAX_EVENT_NAME_BYTE_COUNT = 256
+        LABELS_MAPPING = {
+          "http.scheme": "/http/client_protocol",
+          "http.method": "/http/method",
+          # https://github.com/open-telemetry/opentelemetry-specification/blob/main/specification/trace/semantic_conventions/http.md#common-attributes
+          "http.request_content_length": "/http/request/size",
+          "http.response_content_length": "/http/response/size",
+          "http.route": "/http/route",
+          "http.status_code": "/http/status_code",
+          "http.url": "/http/url",
+          "http.user_agent": "/http/user_agent",
+          "http.host": "/http/host"
+        }.freeze
+
+        def initialize project_id
+          @project_id = project_id
+        end
+
+        # Creates batch_write_spans_request from opentelemetry spans
+        #
+        # @param [Enumerable<OpenTelemetry::SDK::Trace::SpanData>] spans the
+        #   list of recorded {OpenTelemetry::SDK::Trace::SpanData} structs to be
+        #   exported.
+        # @return [Google::Cloud::Trace::V2::BatchWriteSpansRequest]
+        # The request message for the BatchWriteSpans method.
+        def create_batch spans
+          cloud_trace_spans = spans.map do |span|
+            trace_id = span.hex_trace_id
+            span_id = span.hex_span_id
+            parent_id = span.hex_parent_span_id
+            span_name = "projects/#{@project_id}/traces/#{trace_id}/spans/#{span_id}"
+            Google::Cloud::Trace::V2::Span.new(
+              name: span_name,
+              span_id: span_id,
+              parent_span_id: parent_id,
+              display_name: create_name(span.name, MAX_DISPLAY_NAME_BYTE_COUNT),
+              start_time: create_time(span.start_timestamp),
+              end_time: create_time(span.end_timestamp),
+              attributes: create_attributes(span.attributes, MAX_SPAN_ATTRIBUTES, add_agent_attribute: true),
+              links: create_links(span.links),
+              status: create_status(span.status),
+              time_events: create_time_events(span.events),
+              span_kind: create_span_kind(span.kind)
+            )
+          end
+
+          {
+            name: "projects/#{@project_id}",
+            spans: cloud_trace_spans
+          }
+        end
+
+        private
+
+        def create_time epoch
+          return if epoch.nil?
+          time_nsec = Time.at 0, epoch, :nsec # create Time from nanoseconds epoch
+          Google::Protobuf::Timestamp.from_time time_nsec
+        end
+
+        def create_name name, max_bytes
+          truncated_str, truncated_byte_count = truncate_str name, max_bytes
+          Google::Cloud::Trace::V2::TruncatableString.new value: truncated_str,
+                                                          truncated_byte_count: truncated_byte_count
+        end
+
+        def truncate_str str, max_bytes
+          encoded = str.encode "utf-8"
+          truncated_str = encoded.byteslice 0, max_bytes
+          [truncated_str, encoded.length - truncated_str.encode("utf-8").length]
+        end
+
+        def create_attributes attributes, max_attributes, add_agent_attribute: false
+          return if attributes.nil? || attributes.empty?
+          attribute_map = {}
+
+          if add_agent_attribute
+            attribute_map["g.co/agent"] = create_attribute_value(
+              "opentelemetry-ruby #{OpenTelemetry::SDK::VERSION};" \
+              "google-cloud-trace-exporter #{OpenTelemetry::Exporter::GoogleCloudTrace::VERSION}"
+            )
+          end
+
+          attributes.each_pair do |k, v|
+            key = truncate_str(k.to_s, MAX_ATTRIBUTES_KEY_BYTES).first
+            key = LABELS_MAPPING[key.to_sym] if LABELS_MAPPING.key? key.to_sym
+            value = create_attribute_value v
+            attribute_map[key] = value unless value.nil?
+
+            break if attribute_map.count >= max_attributes
+          end
+
+          dropped_attributes_count = attributes.count - attribute_map.count
+          dropped_attributes_count += 1 if add_agent_attribute
+
+          Google::Cloud::Trace::V2::Span::Attributes.new(
+            attribute_map: attribute_map,
+            dropped_attributes_count: dropped_attributes_count
+          )
+        end
+
+        def create_attribute_value value
+          case value
+          when true, false
+            Google::Cloud::Trace::V2::AttributeValue.new bool_value: value
+          when Integer
+            Google::Cloud::Trace::V2::AttributeValue.new int_value: value
+          else
+            Google::Cloud::Trace::V2::AttributeValue.new(
+              string_value: create_name(value.to_s, MAX_ATTRIBUTES_VAL_BYTES)
+            )
+          end
+        end
+
+        def create_links links
+          return if links.nil?
+          dropped_links_count = 0
+
+          if links.length > MAX_LINKS
+            dropped_links_count = links.length - MAX_LINKS
+            links = links[0...MAX_LINKS]
+          end
+
+          trace_links = links.map do |link|
+            trace_id = link.span_context&.hex_trace_id
+            span_id = link.span_context&.hex_span_id
+            Google::Cloud::Trace::V2::Span::Link.new(
+              trace_id: trace_id,
+              span_id: span_id,
+              type: "TYPE_UNSPECIFIED",
+              attributes: create_attributes(link.attributes, MAX_LINK_ATTRIBUTES)
+            )
+          end
+
+          Google::Cloud::Trace::V2::Span::Links.new(
+            link: trace_links,
+            dropped_links_count: dropped_links_count
+          )
+        end
+
+        def create_status status
+          case status.code
+          when OpenTelemetry::Trace::Status::OK
+            Google::Rpc::Status.new code: Google::Rpc::Code::OK, message: status.description
+          when OpenTelemetry::Trace::Status::UNSET
+            nil
+          else
+            Google::Rpc::Status.new code: Google::Rpc::Code::UNKNOWN, message: status.description
+          end
+        end
+
+        def create_time_events events
+          return if events.nil?
+          dropped_message_events_count = 0
+
+          dropped_annotations_count = 0
+          if events.length > MAX_EVENTS
+            dropped_annotations_count = events.length - MAX_EVENTS
+            events = events[0...MAX_EVENTS]
+          end
+
+          time_events = events.map do |event|
+            Google::Cloud::Trace::V2::Span::TimeEvent.new(
+              time: create_time(event.timestamp),
+              annotation: Google::Cloud::Trace::V2::Span::TimeEvent::Annotation.new(
+                description: create_name(event.name, MAX_EVENT_NAME_BYTE_COUNT),
+                attributes: create_attributes(event.attributes, MAX_EVENT_ATTRIBUTES)
+              )
+            )
+          end
+
+          Google::Cloud::Trace::V2::Span::TimeEvents.new(
+            time_event: time_events,
+            dropped_annotations_count: dropped_annotations_count,
+            dropped_message_events_count: dropped_message_events_count
+          )
+        end
+
+        def create_span_kind kind
+          case kind
+          when OpenTelemetry::Trace::SpanKind::INTERNAL
+            Google::Cloud::Trace::V2::Span::SpanKind::INTERNAL
+          when OpenTelemetry::Trace::SpanKind::CLIENT
+            Google::Cloud::Trace::V2::Span::SpanKind::CLIENT
+          when OpenTelemetry::Trace::SpanKind::SERVER
+            Google::Cloud::Trace::V2::Span::SpanKind::SERVER
+          when OpenTelemetry::Trace::SpanKind::PRODUCER
+            Google::Cloud::Trace::V2::Span::SpanKind::PRODUCER
+          when OpenTelemetry::Trace::SpanKind::CONSUMER
+            Google::Cloud::Trace::V2::Span::SpanKind::CONSUMER
+          else
+            Google::Cloud::Trace::V2::Span::SpanKind::SPAN_KIND_UNSPECIFIED
+          end
+        end
+      end
+    end
+  end
+end

data/lib/opentelemetry/exporter/google_cloud_trace/version.rb

@@ -1,10 +1,12 @@
+# frozen_string_literal: true
+
 # Copyright 2023 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
 # You may obtain a copy of the License at
 #
-#     http://www.apache.org/licenses/LICENSE-2.0
+#     https://www.apache.org/licenses/LICENSE-2.0
 #
 # Unless required by applicable law or agreed to in writing, software
 # distributed under the License is distributed on an "AS IS" BASIS,
@@ -12,10 +14,11 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-module Opentelemetry
+
+module OpenTelemetry
   module Exporter
     module GoogleCloudTrace
-      VERSION = "0.a"
+      VERSION = "0.1.1"
     end
   end
 end

data/lib/opentelemetry/exporter/google_cloud_trace.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+# Copyright 2023 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+module OpenTelemetry
+  module Exporter
+    ##
+    # # Google Cloud Trace
+    #
+    # Cloud Trace is a distributed tracing system that collects latency data
+    # from your applications and displays it in the Google Cloud Console.
+    # You can track how requests propagate through your application and
+    # receive detailed near real-time performance insights.
+    # Cloud Trace automatically analyzes all of your application's traces
+    # to generate in-depth latency reports to surface performance degradations,
+    # and can capture traces from all of your VMs, containers, or App Engine projects.
+    module GoogleCloudTrace
+    end
+  end
+end
+
+
+require "opentelemetry/sdk"
+require "opentelemetry/exporter/google_cloud_trace/span_exporter"
+require "opentelemetry/exporter/google_cloud_trace/version"

data/lib/opentelemetry-exporter-google_cloud_trace.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+# Copyright 2023 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require "opentelemetry/exporter/google_cloud_trace"