foam-ruby 0.1.0.alpha3 → 0.1.0.alpha5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4757e034451eb4a545eb37b3d9fefcb4d1efc64748ce9a09984f27bd11882666
-  data.tar.gz: 4794bba41f510f12bf74f54a59b48ce5f7d9756eb76836ba8bc5835fc24a2abe
+  metadata.gz: 57eba0f562797a93af9440bf8cc80c2e80009200837d5ac647e01c832a85e07e
+  data.tar.gz: 9c68ec68a95f652a90840cb21c285746ca317724c92b10ba272e25708210104e
 SHA512:
-  metadata.gz: 75b987b723c9566e71e38acc0f75b92ae4893cb5de83ebf1667629d0fd5b5cb7937e95e36ddbc66744a97439bdaa6b9227bfbb09431d6f5b97445f031b75d4d9
-  data.tar.gz: 3abca311a34a3d1cf780416fb6f362369c4a797d87f9513f1244d6e021b485bc063ec224868196512e79f326c6bfc32e26342f9f9789b8e5cd0a7cb7735678ac
+  metadata.gz: 2f8f50ce67167cdb2e48382c6166abd767b22aa86b6ff01cc3762fa5fa8305cea5ce766b06877c6a257878b6e52c64cb063fc521e2f7b3a3cf41645e9fd306e7
+  data.tar.gz: 8ab6d387a971d5111e3ee7b864715eb15872ab976e5ab7f06a215b0d3e6c943e401050a883f725f35bfb46d4c8e6db1760eb40d2236da586d78cf76b267b8e9e

data/README.md

@@ -35,17 +35,6 @@ That's it. The gem will:
 
 ## Configuration
 
-### Block syntax
-
-```ruby
-Foam::Ruby.configure do |c|
-  c.token = ENV["FOAM_API_TOKEN"]
-  c.service_name = "my-rails-app"
-  c.traces_enabled = true
-  c.logs_enabled = true
-end
-```
-
 ### Environment variables
 
 | Variable | Description | Default |
@@ -95,20 +84,13 @@ rescue => e
 end
 ```
 
-### Additional Instrumentations
+### Sentry Integration
 
-Pass extra OpenTelemetry instrumentations:
+If Sentry is in your Gemfile, the gem automatically bridges `Sentry.capture_exception` to forward errors to Foam. No configuration needed.
 
-```ruby
-Foam::Ruby.init(
-  token: ENV["FOAM_API_TOKEN"],
-  service_name: "my-rails-app",
-  instrumentations: [
-    "OpenTelemetry::Instrumentation::Sidekiq",
-    "OpenTelemetry::Instrumentation::Redis",
-  ]
-)
-```
+### Production Only
+
+The gem only initializes in production (`RAILS_ENV=production` or `RACK_ENV=production`). In development and test, all calls are silent no-ops — zero overhead, zero side effects.
 
 ## Rails Compatibility
 

data/lib/foam/ruby/configuration.rb

@@ -6,8 +6,7 @@ module Foam
       FOAM_OTEL_ENDPOINT = "https://otel.api.foam.ai"
 
       attr_accessor :token, :service_name, :endpoint,
-                    :traces_enabled, :logs_enabled,
-                    :additional_instrumentations
+                    :traces_enabled, :logs_enabled
 
       def initialize
         @token = ENV["FOAM_API_TOKEN"]
@@ -15,7 +14,6 @@ module Foam
         @endpoint = ENV.fetch("FOAM_OTEL_ENDPOINT", FOAM_OTEL_ENDPOINT)
         @traces_enabled = true
         @logs_enabled = true
-        @additional_instrumentations = []
       end
 
       def otel_headers

data/lib/foam/ruby/version.rb

@@ -2,6 +2,6 @@
 
 module Foam
   module Ruby
-    VERSION = "0.1.0.alpha3"
+    VERSION = "0.1.0.alpha5"
   end
 end

data/lib/foam/ruby.rb

@@ -1,45 +1,45 @@
 # frozen_string_literal: true
 
-require "opentelemetry/sdk"
-require "opentelemetry-logs-api"
-
 require_relative "ruby/version"
 require_relative "ruby/configuration"
-require_relative "ruby/otel_setup"
-require_relative "ruby/log_subscriber"
 
 module Foam
   module Ruby
     class << self
-      def configuration
-        @configuration ||= Configuration.new
-      end
-
-      def configure
-        yield(configuration) if block_given?
-        configuration
+      def initialized?
+        @initialized == true
       end
 
       def init(token: nil, service_name: nil, endpoint: nil, **options)
-        configure do |c|
-          c.token = token if token
-          c.service_name = service_name if service_name
-          c.endpoint = endpoint if endpoint
-          c.traces_enabled = options.fetch(:traces, true)
-          c.logs_enabled = options.fetch(:logs, true)
-          c.additional_instrumentations = options[:instrumentations] || []
-        end
+        return unless production?
+
+        config = configuration
+        config.token = token if token
+        config.service_name = service_name if service_name
+        config.endpoint = endpoint if endpoint
+        config.traces_enabled = options.fetch(:traces, true)
+        config.logs_enabled = options.fetch(:logs, true)
 
-        unless configuration.valid?
+        unless config.valid?
           warn "[foam-ruby] Missing token — set FOAM_API_TOKEN or pass token: to Foam::Ruby.init"
           return
         end
 
-        OtelSetup.configure!(configuration)
-        schedule_logger_attach! if configuration.logs_enabled
+        require_relative "ruby/otel_setup"
+        require_relative "ruby/log_subscriber"
+
+        OtelSetup.configure!(config)
+        schedule_logger_attach! if config.logs_enabled
+        bridge_sentry!
+        @initialized = true
+      rescue Exception => e # rubocop:disable Lint/RescueException
+        warn "[foam-ruby] init failed: #{e.message}"
+        @initialized = false
       end
 
       def capture_exception(error, attributes: {})
+        return unless initialized?
+
         span = OpenTelemetry::Trace.current_span
         return unless span && span.context.valid?
 
@@ -55,12 +55,25 @@ module Foam
 
         span.record_exception(error, attributes: attrs)
         span.status = OpenTelemetry::Trace::Status.error(error.message)
-      rescue StandardError => e
-        warn "[foam-ruby] capture_exception failed: #{e.message}"
+      rescue Exception # rubocop:disable Lint/RescueException
+        nil
       end
 
       private
 
+      def configuration
+        @configuration ||= Configuration.new
+      rescue Exception # rubocop:disable Lint/RescueException
+        Configuration.new
+      end
+
+      def production?
+        env = ENV["RAILS_ENV"] || ENV["RACK_ENV"] || "development"
+        env.downcase == "production"
+      rescue Exception # rubocop:disable Lint/RescueException
+        false
+      end
+
       def schedule_logger_attach!
         return unless defined?(::Rails)
 
@@ -69,15 +82,31 @@ module Foam
         else
           do_attach_otel_logger!
         end
-      rescue StandardError => e
-        warn "[foam-ruby] Failed to schedule OTel logger attach: #{e.message}"
+      rescue Exception # rubocop:disable Lint/RescueException
+        nil
+      end
+
+      def bridge_sentry!
+        return unless defined?(::Rails) && ::Rails.respond_to?(:application) && ::Rails.application
+
+        ::Rails.application.config.after_initialize do
+          next unless defined?(::Sentry)
+
+          ::Sentry.singleton_class.prepend(Module.new do
+            def capture_exception(exception, **options, &block)
+              Foam::Ruby.capture_exception(exception) if exception.is_a?(::Exception)
+              super
+            end
+          end)
+        end
+      rescue Exception # rubocop:disable Lint/RescueException
+        nil
       end
 
       def do_attach_otel_logger!
         return unless ::Rails.respond_to?(:logger) && ::Rails.logger
 
         unless OpenTelemetry.logger_provider.is_a?(OpenTelemetry::SDK::Logs::LoggerProvider)
-          warn "[foam-ruby] OTel logger provider not configured — call Foam::Ruby.init before attaching logger"
           return
         end
 
@@ -88,8 +117,8 @@ module Foam
         elsif defined?(::ActiveSupport::Logger) && ::ActiveSupport::Logger.respond_to?(:broadcast)
           ::Rails.logger.extend(::ActiveSupport::Logger.broadcast(otel_logger))
         end
-      rescue StandardError => e
-        warn "[foam-ruby] Failed to attach OTel logger to Rails.logger: #{e.message}"
+      rescue Exception # rubocop:disable Lint/RescueException
+        nil
       end
     end
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: foam-ruby
 version: !ruby/object:Gem::Version
-  version: 0.1.0.alpha3
+  version: 0.1.0.alpha5
 platform: ruby
 authors:
 - Foam