yabeda 0.15.0 → 0.16.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4a403c359e0c88e79f3352df2521a880d17c2fee74457cd911e776d51042060f
-  data.tar.gz: 795a2312ba8de8ff41198444b87614fae3eb5fa803feed950f83d965c67f76a8
+  metadata.gz: e1c0a1298576c5e12a8c7acd4cda088fab78b155e846d6aa0c8865638488a5ab
+  data.tar.gz: ef0ba94b3fb39fd022e1aeb272104f46729f22aa10da6ba338cd2d91492883bd
 SHA512:
-  metadata.gz: 1e432f7754fcbe31703dca2f753e8c19552e7e941a7e9e064430cd34066fbfb8f714920af8a8c88c2b1deadeab4f6ec464b24bc466d413d2f819670d59d21a70
-  data.tar.gz: 88f8f047866dff1244fc5609586d2ec4560bae818c926fae2de5428c073ebc10655ea3997a163d9923f86ef63720614ea3b49236025a54f91c27673564c0f4d0
+  metadata.gz: 0effc951709196bbfb6f266211710704645502997c0ee8864d2514d204467a7206eb4550fde040a00d15dde811d85e0ed6eb237939417a6ce41bbd4c310fe6b8
+  data.tar.gz: f74760379893fade4bc37635dbbbd0f851a52635ebc50a210eed5531ca2e4b3a2a225cfdbd3d63e38af9dded14d6eaa518f853ff3b7ec63f7ae6ffb919969589

data/CHANGELOG.md

@@ -7,6 +7,31 @@ 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
@@ -222,3 +247,4 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 [@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/README.md

@@ -262,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/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/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

@@ -52,10 +52,16 @@ 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

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.15.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.15.0
+  version: 0.16.0
 platform: ruby
 authors:
 - Andrey Novikov
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-03-04 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