logister-ruby 0.1.0 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6f3dcdd4ed71335923f5b4fd3d77dfa4af74a4d958715eaaf0805d704739f1a4
-  data.tar.gz: 147df51a94bea770c1559f0186eb74d154cd7a6b109a3b4025496ca8043abd68
+  metadata.gz: c3ffbd6d90538c5e0cf39deab256aaf1b0c5c15f5899051e67cfedc6657ac4b5
+  data.tar.gz: af860be23dab9bd73c8d394e9b1b91b6076f62a6a5f67272991afafba75d83a6
 SHA512:
-  metadata.gz: d1328c3bb4188794e62215e0e2fd7e0c50631d0d1b3c92fbe3fec5dc179510109cfb95b43629f588f74ef8efe790d4c190db494d4ab4527b9229701cf9c7bddf
-  data.tar.gz: 8e700cdfbf1ff0b1f0178c260270170f448165f6043e04bca8f7c6ef5365254819ce223db9adcb40cdd12b7f1ce7d6f11212921f2dd2bc73edd2f70dba7af82e
+  metadata.gz: 59875a74fdee52e22b697b80e4840ba070db495eb905b47d6522576f2e745d4f64081bf0fbf5f8e7cfc48917466c1a8724a389fe36f728b29080ff71dcb79165
+  data.tar.gz: fb8e6d1898621e57f2fdb9c66a3e08b655151f3f06ed830e5e2a8c96313c4b1e181c1281846a2a62ada0d7332d8a9631630bb5b9abe9bf7a4fc4f14e04a781a3

data/README.md

@@ -56,6 +56,20 @@ end
 
 If Rails is present, the gem installs middleware that reports unhandled exceptions automatically.
 
+## Database load metrics (ActiveRecord)
+
+You can capture SQL timing metrics using ActiveSupport notifications:
+
+```ruby
+Logister.configure do |config|
+  config.capture_db_metrics = true
+  config.db_metric_min_duration_ms = 10.0
+  config.db_metric_sample_rate = 1.0
+end
+```
+
+This emits metric events with `message: "db.query"` and context fields such as `duration_ms`, `name`, `sql`, and `binds_count`.
+
 ## Manual reporting
 
 ```ruby
@@ -68,3 +82,15 @@ Logister.report_metric(
   tags: { region: "us-east-1" }
 )
 ```
+
+## Release
+
+Use Bundler's built-in release flow:
+
+```bash
+# 1) bump version in lib/logister/version.rb
+# 2) commit changes
+bundle exec rake release
+```
+
+`rake release` will build the gem, create a git tag, push commits/tags, and push to RubyGems.

data/lib/generators/logister/templates/logister.rb

@@ -17,6 +17,11 @@ Logister.configure do |config|
   config.ignore_exceptions = []
   config.ignore_paths = []
 
+  # Optional ActiveRecord SQL instrumentation.
+  config.capture_db_metrics = false
+  config.db_metric_min_duration_ms = 10.0
+  config.db_metric_sample_rate = 1.0
+
   config.before_notify = lambda do |payload|
     payload
   end

data/lib/logister/configuration.rb

@@ -4,7 +4,8 @@ module Logister
   class Configuration
     attr_accessor :api_key, :endpoint, :environment, :service, :release, :enabled, :timeout_seconds, :logger,
                   :ignore_exceptions, :ignore_environments, :ignore_paths, :before_notify,
-                  :async, :queue_size, :max_retries, :retry_base_interval
+                  :async, :queue_size, :max_retries, :retry_base_interval,
+                  :capture_db_metrics, :db_metric_min_duration_ms, :db_metric_sample_rate
 
     def initialize
       @api_key = ENV['LOGISTER_API_KEY']
@@ -26,6 +27,10 @@ module Logister
       @queue_size = 1000
       @max_retries = 3
       @retry_base_interval = 0.5
+
+      @capture_db_metrics = false
+      @db_metric_min_duration_ms = 0.0
+      @db_metric_sample_rate = 1.0
     end
   end
 end

data/lib/logister/railtie.rb

@@ -21,6 +21,9 @@ module Logister
         copy_setting(app, config, :queue_size)
         copy_setting(app, config, :max_retries)
         copy_setting(app, config, :retry_base_interval)
+        copy_setting(app, config, :capture_db_metrics)
+        copy_setting(app, config, :db_metric_min_duration_ms)
+        copy_setting(app, config, :db_metric_sample_rate)
       end
     end
 
@@ -28,6 +31,10 @@ module Logister
       app.middleware.use Logister::Middleware
     end
 
+    initializer 'logister.sql_subscriber' do
+      Logister::SqlSubscriber.install!
+    end
+
     private
 
     def copy_setting(app, config, key)

data/lib/logister/sql_subscriber.rb

@@ -0,0 +1,57 @@
+module Logister
+  class SqlSubscriber
+    IGNORED_SQL_NAMES = %w[SCHEMA TRANSACTION].freeze
+
+    class << self
+      def install!
+        return if @installed
+
+        ActiveSupport::Notifications.subscribe('sql.active_record') do |name, started, finished, _id, payload|
+          handle_sql_event(name, started, finished, payload)
+        end
+
+        @installed = true
+      end
+
+      private
+
+      def handle_sql_event(_name, started, finished, payload)
+        config = Logister.configuration
+        return unless config.capture_db_metrics
+        return if payload[:cached]
+        return if IGNORED_SQL_NAMES.include?(payload[:name].to_s)
+
+        duration_ms = (finished - started) * 1000.0
+        return if duration_ms < config.db_metric_min_duration_ms.to_f
+        return if sampled_out?(config.db_metric_sample_rate)
+
+        level = duration_ms >= 500 ? 'warn' : 'info'
+
+        Logister.report_metric(
+          message: 'db.query',
+          level: level,
+          context: {
+            duration_ms: duration_ms.round(2),
+            name: payload[:name].to_s,
+            sql: payload[:sql].to_s,
+            cached: false,
+            binds_count: Array(payload[:binds]).size
+          },
+          tags: {
+            category: 'database'
+          }
+        )
+      rescue StandardError => e
+        config.logger.warn("logister sql subscriber failed: #{e.class} #{e.message}")
+      end
+
+      def sampled_out?(sample_rate)
+        rate = sample_rate.to_f
+        return true if rate <= 0.0
+        return false if rate >= 1.0
+
+        rand > rate
+      end
+    end
+  end
+end

data/lib/logister/version.rb

@@ -1,3 +1,3 @@
 module Logister
-  VERSION = '0.1.0'
+  VERSION = '0.1.2'
 end

data/lib/logister-ruby.rb

@@ -0,0 +1 @@
+require_relative 'logister'

data/lib/logister.rb

@@ -3,6 +3,7 @@ require_relative 'logister/configuration'
 require_relative 'logister/client'
 require_relative 'logister/reporter'
 require_relative 'logister/middleware'
+require_relative 'logister/sql_subscriber'
 
 module Logister
   class << self

data/logister-ruby.gemspec

@@ -13,7 +13,7 @@ Gem::Specification.new do |spec|
   spec.required_ruby_version = '>= 3.1.0'
 
   spec.metadata['homepage_uri'] = spec.homepage
-  spec.metadata['source_code_uri'] = 'https://logister.org'
+  spec.metadata['source_code_uri'] = 'https://github.com/taimoorq/logister-ruby'
 
   spec.files = Dir.chdir(__dir__) do
     Dir.glob('lib/**/*') + ['README.md', 'logister-ruby.gemspec']
@@ -22,4 +22,5 @@ Gem::Specification.new do |spec|
   spec.require_paths = ['lib']
 
   spec.add_dependency 'activesupport', '>= 6.1'
+  spec.add_development_dependency 'rake', '>= 13.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: logister-ruby
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.2
 platform: ruby
 authors:
 - Logister
@@ -23,6 +23,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '6.1'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '13.0'
 description: Client gem for reporting errors and custom metrics from Ruby and Rails
   apps to logister.org
 email:
@@ -34,12 +48,14 @@ files:
 - README.md
 - lib/generators/logister/install_generator.rb
 - lib/generators/logister/templates/logister.rb
+- lib/logister-ruby.rb
 - lib/logister.rb
 - lib/logister/client.rb
 - lib/logister/configuration.rb
 - lib/logister/middleware.rb
 - lib/logister/railtie.rb
 - lib/logister/reporter.rb
+- lib/logister/sql_subscriber.rb
 - lib/logister/version.rb
 - logister-ruby.gemspec
 homepage: https://logister.org
@@ -47,7 +63,7 @@ licenses:
 - MIT
 metadata:
   homepage_uri: https://logister.org
-  source_code_uri: https://logister.org
+  source_code_uri: https://github.com/taimoorq/logister-ruby
 rdoc_options: []
 require_paths:
 - lib