scout_apm_logging 0.0.12 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: aea114282e91583732d4a4b3246273d0b18ae3b2e5b784366b5a18691889391b
-  data.tar.gz: dd625a2eb6bede54138bb05ef3671ad1a98995d59f1c5de28d033fd617d156b6
+  metadata.gz: 715fd7db3c4042b700482e55ad0d29298a3084d49e2997e0dc0fa5c46654edb6
+  data.tar.gz: '018ca5a3d37c221d864e37d5d95a624920ab9636803cd7c1b7eb6637c61a4826'
 SHA512:
-  metadata.gz: 4d62832832aa309c9bd66c5cabe2d6c4c23472452bd0f3b9874741febd5f0a5f6716dfea8ff5e929075424ea998a89eb0edb947da9959d0bf03da334a9502158
-  data.tar.gz: 94ab281a893c87b2d1b979b4b8fa7c9c2bd0e467983b302c0f0931b04f582dc6dc2c6b9c3c19b83ad14b79ece26a6b4a5f0c7e6cda492b6b840c133ec9d7d5f2
+  metadata.gz: 216a75a3dc38b61318dc554277211f8722aa359f142efb7f6f04e28661c06e3d94a4ca43535b3094532e85aceb868e4309d2c07d4fe734beebd86368977c14f0
+  data.tar.gz: 020d7b793d0c8bf5d1c2cfa904783e9fb230232e17dafb826d071af1ff00d8a0fda78b74ea6a9c3579f69e9a70df38f4b069135ee442854d1fa46877f9fd7e84

data/.gitignore

@@ -7,7 +7,3 @@ gems/*.lock
 .idea
 # Ignore log files
 log/*.log
-# Ignore checksum files
-tooling/*
-!tooling/*.md
-!tooling/*.rb

data/.rubocop.yml

@@ -3,10 +3,10 @@ AllCops:
     - "bin/*"
     - "tmp/**/*"
     - "vendor/**/*"
+    - lib/scout_apm/logging/loggers/opentelemetry/**/*
     - "spec/spec_helper.rb"
     - "gems/*"
     - "Rakefile"
-    - "tooling/*"
   NewCops: disable
   TargetRubyVersion: 2.6
 

data/CHANGELOG.md

@@ -1,3 +1,11 @@
+## 1.0.0
+* Vendor OpenTelemetry SDK and remove the use of the collector and monitor processes.
+
+## 0.0.13
+* Add ability to handle other libraries setting the Rails logger.
+* Overwrite comparability methods on the proxy class. Have proxy class inherit from Object again.
+* Clone original log instances.
+
 ## 0.0.12
 * Prevent certain attributes from being changed on created FileLogger.
 * Update proxy class to inherit from BasicObject to relay class comparison methods

data/NOTICE

@@ -0,0 +1,4 @@
+This project contains third-party libraries licensed under the Apache License 2.0:
+
+- opentelemetry-logs-sdk: Licensed under the Apache License 2.0
+  See lib/scout_apm/logging/loggers/opentelemetry/LICENSE for details.

data/lib/scout_apm/logging/config.rb

@@ -48,35 +48,18 @@ module ScoutApm
         log_file_path
         log_class
         logs_monitor
-        logs_monitored
         logs_ingest_key
         logs_capture_level
         logs_config
         logs_reporting_endpoint
+        logs_reporting_endpoint_http
         logs_proxy_log_dir
         logs_log_file_size
-        manager_lock_file
-        monitor_pid_file
-        monitor_state_file
-        monitor_interval
-        monitor_interval_delay
-        collector_sending_queue_storage_dir
-        collector_offset_storage_dir
-        collector_pid_file
-        collector_download_dir
-        collector_config_file
-        collector_log_level
-        collector_version
-        health_check_port
       ].freeze
 
       SETTING_COERCIONS = {
         'logs_monitor' => BooleanCoercion.new,
-        'logs_monitored' => JsonCoercion.new,
-        'logs_log_file_size' => IntegerCoercion.new,
-        'monitor_interval' => IntegerCoercion.new,
-        'monitor_interval_delay' => IntegerCoercion.new,
-        'health_check_port' => IntegerCoercion.new
+        'logs_log_file_size' => IntegerCoercion.new
       }.freeze
 
       # The bootstrapped, and initial config that we attach to the context. Will be swapped out by
@@ -95,18 +78,12 @@ module ScoutApm
         overlays = [
           ConfigEnvironment.new,
           ConfigFile.new(context, file_path, config),
-          ConfigDynamic.new,
-          ConfigState.new(context),
           ConfigDefaults.new,
           ConfigNull.new
         ]
         new(context, overlays)
       end
 
-      def state
-        @overlays.find { |overlay| overlay.is_a? ConfigState }
-      end
-
       def value(key)
         unless KNOWN_CONFIG_OPTIONS.include?(key)
           logger.debug("Requested looking up a unknown configuration key: #{key} (not a problem. Evaluate and add to config.rb)")
@@ -131,119 +108,16 @@ module ScoutApm
         end
       end
 
-      # Dynamically set state based on the application.
-      class ConfigDynamic
-        @values_to_set = {
-          'health_check_port': nil
-        }
-
-        class << self
-          attr_reader :values_to_set
-
-          def set_value(key, value)
-            @values_to_set[key] = value
-          end
-        end
-
-        def value(key)
-          self.class.values_to_set[key]
-        end
-
-        def has_key?(key)
-          self.class.values_to_set.key?(key)
-        end
-
-        def name
-          'dynamic'
-        end
-      end
-
-      # State that is persisted and communicated upon by multiple processes.
-      class ConfigState
-        @values_to_set = {
-          'logs_monitored': [],
-          'health_check_port': nil
-        }
-
-        class << self
-          attr_reader :values_to_set
-
-          def set_value(key, value)
-            @values_to_set[key] = value
-          end
-
-          def get_values_to_set
-            @values_to_set.keys.map(&:to_s)
-          end
-        end
-
-        attr_reader :context, :state
-
-        def initialize(context)
-          @context = context
-
-          # Note, the config on the context we are passing in here comes from the Config.without_file. We
-          # won't be aware of a state file that was defined in a config file, but this would be a very
-          # rare thing to have happen as this is more of an internal config value.
-          @state = State.new(context)
-
-          set_values_from_state
-        end
-
-        def value(key)
-          self.class.values_to_set[key]
-        end
-
-        def has_key?(key)
-          self.class.values_to_set.key?(key)
-        end
-
-        def name
-          'state'
-        end
-
-        def flush_state!
-          state.flush_to_file!
-        end
-
-        def add_log_locations!(updated_log_locations)
-          state.flush_to_file!(updated_log_locations)
-        end
-
-        private
-
-        def set_values_from_state
-          data = state.load_state_from_file
-
-          return unless data
-
-          data.each do |key, value|
-            self.class.set_value(key, value)
-          end
-        end
-      end
-
       # Defaults in case no config file has been found.
       class ConfigDefaults
         DEFAULTS = {
           'log_level' => 'info',
-          'logs_monitored' => [],
           'logs_capture_level' => 'debug',
+          'logs_ingest_key' => '',
           'logs_reporting_endpoint' => 'https://otlp.scoutotel.com:4317',
+          'logs_reporting_endpoint_http' => 'https://otlp.scoutotel.com:4318/v1/logs',
           'logs_proxy_log_dir' => '/tmp/scout_apm/logs/',
-          'logs_log_file_size' => 1024 * 1024 * 10,
-          'manager_lock_file' => '/tmp/scout_apm/monitor_lock_file.lock',
-          'monitor_pid_file' => '/tmp/scout_apm/scout_apm_log_monitor.pid',
-          'monitor_state_file' => '/tmp/scout_apm/scout_apm_log_monitor_state.json',
-          'monitor_interval' => 60,
-          'monitor_interval_delay' => 60,
-          'collector_log_level' => 'error',
-          'collector_offset_storage_dir' => '/tmp/scout_apm/file_storage/receiver/',
-          'collector_sending_queue_storage_dir' => '/tmp/scout_apm/file_storage/otc/',
-          'collector_pid_file' => '/tmp/scout_apm/scout_apm_otel_collector.pid',
-          'collector_download_dir' => '/tmp/scout_apm/',
-          'collector_config_file' => '/tmp/scout_apm/config.yml',
-          'collector_version' => '0.102.1'
+          'logs_log_file_size' => 1024 * 1024 * 10
         }.freeze
 
         def value(key)

data/lib/scout_apm/logging/loggers/capture.rb

@@ -2,6 +2,7 @@
 
 require 'logger'
 
+require_relative './opentelemetry/opentelemetry'
 require_relative './formatter'
 require_relative './logger'
 require_relative './proxy'
@@ -30,6 +31,8 @@ module ScoutApm
         def setup!
           return unless context.config.value('logs_monitor')
 
+          OpenTelemetry.setup(context)
+
           create_proxy_log_dir!
 
           add_logging_patches!
@@ -42,10 +45,11 @@ module ScoutApm
           Utils.ensure_directory_exists(context.config.value('logs_proxy_log_dir'))
         end
 
-        def add_logging_patches!
+        def add_logging_patches! # rubocop:disable Metrics/AbcSize
+          require_relative './patches/rails_logger' unless ::Rails.logger.respond_to?(:broadcasts)
           # We can't swap out the logger similar to that of Rails and Sidekiq, as
           # the TaggedLogging logger is dynamically generated.
-          return unless Rails.logger.respond_to?(:tagged)
+          return unless ::Rails.logger.respond_to?(:tagged)
 
           ::ActiveSupport::TaggedLogging.prepend(Patches::TaggedLogging)
 
@@ -53,9 +57,9 @@ module ScoutApm
           # This appears to be an issue in Ruby 2.7 with the broadcast logger.
           ruby_version = Gem::Version.new(RUBY_VERSION)
           isruby27 = (ruby_version >= Gem::Version.new('2.7') && ruby_version < Gem::Version.new('3.0'))
-          return unless isruby27 && Rails.logger.respond_to?(:broadcasts)
+          return unless isruby27 && ::Rails.logger.respond_to?(:broadcasts)
 
-          Rails.logger.broadcasts.each do |logger|
+          ::Rails.logger.broadcasts.each do |logger|
             logger.extend ::ActiveSupport::TaggedLogging
           end
         end
@@ -66,8 +70,6 @@ module ScoutApm
             logger.new(context).update_logger! if logger.present?
           end
           updated_log_locations.compact!
-
-          context.config.state.add_log_locations!(updated_log_locations)
         end
       end
     end

data/lib/scout_apm/logging/loggers/formatter.rb

@@ -16,7 +16,6 @@ module ScoutApm
           attributes_to_log = {
             severity: severity,
             time: format_datetime(time),
-            pid: Process.pid.to_s,
             msg: msg2str(msg)
           }
 
@@ -29,7 +28,21 @@ module ScoutApm
           # Naive local benchmarks show this takes around 200 microseconds. As such, we only apply it to WARN and above.
           attributes_to_log.merge!(local_log_location) if ::Logger::Severity.const_get(severity) >= ::Logger::Severity::WARN
 
-          "#{attributes_to_log.to_json}\n"
+          message = "#{attributes_to_log.to_json}\n"
+          attributes_to_log['raw_bytes'] = message
+
+          ScoutApm::Logging::Loggers::OpenTelemetry.logger_provider.logger(
+            name: 'scout_apm',
+            version: '0.1.0'
+          ).on_emit(
+            severity_text: severity,
+            severity_number: ::Logger::Severity.const_get(severity),
+            attributes: attributes_to_log,
+            timestamp: time,
+            body: msg,
+            context: ::OpenTelemetry::Context.current
+          )
+          message
         end
 
         private
@@ -86,6 +99,12 @@ module ScoutApm
           { 'log_location' => last_local_location }
         end
 
+        def context
+          ScoutApm::Logging::Context.new.tap do |context|
+            context.config = ScoutApm::Logging::Config.with_file(context, context.config.value('config_file'))
+          end
+        end
+
         # We may need to clean this up a bit.
         def service_name
           $PROGRAM_NAME

data/lib/scout_apm/logging/loggers/opentelemetry/LICENSE

@@ -0,0 +1,201 @@
+                              Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   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.

data/lib/scout_apm/logging/loggers/opentelemetry/NOTICE

@@ -0,0 +1,9 @@
+This product includes software developed by The OpenTelemetry Authors
+under the Apache License, Version 2.0 (http://www.apache.org/licenses/LICENSE-2.0).
+
+Modifications:
+The following modifications were made on Sep 17 2024 by Jack Rothrock.
+- Modified the protobuf definitions to prevent collisions.
+- Decreased default BLRP Export Batch Size from 512 to 256.
+- Update logger to use the Scout Logging internal logger.
+- Update logic around logger_provider setting on the OpenTelemetry Module.

data/lib/scout_apm/logging/loggers/opentelemetry/api/logs/log_record.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+# Copyright The OpenTelemetry Authors
+#
+# SPDX-License-Identifier: Apache-2.0
+
+module ScoutApm
+  module Logging
+    module Loggers
+      module OpenTelemetry
+        module Logs
+          # No-op implementation of an emitted log and its associated attributes.
+          class LogRecord; end
+        end
+      end
+    end
+  end
+end

data/lib/scout_apm/logging/loggers/opentelemetry/api/logs/logger.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+# Copyright The OpenTelemetry Authors
+#
+# SPDX-License-Identifier: Apache-2.0
+
+module ScoutApm
+  module Logging
+    module Loggers
+      module OpenTelemetry
+        module Logs
+          # No-op implementation of logger.
+          class Logger
+            # rubocop:disable Style/EmptyMethod
+
+            # Emit a {LogRecord} to the processing pipeline.
+            #
+            # @param timestamp [optional Time] Time when the event occurred.
+            # @param observed_timestamp [optional Time] Time when the event was
+            #   observed by the collection system.
+            # @param context [optional Context] The Context to associate with the
+            #   LogRecord. Intended default: OpenTelemetry::Context.current
+            # @param severity_number [optional Integer] Numerical value of the
+            #   severity. Smaller numerical values correspond to less severe events
+            #   (such as debug events), larger numerical values correspond to more
+            #   severe events (such as errors and critical events).
+            # @param [optional String] severity_text Original string representation of
+            #   the severity as it is known at the source. Also known as log level.
+            # @param [optional String, Numeric, Boolean, Array<String, Numeric,
+            #   Boolean>, Hash{String => String, Numeric, Boolean, Array<String,
+            #   Numeric, Boolean>}] body A value containing the body of the log record.
+            # @param [optional String] trace_id The trace ID associated with the
+            #   current context.
+            # @param [optional String] span_id The span ID associated with the
+            #   current context.
+            # @param [optional TraceFlags] trace_flags The trace flags associated
+            #   with the current context.
+            # @param [optional Hash{String => String, Numeric, Boolean,
+            #   Array<String, Numeric, Boolean>}] attributes Additional information
+            #   about the event.
+            # @param [optional Context] context The Context to associate with the
+            #   LogRecord. Intended default: OpenTelemetry::Context.current
+            #
+            # @api public
+            def on_emit(
+              timestamp: nil,
+              observed_timestamp: nil,
+              severity_number: nil,
+              severity_text: nil,
+              body: nil,
+              trace_id: nil,
+              span_id: nil,
+              trace_flags: nil,
+              attributes: nil,
+              context: nil
+            )
+            end
+            # rubocop:enable Style/EmptyMethod
+          end
+        end
+      end
+    end
+  end
+end

data/lib/scout_apm/logging/loggers/opentelemetry/api/logs/logger_provider.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+# Copyright The OpenTelemetry Authors
+#
+# SPDX-License-Identifier: Apache-2.0
+
+module ScoutApm
+  module Logging
+    module Loggers
+      module OpenTelemetry
+        module Logs
+          # No-op implementation of a logger provider.
+          class LoggerProvider
+            NOOP_LOGGER = OpenTelemetry::Logs::Logger.new
+            private_constant :NOOP_LOGGER
+
+            # Returns an {OpenTelemetry::Logs::Logger} instance.
+            #
+            # @param [optional String] name Instrumentation package name
+            # @param [optional String] version Instrumentation package version
+            #
+            # @return [OpenTelemetry::Logs::Logger]
+            def logger(name = nil, version = nil)
+              @logger ||= NOOP_LOGGER
+            end
+          end
+        end
+      end
+    end
+  end
+end