yabeda 0.14.0 → 0.16.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cbfcaaa322333f0bf774953f4ef40081a43f3d8dc89a3aec426397c174f8e5ef
-  data.tar.gz: 4f4dd1f0fc20cf59b72c26308861dfc7b439d271cdaebcd8441190a419e3b3e6
+  metadata.gz: e1c0a1298576c5e12a8c7acd4cda088fab78b155e846d6aa0c8865638488a5ab
+  data.tar.gz: ef0ba94b3fb39fd022e1aeb272104f46729f22aa10da6ba338cd2d91492883bd
 SHA512:
-  metadata.gz: d43a6452648112c376b29dce66942ad6a491f4b0d54794cd42f5dd874d8db7c005f3e65d883707b53a6bbc4ffc8f961526a8c757acb877e89239d527d5205b4b
-  data.tar.gz: c42902e5e1b7f410170f7dfec0594de246ec5aebaa989b33786cec835cfaa5e99308155b35f906e4bf495589c3d0b03c1cc40fcaa88ddb59b43b1abc5ce187e4
+  metadata.gz: 0effc951709196bbfb6f266211710704645502997c0ee8864d2514d204467a7206eb4550fde040a00d15dde811d85e0ed6eb237939417a6ce41bbd4c310fe6b8
+  data.tar.gz: f74760379893fade4bc37635dbbbd0f851a52635ebc50a210eed5531ca2e4b3a2a225cfdbd3d63e38af9dded14d6eaa518f853ff3b7ec63f7ae6ffb919969589

data/.github/workflows/test.yml

@@ -21,6 +21,7 @@ jobs:
         include:
           - ruby: head
             optional: true
+          - ruby: "4.0"
           - ruby: "3.4"
           - ruby: "3.3"
           - ruby: "3.2"

data/CHANGELOG.md

@@ -7,6 +7,37 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 
 ## Unreleased
 
+## 0.16.0 - 2026-03-12
+
+### Added
+
+- Ability to include/exclude only certain metrics in a group for export via adapter. [@sobrinho][] in [#49](https://github.com/yabeda-rb/yabeda/pull/49)
+
+  ```ruby
+  Yabeda.configure do
+    group :internal do
+      only :foo
+    end
+  end
+  ```
+
+  To exclude certain metrics from a group, use the `except` option:
+
+  ```ruby
+  Yabeda.configure do
+    group :internal do
+      adapter :prometheus
+      except :bar, :baz
+    end
+  end
+  ```
+
+## 0.15.0 - 2026-03-04
+
+### Fixed
+
+- Concurrency issues with metrics' increment/decrement helper methods. [@cconstantine-onesignal][] in [#45](https://github.com/yabeda-rb/yabeda/pull/45)
+
 ## 0.14.0 - 2025-09-10
 
 ### Added
@@ -215,3 +246,5 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 [@Keallar]: https://github.com/Keallar "Eugene Lysanskiy"
 [@jbockler]: https://github.com/jbockler "Josch Bockler"
 [@killondark]: https://github.com/killondark "Alexander Marychev"
+[@cconstantine-onesignal]: https://github.com/cconstantine-onesignal "Chris Constantine"
+[@sobrinho]: https://github.com/sobrinho "Gabriel Sobrinho"

data/Gemfile

@@ -13,8 +13,7 @@ group :development, :test do
   gem "yard"
   gem "yard-dry-initializer"
 
-  gem "pry"
-  gem "pry-byebug", platform: :mri
+  gem "debug"
 
   gem "rubocop", "~> 1.0", require: false
   gem "rubocop-rspec", require: false

data/README.md

@@ -158,6 +158,8 @@ These are developed and maintained by other awesome folks:
  - [yabeda-shoryuken](https://github.com/retsef/yabeda-shoryuken) — metrics for [Shoryuken](https://github.com/ruby-shoryuken/shoryuken) jobs execution message queues.
  - [yabeda-rack-ratelimit](https://github.com/basecamp/yabeda-rack-ratelimit) — metrics for [Rack::Ratelimit](https://github.com/jeremy/rack-ratelimit)
  - [yabeda-hanami](https://github.com/mlibrary/yabeda-hanami) — metrics for [Hanami](https://hanamirb.org/) The web, with simplicity.
+ - [yabeda-jemalloc](http://github.com/jondavidschober/yabeda-jemalloc) - metrics for [Jemalloc](https://jemalloc.net/) via the `stats` FFI
+ - [yabeda-rack-queue](https://github.com/speedshop/yabeda-rack-queue) - metrics for reporting queue times of Rack applications.
  - _…and more! You can write your own adapter and open a pull request to add it into this list._
 
 ## Configuration
@@ -260,6 +262,53 @@ Yabeda.configure do
 end
 ```
 
+## Filtering metrics
+
+You can control which metrics and groups are exposed for a given group using either an allow-list (`only`) or a deny-list (`except`).
+
+To permit only specific metrics for a group, use the `only` option:
+
+```ruby
+Yabeda.configure do
+  group :internal do
+    only :foo
+
+    counter :foo
+    gauge :bar
+  end
+end
+```
+
+To exclude certain metrics from a group, use the `except` option:
+
+```ruby
+Yabeda.configure do
+  group :internal do
+    adapter :prometheus
+
+    except :bar
+
+    counter :foo
+    gauge :bar
+  end
+end
+```
+
+This mechanism is especially useful for disabling unwanted metrics from third-party plugins.
+
+For example, [yabeda-activerecord](https://github.com/yabeda-rb/yabeda-activerecord) doesn't provide its own configuration to turn off metrics with high cardinality, such as `queries_total` and `query_duration`. You can disable them like this:
+
+```ruby
+require 'yabeda'
+require 'yabeda-activerecord'
+
+Yabeda.configure do
+  group :activerecord do
+    except :queries_total, :query_duration
+  end
+end
+```
+
 ## Roadmap (aka TODO or Help wanted)
 
  - Ability to change metric settings for individual adapters

data/lib/yabeda/base_adapter.rb

@@ -29,6 +29,13 @@ module Yabeda
       raise NotImplementedError, "#{self.class} doesn't support setting gauges"
     end
 
+    # Optional method that adapters can implement for native gauge increment/decrement
+    def perform_gauge_increment!(_gauge, _tags, _increment)
+      # used to indicate adapter does not implement this method. return a non-nil value
+      # in your adapter to indicate it is supported
+      nil
+    end
+
     def register_histogram!(_metric)
       raise NotImplementedError, "#{self.class} doesn't support histograms as metric type!"
     end

data/lib/yabeda/counter.rb

@@ -10,15 +10,11 @@ module Yabeda
     def increment(*args)
       tags, by = self.class.parse_args(*args)
       all_tags = ::Yabeda::Tags.build(tags, group)
-      values[all_tags] += by
+      value = increment_value(all_tags, by: by)
       adapters.each_value do |adapter|
         adapter.perform_counter_increment!(self, all_tags, by)
       end
-      values[all_tags]
-    end
-
-    def values
-      @values ||= Concurrent::Hash.new(0)
+      value
     end
 
     # @api private

data/lib/yabeda/dsl/class_methods.rb

@@ -12,6 +12,7 @@ require "yabeda/dsl/metric_builder"
 module Yabeda
   # DSL for ease of work with Yabeda
   module DSL
+    # rubocop:disable Metrics/ModuleLength
     module ClassMethods
       # Block for grouping and simplifying configuration of related metrics
       def configure(&block)
@@ -110,6 +111,26 @@ module Yabeda
       ensure @adapter_names = nil
       end
 
+      def only(*metric_names, group: @group)
+        if group
+          Yabeda.groups[group] ||= Yabeda::Group.new(group)
+          Yabeda.groups[group].only(*metric_names)
+        else
+          raise ConfigurationError, "Yabeda.only should be called either inside group declaration " \
+            "or should have group name provided. No metric group provided."
+        end
+      end
+
+      def except(*metric_names, group: @group)
+        if group
+          Yabeda.groups[group] ||= Yabeda::Group.new(group)
+          Yabeda.groups[group].except(*metric_names)
+        else
+          raise ConfigurationError, "Yabeda.except should be called either inside group declaration " \
+            "or should have group name provided. No metric group provided."
+        end
+      end
+
       def include_group(group)
         raise ConfigurationError, "Adapter limitation can't be defined without of group name" unless group
 
@@ -142,4 +163,5 @@ module Yabeda
       end
     end
   end
+  # rubocop:enable Metrics/ModuleLength
 end

data/lib/yabeda/gauge.rb

@@ -5,7 +5,8 @@ module Yabeda
   class Gauge < Metric
     def set(tags, value)
       all_tags = ::Yabeda::Tags.build(tags, group)
-      values[all_tags] = value
+      atomic_value = values[all_tags] ||= Concurrent::Atom.new(0)
+      atomic_value.swap { |_| value }
       adapters.each_value do |adapter|
         adapter.perform_gauge_set!(self, all_tags, value)
       end
@@ -18,7 +19,14 @@ module Yabeda
     #   @param by [Integer] increment value
     def increment(*args)
       tags, by = Counter.parse_args(*args)
-      set(tags, get(tags).to_i + by)
+      all_tags = ::Yabeda::Tags.build(tags, group)
+      next_value = increment_value(all_tags, by: by)
+      adapters.each_value do |adapter|
+        if adapter.perform_gauge_increment!(self, all_tags, by).nil?
+          adapter.perform_gauge_set!(self, all_tags, next_value)
+        end
+      end
+      next_value
     end
 
     # @overload decrement(tags = {}, by: 1)
@@ -27,7 +35,14 @@ module Yabeda
     #   @param by [Integer] decrement value
     def decrement(*args)
       tags, by = Counter.parse_args(*args)
-      set(tags, get(tags).to_i - by)
+      all_tags = ::Yabeda::Tags.build(tags, group)
+      next_value = increment_value(all_tags, by: -by)
+      adapters.each_value do |adapter|
+        if adapter.perform_gauge_increment!(self, all_tags, -by).nil?
+          adapter.perform_gauge_set!(self, all_tags, next_value)
+        end
+      end
+      next_value
     end
   end
 end

data/lib/yabeda/group.rb

@@ -26,6 +26,20 @@ module Yabeda
       @adapter.push(*adapter_names)
     end
 
+    def only(*metric_names)
+      return @only_list if metric_names.empty?
+
+      @only_list ||= Concurrent::Array.new
+      @only_list.push(*metric_names.map(&:to_sym))
+    end
+
+    def except(*metric_names)
+      return @except_list if metric_names.empty?
+
+      @except_list ||= Concurrent::Array.new
+      @except_list.push(*metric_names.map(&:to_sym))
+    end
+
     def register_metric(metric)
       define_singleton_method(metric.name) { metric }
     end

data/lib/yabeda/metric.rb

@@ -17,14 +17,11 @@ module Yabeda
     # rubocop:disable Layout/LineLength
     option :adapter, optional: true, comment: "Monitoring system adapter to register metric in and report metric values to (other adapters won't be used)"
     # rubocop:enable Layout/LineLength
+    option :values, optional: true, default: proc { Concurrent::Hash.new }
 
     # Returns the value for the given label set
     def get(labels = {})
-      values[::Yabeda::Tags.build(labels, group)]
-    end
-
-    def values
-      @values ||= Concurrent::Hash.new
+      @values[::Yabeda::Tags.build(labels, group)]&.value
     end
 
     # Returns allowed tags for metric (with account for global and group-level +default_tags+)
@@ -55,12 +52,25 @@ module Yabeda
       end
     end
 
-    # Redefined option reader to get group-level adapter if not set on metric level
-    # @api private
+    # Redefined option reader to get null adapter if metric is excluded from the group or from the only list in group,
+    # group-level adapter if not set on metric level, and adapter on metric level if set
+    # @api privatee
     def adapter
-      return ::Yabeda.groups[group]&.adapter if @adapter == Dry::Initializer::UNDEFINED
+      group = ::Yabeda.groups[self.group]
+
+      return :null_adapter if group&.except&.include?(name.to_sym) ||
+                              (group&.only && !group.only.include?(name.to_sym))
+
+      return group&.adapter if @adapter == Dry::Initializer::UNDEFINED
 
       super
     end
+
+    # Atomically increment the stored value, assumed to be given all labels, including group labels
+    # @api private
+    def increment_value(labels = {}, by: 1)
+      atomic_value = values[labels] ||= Concurrent::Atom.new(0)
+      atomic_value.swap { |prev| prev + by }
+    end
   end
 end

data/lib/yabeda/null_adapter.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+require_relative "base_adapter"
+
+module Yabeda
+  # Adapter that discards all metrics. Use when you want to disable metric export
+  # (e.g. in development or when no monitoring backend is configured).
+  class NullAdapter < BaseAdapter
+    def register_counter!(_metric); end
+
+    def perform_counter_increment!(_counter, _tags, _increment); end
+
+    def register_gauge!(_metric); end
+
+    def perform_gauge_set!(_gauge, _tags, _value); end
+
+    def register_histogram!(_metric); end
+
+    def perform_histogram_measure!(_histogram, _tags, _value); end
+
+    def register_summary!(_metric); end
+
+    def perform_summary_observe!(_summary, _tags, _value); end
+  end
+end

data/lib/yabeda/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Yabeda
-  VERSION = "0.14.0"
+  VERSION = "0.16.0"
 end

data/lib/yabeda.rb

@@ -8,6 +8,7 @@ require "yabeda/config"
 require "yabeda/dsl"
 require "yabeda/tags"
 require "yabeda/errors"
+require "yabeda/null_adapter"
 
 # Extendable framework for collecting and exporting metrics from Ruby apps
 module Yabeda
@@ -32,7 +33,9 @@ module Yabeda
 
     # @return [Hash<Symbol, Yabeda::BaseAdapter>] All loaded adapters
     def adapters
-      @adapters ||= Concurrent::Hash.new
+      @adapters ||= Concurrent::Hash.new.tap do |hash|
+        hash[:null_adapter] = Yabeda::NullAdapter.new
+      end
     end
 
     # @return [Array<Proc>] All collectors for periodical retrieving of metrics
@@ -138,7 +141,7 @@ module Yabeda
     # @api private
     def reset!
       default_tags.clear
-      adapters.clear
+      @adapters = nil
       groups.each_key { |group| singleton_class.send(:remove_method, group) if group && respond_to?(group) }
       @groups = nil
       metrics.each_key { |metric| singleton_class.send(:remove_method, metric) if respond_to?(metric) }

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: yabeda
 version: !ruby/object:Gem::Version
-  version: 0.14.0
+  version: 0.16.0
 platform: ruby
 authors:
 - Andrey Novikov
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-09-10 00:00:00.000000000 Z
+date: 2026-03-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: anyway_config
@@ -96,6 +96,7 @@ files:
 - lib/yabeda/group.rb
 - lib/yabeda/histogram.rb
 - lib/yabeda/metric.rb
+- lib/yabeda/null_adapter.rb
 - lib/yabeda/railtie.rb
 - lib/yabeda/rspec.rb
 - lib/yabeda/rspec/base_matcher.rb