Merge branch 'main' into metrics-asynchronous

.github/workflows/ci.yml

@@ -87,6 +87,7 @@ jobs:
           - opentelemetry-exporter-otlp-grpc
           - opentelemetry-exporter-otlp-http
           - opentelemetry-exporter-zipkin
+          - opentelemetry-exporter-otlp-logs
           - opentelemetry-exporter-otlp-metrics
         os:
           - ubuntu-latest
@@ -134,8 +135,9 @@ jobs:
           echo "skip=false" >> $GITHUB_OUTPUT
           [[ "${{ matrix.gem }}" == "opentelemetry-exporter-otlp"        ]] && echo "skip=true" >> $GITHUB_OUTPUT
           [[ "${{ matrix.gem }}" == "opentelemetry-exporter-otlp-common" ]] && echo "skip=true" >> $GITHUB_OUTPUT
-          [[ "${{ matrix.gem }}" == "opentelemetry-exporter-otlp-http"   ]] && echo "skip=true" >> $GITHUB_OUTPUT
           [[ "${{ matrix.gem }}" == "opentelemetry-exporter-otlp-grpc"   ]] && echo "skip=true" >> $GITHUB_OUTPUT
+          [[ "${{ matrix.gem }}" == "opentelemetry-exporter-otlp-http"   ]] && echo "skip=true" >> $GITHUB_OUTPUT
+          [[ "${{ matrix.gem }}" == "opentelemetry-exporter-otlp-logs" ]] && echo "skip=true" >> $GITHUB_OUTPUT
           [[ "${{ matrix.gem }}" == "opentelemetry-exporter-otlp-metrics" ]] && echo "skip=true" >> $GITHUB_OUTPUT
           # This is essentially a bash script getting evaluated, so we need to return true or the whole job fails.
           true

.toys/.data/releases.yml

@@ -63,6 +63,10 @@ gems:
     directory: exporter/otlp
     version_constant: [OpenTelemetry, Exporter, OTLP, VERSION]
 
+  - name: opentelemetry-exporter-otlp-logs
+    directory: exporter/otlp-logs
+    version_constant: [OpenTelemetry, Exporter, OTLP, Logs, VERSION]
+
   - name: opentelemetry-exporter-otlp-metrics
     directory: exporter/otlp-metrics
     version_constant: [OpenTelemetry, Exporter, OTLP, Metrics, VERSION]
@@ -98,3 +102,13 @@ gems:
     directory: metrics_sdk
     version_rb_path: lib/opentelemetry/sdk/metrics/version.rb
     version_constant: [OpenTelemetry, SDK, Metrics, VERSION]
+
+  - name: opentelemetry-logs-api
+    directory: logs_api
+    version_rb_path: lib/opentelemetry/logs/version.rb
+    version_constant: [OpenTelemetry, Logs, VERSION]
+
+  - name: opentelemetry-logs-sdk
+    directory: logs_sdk
+    version_rb_path: lib/opentelemetry/sdk/logs/version.rb
+    version_constant: [OpenTelemetry, SDK, Logs, VERSION]

examples/http/Gemfile

@@ -2,9 +2,10 @@
 
 source "https://rubygems.org"
 
-gem "faraday", "~> 0.16.1"
+gem "faraday", "~> 2.0"
 gem "opentelemetry-api"
 gem "opentelemetry-common"
 gem "opentelemetry-sdk"
-gem "sinatra", "~> 2.0"
+gem "sinatra", "~> 4.1"
 gem "puma"
+gem "rackup"

examples/logs_sdk/logs_console.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require 'bundler/inline'
+
+gemfile(true) do
+  source 'https://rubygems.org'
+
+  gem 'opentelemetry-logs-api', path: '../../logs_api'
+  gem 'opentelemetry-logs-sdk', path: '../../logs_sdk'
+end
+
+require 'opentelemetry-logs-sdk'
+
+# Create a LoggerProvider
+logger_provider = OpenTelemetry::SDK::Logs::LoggerProvider.new
+# Create a batching processor configured to export to the OTLP exporter
+processor = OpenTelemetry::SDK::Logs::Export::SimpleLogRecordProcessor.new(OpenTelemetry::SDK::Logs::Export::ConsoleLogRecordExporter.new)
+# Add the processor to the LoggerProvider
+logger_provider.add_log_record_processor(processor)
+# Access a Logger for your library from your LoggerProvider
+logger = logger_provider.logger(name: 'my_app_or_gem', version: '0.1.0')
+
+# Use your Logger to  emit a log record
+logger.on_emit(
+  timestamp: Time.now,
+  severity_text: 'INFO',
+  body: 'Thuja plicata',
+  attributes: { 'cedar' => true },
+)
+
+logger_provider.shutdown

examples/logs_sdk/logs_console_with_sdk.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require 'bundler/inline'
+
+gemfile(true) do
+  source 'https://rubygems.org'
+
+  gem 'opentelemetry-sdk', path: '../../sdk'
+  gem 'opentelemetry-logs-api', path: '../../logs_api'
+  gem 'opentelemetry-logs-sdk', path: '../../logs_sdk'
+end
+
+require 'opentelemetry-sdk'
+require 'opentelemetry-logs-sdk'
+
+# Export logs to the console
+ENV['OTEL_LOGS_EXPORTER'] = 'console'
+
+# Configure SDK with defaults, this will apply the OTEL_LOGS_EXPORTER env var
+OpenTelemetry::SDK.configure
+
+# Access a Logger for your library from the LoggerProvider configured by the OpenTelemetry API
+logger = OpenTelemetry.logger_provider.logger(name: 'my_app_or_gem', version: '0.1.0')
+
+# Use your Logger to emit a log record
+logger.on_emit(
+  timestamp: Time.now,
+  severity_text: 'INFO',
+  body: 'Thuja plicata',
+  attributes: { 'cedar' => true },
+)

examples/logs_sdk/logs_otlp.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require 'bundler/inline'
+
+gemfile(true) do
+  source 'https://rubygems.org'
+
+  gem 'opentelemetry-logs-api', path: '../../logs_api'
+  gem 'opentelemetry-logs-sdk', path: '../../logs_sdk'
+  gem 'opentelemetry-exporter-otlp-logs', path: '../../exporter/otlp-logs'
+end
+
+require 'opentelemetry-logs-sdk'
+require 'opentelemetry/exporter/otlp_logs'
+
+# Create a LoggerProvider
+logger_provider = OpenTelemetry::SDK::Logs::LoggerProvider.new
+# Create a batching processor configured to export to the OTLP exporter
+processor = OpenTelemetry::SDK::Logs::Export::BatchLogRecordProcessor.new(OpenTelemetry::Exporter::OTLP::Logs::LogsExporter.new)
+# Add the processor to the LoggerProvider
+logger_provider.add_log_record_processor(processor)
+# Access a Logger for your library from your LoggerProvider
+logger = logger_provider.logger(name: 'my_app_or_gem', version: '0.1.0')
+
+# Use your Logger to  emit a log record
+logger.on_emit(
+  timestamp: Time.now,
+  severity_text: 'INFO',
+  body: 'Thuja plicata',
+  attributes: { 'cedar' => true },
+)
+
+logger_provider.shutdown

exporter/otlp-logs/.rubocop.yml

@@ -0,0 +1,19 @@
+inherit_from:
+  - ../../contrib/rubocop.yml
+
+AllCops:
+  Exclude:
+    - "lib/opentelemetry/proto/**/*"
+    - "vendor/**/*"
+
+Naming/FileName:
+  Exclude:
+    - lib/opentelemetry-exporter-otlp-logs.rb
+Style/StringLiterals:
+  Exclude:
+    - gemfiles/**/*
+Style/FrozenStringLiteralComment:
+  Exclude:
+    - gemfiles/**/*
+Metrics/BlockLength:
+  Enabled: false

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,21 @@
+# frozen_string_literal: true
+
+# Copyright The OpenTelemetry Authors
+#
+# SPDX-License-Identifier: Apache-2.0
+
+appraise 'google-protobuf-3.18.0' do
+  gem 'google-protobuf', '~> 3.18.0'
+end
+
+appraise 'google-protobuf-3.25.0' do
+  gem 'google-protobuf', '~> 3.25.0'
+end
+
+appraise 'google-protobuf-4.29.0' do
+  gem 'google-protobuf', '~> 4.29.0'
+end
+
+appraise 'google-protobuf-latest' do
+  gem 'google-protobuf'
+end

exporter/otlp-logs/CHANGELOG.md

@@ -0,0 +1,5 @@
+# Release History: opentelemetry-exporter-otlp-logs
+
+### v0.1.0 / 2024-12-04
+
+Initial release.

exporter/otlp-logs/Gemfile

@@ -0,0 +1,24 @@
+# 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
+
+group :test do
+  gem 'minitest-stub-const'
+end