salopulse 0.2.2 → 0.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 512fe8f0a9da0a15111a1729565fe2625f2041738742ac2839b4a393b6d1a1ef
-  data.tar.gz: 2589d8bbbabb05653a35966f31e09a8332be762440bb1bb098e7ed379cd4d020
+  metadata.gz: 6ec917de87f35b31c9d7209c371690972280dd03fff4c45c631e8d997032194b
+  data.tar.gz: dc7e512fca6d8d777db443fbbd24bba3c79b23609135ba6d4e939255d803813e
 SHA512:
-  metadata.gz: 87cbf76171f6b4bd640e753ef5ddcb3e81b6cfcf6174fd0dbb8e029beedfda52c46b78b5ff163f46ee97f9bc798f8bcebc22af6a142bf957c03483cf8d32543a
-  data.tar.gz: e8cb2ebc978d880e87b51b98f8988dac008729b6863de71b12be5a65ceeeb4d2a0d3e49e66af42e1941597d9294fbc991f0bec591954f72f4e3a4c26895c98c2
+  metadata.gz: e0c6c894cf599d0ae88616b619773e9ce38415d3fbd92405bf40d12bd40f9c2582fc8644f183fe0a8c02591bb57e824e464447f52c1bdf8ab91120fd8ba4b7d0
+  data.tar.gz: e772de5379104c022958a411c850162cfa3e8bfbb3578241917b3fe620db6f2e3cf7e6eee284a0e145b019cc6df5affdc45c0c5ba2c518b294012ef195282e7d

data/CHANGELOG.md

@@ -2,7 +2,7 @@
 
 Format: [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
-## [0.2.2] - 2026-06-04
+## [0.2.3] - 2026-06-04
 
 First public release of the rewritten Salopulse APM SDK. Bumped past the
 legacy `salopulse` 0.1.x line on RubyGems.

data/README.md

@@ -70,6 +70,13 @@ SDK aşağıdaki alanları otomatik maskeler (`[FILTERED]`):
 - Buffer üst sınırlı (`max_buffer_size`); patlayıp uygulamayı çökertmez
 - Transport hatalarında exponential backoff retry (max 3) — başarısızsa event düşer, uygulamaya hata sızmaz
 
+## Teslimat Davranışı
+
+- SQL event'leri request içinde hemen POST edilmez; önce request sonunda `flush_request_scope_events` ile kuyruğa alınır. Bu, N+1 tespiti için bilinçli bir tasarım.
+- Kuyruğa alınan event'ler varsayılan olarak anında değil, background flusher tarafından `flush_interval` kadar bekletilip toplu gönderilir. Varsayılan değer `5` saniyedir.
+- Process kapanırken `close` son flush'ı zorlar. Bu yüzden fork'lu sunucularda veya kısa ömürlü process'lerde sorun varsa davranış "ancak kapanışta gidiyor" gibi görünebilir.
+- Daha hızlı görünürlük istiyorsanız `flush_interval` değerini düşürün veya kritik yerlerde `Salopulse.flush` çağırın.
+
 ## Geliştirme
 
 ```

data/lib/salopulse/client.rb

@@ -19,11 +19,15 @@ module Salopulse
     def initialize
       @initialized = false
       @mutex = Mutex.new
+      @pid = nil
     end
 
     def init(options = {})
       @mutex.synchronize do
-        return self if @initialized
+        if @initialized
+          build_runtime!(reset_buffer: forked_process?) unless runtime_ready?
+          return self
+        end
 
         @configuration = Configuration.new
         options.each { |k, v| @configuration.public_send("#{k}=", v) if @configuration.respond_to?("#{k}=") }
@@ -31,20 +35,7 @@ module Salopulse
         return self unless @configuration.enabled
 
         @dsn = DSN.new(@configuration.dsn)
-        @buffer = Buffer.new(max_size: @configuration.max_buffer_size)
-        @transport = Transport.new(
-          dsn: @dsn,
-          sdk_version: Salopulse::VERSION,
-          logger: @configuration.logger
-        )
-        @flusher = Flusher.new(
-          buffer: @buffer,
-          transport: @transport,
-          interval: @configuration.flush_interval,
-          batch_size: @configuration.flush_batch_size,
-          logger: @configuration.logger
-        )
-        @flusher.start
+        build_runtime!(reset_buffer: true)
 
         install_at_exit_hook
 
@@ -179,12 +170,15 @@ module Salopulse
 
     def flush(timeout: 5)
       return 0 if disabled?
+      ensure_runtime_ready!
       @flusher.flush_all(timeout: timeout)
     end
 
     def close
       return unless @initialized
+      ensure_runtime_ready!
       @flusher&.stop(timeout: 5)
+      @pid = nil
       @initialized = false
     end
 
@@ -196,12 +190,14 @@ module Salopulse
       @transport = nil
       @flusher = nil
       @dsn = nil
+      @pid = nil
       @initialized = false
     end
 
     private
 
     def enqueue(event)
+      return false unless ensure_runtime_ready!
       return false unless @buffer
       if @configuration.before_send
         event = @configuration.before_send.call(event)
@@ -228,6 +224,45 @@ module Salopulse
       rand < rate
     end
 
+    def ensure_runtime_ready!
+      return false if !@initialized || !@configuration&.enabled
+      return true if runtime_ready?
+
+      @mutex.synchronize do
+        return false if !@initialized || !@configuration&.enabled
+        return true if runtime_ready?
+
+        build_runtime!(reset_buffer: forked_process?)
+      end
+      true
+    end
+
+    def build_runtime!(reset_buffer:)
+      @buffer = Buffer.new(max_size: @configuration.max_buffer_size) if reset_buffer || @buffer.nil?
+      @transport = Transport.new(
+        dsn: @dsn,
+        sdk_version: Salopulse::VERSION,
+        logger: @configuration.logger
+      )
+      @flusher = Flusher.new(
+        buffer: @buffer,
+        transport: @transport,
+        interval: @configuration.flush_interval,
+        batch_size: @configuration.flush_batch_size,
+        logger: @configuration.logger
+      )
+      @flusher.start
+      @pid = Process.pid
+    end
+
+    def runtime_ready?
+      @pid == Process.pid && @flusher&.alive?
+    end
+
+    def forked_process?
+      !@pid.nil? && @pid != Process.pid
+    end
+
     def detect_dialect
       return "unknown" unless defined?(ActiveRecord::Base) && ActiveRecord::Base.connected?
       adapter = ActiveRecord::Base.connection.adapter_name.to_s.downcase

data/lib/salopulse/flusher.rb

@@ -49,6 +49,10 @@ module Salopulse
       @thread&.join(timeout)
     end
 
+    def alive?
+      @thread&.alive? || false
+    end
+
     private
 
     def sleep_with_interrupt(seconds)

data/lib/salopulse/version.rb

@@ -1,3 +1,3 @@
 module Salopulse
-  VERSION = "0.2.2".freeze
+  VERSION = "0.2.3".freeze
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: salopulse
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 0.2.3
 platform: ruby
 authors:
 - Salih İmran Büker
@@ -10,61 +10,61 @@ cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: rspec
+  name: activesupport
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '3.12'
+        version: '7.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '3.12'
+        version: '7.0'
 - !ruby/object:Gem::Dependency
-  name: webmock
+  name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.18'
+        version: '13.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.18'
+        version: '13.0'
 - !ruby/object:Gem::Dependency
-  name: rake
+  name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '13.0'
+        version: '3.12'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '13.0'
+        version: '3.12'
 - !ruby/object:Gem::Dependency
-  name: activesupport
+  name: webmock
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '7.0'
+        version: '3.18'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '7.0'
+        version: '3.18'
 description: Automatic SQL, error, and HTTP performance telemetry for Ruby applications.
   Captures ActiveRecord queries, exceptions, and Rack request performance with zero-config
   setup for Rails.