Draft: Logs SDK, OTLP exporter

api/lib/opentelemetry.rb

@@ -28,7 +28,11 @@ module OpenTelemetry
 
   # @return [Object, Logger] configured Logger or a default STDOUT Logger.
   def logger
-    @logger ||= Logger.new($stdout, level: ENV['OTEL_LOG_LEVEL'] || Logger::INFO)
+    @logger ||= create_logger
+    # alternately: Logger.new($stdout, level: ENV['OTEL_LOG_LEVEL'] || Logger::INF, progname: 'OpenTelemetry')
+    # and clean up the log messages that are prefixed with "OpenTelemetry"
+    # if we want log records generated for OpenTelemetry logs, I think we can do that, but I imagine this is
+    # "untraced" territory
   end
 
   # @return [Callable] configured error handler or a default that logs the
@@ -69,4 +73,15 @@ def tracer_provider
   def propagation
     @propagation ||= Context::Propagation::NoopTextMapPropagator.new
   end
+
+  private
+
+  def create_logger
+    logger = Logger.new($stdout, level: ENV['OTEL_LOG_LEVEL'] || Logger::INFO)
+    # @skip_instrumenting prevents Ruby Logger instrumentation from
+    # triggering a stack overflow. Logs emitted using OpenTelemetry.logger
+    # will not be turned into OpenTelemetry LogRecords.
+    logger.instance_variable_set(:@skip_instrumenting, true)
+    logger
+  end
 end

exporter/otlp-logs/.rubocop.yml

@@ -0,0 +1,42 @@
+AllCops:
+  TargetRubyVersion: "3.0"
+  NewCops: disable
+  SuggestExtensions: false
+  Exclude:
+    - "lib/opentelemetry/proto/**/*"
+    - "vendor/**/*"
+
+Bundler/OrderedGems:
+  Exclude:
+    - gemfiles/**/*
+Lint/UnusedMethodArgument:
+  Enabled: false
+Lint/MissingSuper:
+  Enabled: false
+Lint/ConstantDefinitionInBlock:
+  Exclude:
+    - "test/**/*"
+Style/StringConcatenation:
+  Exclude:
+    - "test/**/*"
+Metrics/AbcSize:
+  Enabled: false
+Layout/LineLength:
+  Enabled: false
+Metrics/MethodLength:
+  Max: 20
+Metrics/ParameterLists:
+  Enabled: false
+Style/FrozenStringLiteralComment:
+  Exclude:
+    - gemfiles/**/*
+Style/ModuleFunction:
+  Enabled: false
+Style/StringLiterals:
+  Exclude:
+    - gemfiles/**/*
+Metrics/BlockLength:
+  Enabled: false
+Naming/FileName:
+  Exclude:
+    - "lib/opentelemetry-exporter-otlp.rb"

exporter/otlp-logs/.yardopts

@@ -0,0 +1,9 @@
+--no-private
+--title=OpenTelemetry OTLP Logs Exporter
+--markup=markdown
+--main=README.md
+./lib/opentelemetry/exporter/otlp-logs/**/*.rb
+./lib/opentelemetry/exporter/otlp.rb
+-
+README.md
+CHANGELOG.md

exporter/otlp-logs/Appraisals

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+# Copyright The OpenTelemetry Authors
+#
+# SPDX-License-Identifier: Apache-2.0
+
+(14..23).each do |i|
+  version = "3.#{i}"
+  appraise "google-protobuf-#{version}" do
+    gem 'google-protobuf', "~> #{version}"
+  end
+end

exporter/otlp-logs/CHANGELOG.md

@@ -0,0 +1,182 @@
+# 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 
+
+### v0.25.0 / 2023-06-01
+
+* BREAKING CHANGE: Remove support for EoL Ruby 2.7 
+
+* ADDED: Remove support for EoL Ruby 2.7 
+* FIXED: Make version available to user agent header #1458
+
+### v0.24.1 / 2023-05-30
+
+* FIXED: Add Ruby 3.2 to CI and do small fix 
+* FIXED: Adds User-Agent header in OTLP exporter 
+
+### v0.24.0 / 2022-09-14
+
+* ADDED: Support InstrumentationScope, and update OTLP proto to 0.18.0 
+* FIXED: Handle OTLP exporter 404s discretely 
+* FIXED: `OTEL_EXPORTER_OTLP_ENDPOINT` appends the correct path with a trailing slash 
+* FIXED: OTLP exporter demo code 
+* DOCS: Update exporter default compression setting 
+
+### v0.23.0 / 2022-06-23
+
+* ADDED: Report bundle size stats in exporter; also don't re-gzip unnecessarily 
+
+### v0.22.0 / 2022-06-09
+
+* ADDED: Otlp grpc 
+
+### v0.21.3 / 2022-05-12
+
+* (No significant changes)
+
+### v0.21.2 / 2022-01-19
+
+* FIXED: Default scheme for OTLP endpoint 
+* FIXED: Remove TIMEOUT status from OTLP exporter (#1087)
+
+### v0.21.1 / 2021-12-31
+
+* FIXED: Allow OTLP Exporter compression value of `none` 
+
+### v0.21.0 / 2021-12-01
+
+* ADDED: Exporter should use gzip compression by default 
+
+### v0.20.6 / 2021-10-29
+
+* FIXED: Add unexpected error handlign in BSP and OTLP exporter (#995)
+* FIXED: Handle otlp exporter race condition gzip errors with retry 
+
+### v0.20.5 / 2021-09-29
+
+* (No significant changes)
+
+### v0.20.4 / 2021-09-29
+
+* FIXED: OTLP Export Header Format 
+
+### v0.20.3 / 2021-08-19
+
+* FIXED: OTLP exporter missing failure metrics 
+
+### v0.20.2 / 2021-08-12
+
+* FIXED: Add rescue for OpenSSL errors during export 
+* DOCS: Update docs to rely more on environment variable configuration 
+
+### v0.20.1 / 2021-06-29
+
+* FIXED: Otlp encoding exceptions again 
+
+### v0.20.0 / 2021-06-23
+
+* BREAKING CHANGE: Total order constraint on span.status= 
+
+* FIXED: Total order constraint on span.status= 
+
+### v0.19.0 / 2021-06-03
+
+* ADDED: Add a SSL verify mode option for the OTLP exporter 
+* FIXED: Handle OTLP exporter encoding exceptions 
+* DOCS: Remove the OTLP receiver legacy gRPC port(55680) references 
+
+### v0.18.0 / 2021-05-21
+
+* BREAKING CHANGE: Replace Time.now with Process.clock_gettime 
+
+* FIXED: Replace Time.now with Process.clock_gettime 
+* FIXED: Rescue missed otlp exporter network errors 
+
+### v0.17.0 / 2021-04-22
+
+* ADDED: Add zipkin exporter 
+
+### v0.16.0 / 2021-03-17
+
+* BREAKING CHANGE: Implement Exporter#force_flush 
+
+* ADDED: Implement Exporter#force_flush 
+* FIXED: Rescue socket err in otlp exporter to prevent failures unable to  connect 
+* DOCS: Replace Gitter with GitHub Discussions 
+
+### v0.15.0 / 2021-02-18
+
+* BREAKING CHANGE: Streamline processor pipeline 
+
+* ADDED: Add otlp exporter hooks 
+* FIXED: Streamline processor pipeline 
+
+### v0.14.0 / 2021-02-03
+
+* (No significant changes)
+
+### v0.13.0 / 2021-01-29
+
+* BREAKING CHANGE: Spec compliance for OTLP exporter 
+
+* ADDED: Add untraced wrapper to common utils 
+* FIXED: Spec compliance for OTLP exporter 
+* FIXED: Conditionally append path to collector endpoint 
+* FIXED: OTLP path should be /v1/traces 
+* FIXED: Rename OTLP env vars SPAN -> TRACES 
+
+### v0.12.1 / 2021-01-13
+
+* FIXED: Updated protobuf version dependency
+
+### v0.12.0 / 2020-12-24
+
+* (No significant changes)
+
+### v0.11.0 / 2020-12-11
+
+* BREAKING CHANGE: Implement tracestate 
+
+* ADDED: Implement tracestate 
+* ADDED: Metrics reporting from trace export 
+* FIXED: Copyright comments to not reference year 
+
+### v0.10.0 / 2020-12-03
+
+* (No significant changes)
+
+### v0.9.0 / 2020-11-27
+
+* BREAKING CHANGE: Add timeout for force_flush and shutdown 
+
+* ADDED: Add timeout for force_flush and shutdown 
+* FIXED: Remove unused kwarg from otlp exporter retry 
+
+### v0.8.0 / 2020-10-27
+
+* BREAKING CHANGE: Move context/span methods to Trace module 
+* BREAKING CHANGE: Remove 'canonical' from status codes 
+* BREAKING CHANGE: Assorted SpanContext fixes 
+
+* FIXED: Move context/span methods to Trace module 
+* FIXED: Remove 'canonical' from status codes 
+* FIXED: Add gzip support to OTLP exporter 
+* FIXED: Assorted SpanContext fixes 
+
+### v0.7.0 / 2020-10-07
+
+* FIXED: OTLP parent_span_id should be nil for root 
+* DOCS: Fix use of add_event in OTLP doc 
+* DOCS: Standardize toplevel docs structure and readme 
+* DOCS: Use BatchSpanProcessor in examples 
+
+### v0.6.0 / 2020-09-10
+
+* Initial release.

exporter/otlp-logs/Gemfile

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+# Copyright The OpenTelemetry Authors
+#
+# SPDX-License-Identifier: Apache-2.0
+
+source 'https://rubygems.org'
+
+gemspec
+
+group :test, :development do
+  gem 'opentelemetry-api', path: '../../api'
+  gem 'opentelemetry-common', path: '../../common'
+  gem 'opentelemetry-logs-api', path: '../../logs_api'
+  gem 'opentelemetry-logs-sdk', path: '../../logs_sdk'
+  gem 'opentelemetry-registry', path: '../../registry'
+  gem 'opentelemetry-sdk', path: '../../sdk'
+  gem 'opentelemetry-semantic_conventions', path: '../../semantic_conventions'
+  gem 'opentelemetry-test-helpers', path: '../../test_helpers'
+end