opentelemetry-exporter-otlp 0.26.0 → 0.26.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6ea9c42597a6b63fe341e3003bee8ffbba2a6e3c5a74e3ddc4ff30ae41345b2e
-  data.tar.gz: b1714933dff93b3e4403732872ac211a5c3562ff6dbed90c739e132e408a2c01
+  metadata.gz: fb071dc1c0134311f132447de543f3ca59c2f0180f1fce9e5a944649626b0afc
+  data.tar.gz: 67bbd4fcfdb43ff12e0634de1c2fb1894de132cf5ebab5d52f78762a007f266c
 SHA512:
-  metadata.gz: 63b1cdc9d52ca362f06546936a475cbdce954452833057dbf6797443d8a2d728fddc417cc5d8c3fb1a1c6c0dcc44315ca2484e921d1d80a9ed00b4541d87f53b
-  data.tar.gz: d18de69cd1466058ff2af29e38a6015342acbb1baabd7eb7e8022f7ee715202fd8e271edcfd7fde510e0ea67c3fbf378e5428b1600e07d16c800f03f5d59ff39
+  metadata.gz: 64cbdfa923fd9c836a4d315d44798df650b74b31936024300562e3d65a688166e5ce3c8e518db6047f908f1411bb9ebb00ce3fa9246c1cae0fcf24b7ccaea968
+  data.tar.gz: 1a47dabce4a7ae7f623ee533fa8e99287efcc12e873153f6fe1966039cde385df7d38ba90472694843aaccdf6bcabea13cf76c36d4f1c6dd6e57a72d1494ec63

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Release History: opentelemetry-exporter-otlp
 
+### v0.26.1 / 2023-07-29
+
+* FIXED: Regenerate v0.20.0 protos
+* ADDED: Allow google-protobuf ~> 3.14
+
 ### v0.26.0 / 2023-06-13
 
 * ADDED: Use OTLP 0.20.0 protos 

data/README.md

@@ -16,15 +16,17 @@ Generally, *libraries* that produce telemetry data should avoid depending direct
 
 ### Supported protocol version
 
-This gem supports the [v0.4.0 release](https://github.com/open-telemetry/opentelemetry-proto/releases/tag/v0.4.0) of OTLP.
+This gem supports the [v0.20.0 release][otel-proto-release] of OTLP.
 
 ## How do I get started?
 
 Install the gem using:
 
-```
+```console
+
 gem install opentelemetry-sdk
 gem install opentelemetry-exporter-otlp
+
 ```
 
 Or, if you use [bundler][bundler-home], include `opentelemetry-sdk` in your `Gemfile`.
@@ -93,6 +95,48 @@ The OpenTelemetry Ruby gems are maintained by the OpenTelemetry-Ruby special int
 
 The `opentelemetry-exporter-otlp` gem is distributed under the Apache 2.0 license. See [LICENSE][license-github] for more information.
 
+## Working with Proto Definitions
+
+The OTel community maintains a [repository with protobuf definitions][otel-proto-github] that language and collector implementors use to generate code.
+
+Maintainers are expected to keep up to date with the latest version of protos. This guide will provide you with step-by-step instructions on updating the OTLP Exporter gem with the latest definitions.
+
+### System Requirements
+
+- [`git` 2.41+][git-install]
+- [`protoc` 22.5][protoc-install]
+- [Ruby 3+][ruby-downloads]
+
+> :warning: `protoc 23.x` *changes the Ruby code generator to emit a serialized proto instead of a DSL.* <https://protobuf.dev/news/2023-04-20/>. Please ensure you use `protoc` version `22.x` in order to ensure we remain compatible with versions of protobuf prior to `google-protobuf` gem `3.18`.
+
+### Upgrade Proto Definitions
+
+**Update the target otel-proto version in the `Rakefile` that matches a release `tag` in the proto repo, e.g.**
+
+```ruby
+  # Rakefile
+
+  # https://github.com/open-telemetry/opentelemetry-proto/tree/v0.20.0
+  PROTO_VERSION = `v0.20.0`
+```
+
+**Generate the Ruby source files using `rake`:**
+
+```console
+
+$> bundle exec rake protobuf:generate
+
+```
+
+**Run tests and fix any errors:**
+
+```console
+
+$> bundle exec rake test
+
+```
+
+**Commit the chnages and open a PR!**
 
 [opentelemetry-collector-home]: https://opentelemetry.io/docs/collector/about/
 [opentelemetry-home]: https://opentelemetry.io
@@ -103,3 +147,8 @@ The `opentelemetry-exporter-otlp` gem is distributed under the Apache 2.0 licens
 [ruby-sig]: https://github.com/open-telemetry/community#ruby-sig
 [community-meetings]: https://github.com/open-telemetry/community#community-meetings
 [discussions-url]: https://github.com/open-telemetry/opentelemetry-ruby/discussions
+[git-install]: https://git-scm.com/book/en/v2/Getting-Started-Installing-Git
+[protoc-install]: https://github.com/protocolbuffers/protobuf/releases/tag/v22.5
+[ruby-downloads]: https://www.ruby-lang.org/en/downloads/
+[otel-proto-github]: https://github.com/open-telemetry/opentelemetry-proto
+[otel-proto-release]: https://github.com/open-telemetry/opentelemetry-proto/releases/tag/v0.20.0

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

@@ -8,7 +8,7 @@ module OpenTelemetry
   module Exporter
     module OTLP
       ## Current OpenTelemetry OTLP exporter version
-      VERSION = '0.26.0'
+      VERSION = '0.26.1'
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: opentelemetry-exporter-otlp
 version: !ruby/object:Gem::Version
-  version: 0.26.0
+  version: 0.26.1
 platform: ruby
 authors:
 - OpenTelemetry Authors
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-06-14 00:00:00.000000000 Z
+date: 2023-08-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: googleapis-common-protos-types
@@ -30,14 +30,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.19'
+        version: '3.14'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.19'
+        version: '3.14'
 - !ruby/object:Gem::Dependency
   name: opentelemetry-api
   requirement: !ruby/object:Gem::Requirement
@@ -94,6 +94,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: appraisal
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.2.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.2.0
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -264,25 +278,21 @@ files:
 - lib/opentelemetry/exporter/otlp/exporter.rb
 - lib/opentelemetry/exporter/otlp/version.rb
 - lib/opentelemetry/proto/collector/logs/v1/logs_service_pb.rb
-- lib/opentelemetry/proto/collector/logs/v1/logs_service_services_pb.rb
 - lib/opentelemetry/proto/collector/metrics/v1/metrics_service_pb.rb
-- lib/opentelemetry/proto/collector/metrics/v1/metrics_service_services_pb.rb
 - lib/opentelemetry/proto/collector/trace/v1/trace_service_pb.rb
-- lib/opentelemetry/proto/collector/trace/v1/trace_service_services_pb.rb
 - lib/opentelemetry/proto/common/v1/common_pb.rb
 - lib/opentelemetry/proto/logs/v1/logs_pb.rb
 - lib/opentelemetry/proto/metrics/v1/metrics_pb.rb
 - lib/opentelemetry/proto/resource/v1/resource_pb.rb
-- lib/opentelemetry/proto/trace/v1/trace_config_pb.rb
 - lib/opentelemetry/proto/trace/v1/trace_pb.rb
 homepage: https://github.com/open-telemetry/opentelemetry-ruby
 licenses:
 - Apache-2.0
 metadata:
-  changelog_uri: https://open-telemetry.github.io/opentelemetry-ruby/opentelemetry-exporter-otlp/v0.26.0/file.CHANGELOG.html
+  changelog_uri: https://open-telemetry.github.io/opentelemetry-ruby/opentelemetry-exporter-otlp/v0.26.1/file.CHANGELOG.html
   source_code_uri: https://github.com/open-telemetry/opentelemetry-ruby/tree/main/exporter/otlp
   bug_tracker_uri: https://github.com/open-telemetry/opentelemetry-ruby/issues
-  documentation_uri: https://open-telemetry.github.io/opentelemetry-ruby/opentelemetry-exporter-otlp/v0.26.0
+  documentation_uri: https://open-telemetry.github.io/opentelemetry-ruby/opentelemetry-exporter-otlp/v0.26.1
 post_install_message: 
 rdoc_options: []
 require_paths:

data/lib/opentelemetry/proto/collector/logs/v1/logs_service_services_pb.rb

@@ -1,50 +0,0 @@
-# Generated by the protocol buffer compiler.  DO NOT EDIT!
-# Source: opentelemetry/proto/collector/logs/v1/logs_service.proto for package 'opentelemetry.proto.collector.logs.v1'
-# Original file comments:
-# Copyright 2020, OpenTelemetry Authors
-#
-# 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
-#
-# 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 'grpc'
-require 'opentelemetry/proto/collector/logs/v1/logs_service_pb'
-
-module Opentelemetry
-  module Proto
-    module Collector
-      module Logs
-        module V1
-          module LogsService
-            # Service that can be used to push logs between one Application instrumented with
-            # OpenTelemetry and an collector, or between an collector and a central collector (in this
-            # case logs are sent/received to/from multiple Applications).
-            class Service
-
-              include ::GRPC::GenericService
-
-              self.marshal_class_method = :encode
-              self.unmarshal_class_method = :decode
-              self.service_name = 'opentelemetry.proto.collector.logs.v1.LogsService'
-
-              # For performance reasons, it is recommended to keep this RPC
-              # alive for the entire life of the application.
-              rpc :Export, ::Opentelemetry::Proto::Collector::Logs::V1::ExportLogsServiceRequest, ::Opentelemetry::Proto::Collector::Logs::V1::ExportLogsServiceResponse
-            end
-
-            Stub = Service.rpc_stub_class
-          end
-        end
-      end
-    end
-  end
-end

data/lib/opentelemetry/proto/collector/metrics/v1/metrics_service_services_pb.rb

@@ -1,50 +0,0 @@
-# Generated by the protocol buffer compiler.  DO NOT EDIT!
-# Source: opentelemetry/proto/collector/metrics/v1/metrics_service.proto for package 'opentelemetry.proto.collector.metrics.v1'
-# Original file comments:
-# Copyright 2019, OpenTelemetry Authors
-#
-# 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
-#
-# 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 'grpc'
-require 'opentelemetry/proto/collector/metrics/v1/metrics_service_pb'
-
-module Opentelemetry
-  module Proto
-    module Collector
-      module Metrics
-        module V1
-          module MetricsService
-            # Service that can be used to push metrics between one Application
-            # instrumented with OpenTelemetry and a collector, or between a collector and a
-            # central collector.
-            class Service
-
-              include ::GRPC::GenericService
-
-              self.marshal_class_method = :encode
-              self.unmarshal_class_method = :decode
-              self.service_name = 'opentelemetry.proto.collector.metrics.v1.MetricsService'
-
-              # For performance reasons, it is recommended to keep this RPC
-              # alive for the entire life of the application.
-              rpc :Export, ::Opentelemetry::Proto::Collector::Metrics::V1::ExportMetricsServiceRequest, ::Opentelemetry::Proto::Collector::Metrics::V1::ExportMetricsServiceResponse
-            end
-
-            Stub = Service.rpc_stub_class
-          end
-        end
-      end
-    end
-  end
-end

data/lib/opentelemetry/proto/collector/trace/v1/trace_service_services_pb.rb

@@ -1,50 +0,0 @@
-# Generated by the protocol buffer compiler.  DO NOT EDIT!
-# Source: opentelemetry/proto/collector/trace/v1/trace_service.proto for package 'opentelemetry.proto.collector.trace.v1'
-# Original file comments:
-# Copyright 2019, OpenTelemetry Authors
-#
-# 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
-#
-# 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 'grpc'
-require 'opentelemetry/proto/collector/trace/v1/trace_service_pb'
-
-module Opentelemetry
-  module Proto
-    module Collector
-      module Trace
-        module V1
-          module TraceService
-            # Service that can be used to push spans between one Application instrumented with
-            # OpenTelemetry and a collector, or between a collector and a central collector (in this
-            # case spans are sent/received to/from multiple Applications).
-            class Service
-
-              include ::GRPC::GenericService
-
-              self.marshal_class_method = :encode
-              self.unmarshal_class_method = :decode
-              self.service_name = 'opentelemetry.proto.collector.trace.v1.TraceService'
-
-              # For performance reasons, it is recommended to keep this RPC
-              # alive for the entire life of the application.
-              rpc :Export, ::Opentelemetry::Proto::Collector::Trace::V1::ExportTraceServiceRequest, ::Opentelemetry::Proto::Collector::Trace::V1::ExportTraceServiceResponse
-            end
-
-            Stub = Service.rpc_stub_class
-          end
-        end
-      end
-    end
-  end
-end

data/lib/opentelemetry/proto/trace/v1/trace_config_pb.rb

@@ -1,49 +0,0 @@
-# Generated by the protocol buffer compiler.  DO NOT EDIT!
-# source: opentelemetry/proto/trace/v1/trace_config.proto
-
-require 'google/protobuf'
-
-Google::Protobuf::DescriptorPool.generated_pool.build do
-  add_file("opentelemetry/proto/trace/v1/trace_config.proto", :syntax => :proto3) do
-    add_message "opentelemetry.proto.trace.v1.TraceConfig" do
-      optional :max_number_of_attributes, :int64, 4
-      optional :max_number_of_timed_events, :int64, 5
-      optional :max_number_of_attributes_per_timed_event, :int64, 6
-      optional :max_number_of_links, :int64, 7
-      optional :max_number_of_attributes_per_link, :int64, 8
-      oneof :sampler do
-        optional :constant_sampler, :message, 1, "opentelemetry.proto.trace.v1.ConstantSampler"
-        optional :trace_id_ratio_based, :message, 2, "opentelemetry.proto.trace.v1.TraceIdRatioBased"
-        optional :rate_limiting_sampler, :message, 3, "opentelemetry.proto.trace.v1.RateLimitingSampler"
-      end
-    end
-    add_message "opentelemetry.proto.trace.v1.ConstantSampler" do
-      optional :decision, :enum, 1, "opentelemetry.proto.trace.v1.ConstantSampler.ConstantDecision"
-    end
-    add_enum "opentelemetry.proto.trace.v1.ConstantSampler.ConstantDecision" do
-      value :ALWAYS_OFF, 0
-      value :ALWAYS_ON, 1
-      value :ALWAYS_PARENT, 2
-    end
-    add_message "opentelemetry.proto.trace.v1.TraceIdRatioBased" do
-      optional :samplingRatio, :double, 1
-    end
-    add_message "opentelemetry.proto.trace.v1.RateLimitingSampler" do
-      optional :qps, :int64, 1
-    end
-  end
-end
-
-module Opentelemetry
-  module Proto
-    module Trace
-      module V1
-        TraceConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("opentelemetry.proto.trace.v1.TraceConfig").msgclass
-        ConstantSampler = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("opentelemetry.proto.trace.v1.ConstantSampler").msgclass
-        ConstantSampler::ConstantDecision = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("opentelemetry.proto.trace.v1.ConstantSampler.ConstantDecision").enummodule
-        TraceIdRatioBased = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("opentelemetry.proto.trace.v1.TraceIdRatioBased").msgclass
-        RateLimitingSampler = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("opentelemetry.proto.trace.v1.RateLimitingSampler").msgclass
-      end
-    end
-  end
-end