fast-prometheus 0.1.0

data/lib/fast/prometheus/snapshot.rb

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+
+module Fast
+  module Prometheus
+    # Immutable value types for snapshots. Deep-frozen Data types.
+
+    HistogramValue = Data.define(:sum, :count, :cumulative_buckets)
+
+    NativeHistogramValue = Data.define(:schema, :zero_threshold, :zero_count, :sum, :count,
+                                       :positive_buckets, :negative_buckets)
+
+    Series = Data.define(:labels, :value)
+
+    SummaryValue = Data.define(:sum, :count)
+
+    MetricSnapshot = Data.define(:name, :docstring, :type, :label_names, :series) do
+      # Build a MetricSnapshot from a live metric. Reads only public readers
+      # and copies all mutable structures. The whole build runs under the
+      # metric's lock so no series is observed mid-mutation and no writer
+      # interleaves between series.
+      def self.of(metric)
+        metric.synchronize do
+          new(
+            metric.name,
+            metric.docstring,
+            metric.type,
+            metric.label_names.dup.freeze,
+            build_series(metric).freeze
+          )
+        end
+      end
+
+      def self.build_series(metric)
+        metric.values.map do |labels, value|
+          Series.new(
+            labels: labels.dup.freeze,
+            value: build_value(metric.type, value)
+          )
+        end
+      end
+
+      private_class_method def self.build_value(type, value)
+        case type
+        when :counter, :gauge
+          value
+        when :histogram
+          HistogramValue.new(
+            sum: value.sum,
+            count: value.count,
+            cumulative_buckets: value.cumulative_buckets.map { |pair| pair.dup.freeze }.freeze
+          )
+        when :summary
+          SummaryValue.new(sum: value.sum, count: value.count)
+        when :native_histogram
+          NativeHistogramValue.new(
+            schema: value.schema,
+            zero_threshold: value.zero_threshold,
+            zero_count: value.zero_count,
+            sum: value.sum,
+            count: value.count,
+            positive_buckets: value.positive_buckets.map { |pair| pair.dup.freeze }.freeze,
+            negative_buckets: value.negative_buckets.map { |pair| pair.dup.freeze }.freeze
+          )
+        end
+      end
+    end
+
+    Snapshot = Data.define(:metrics, :taken_at) do
+      # Build a Snapshot from an array of live metrics.
+      def self.of(metrics)
+        new(
+          metrics.map { |metric| MetricSnapshot.of(metric) }.freeze,
+          Time.now
+        )
+      end
+    end
+  end
+end

data/lib/fast/prometheus/store.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+require "monitor"
+
+module Fast
+  module Prometheus
+    # Store holds one metric's per-series data plus the lock guarding it.
+    # Metrics produced by Metric#with_labels share their parent's Store (and
+    # therefore its lock) via the store: keyword.
+    #
+    # Monitor is reentrant: a thread already inside #synchronize (e.g. a
+    # derived reader delegating to another locked method, or Metric#synchronize
+    # driving MetricSnapshot.of) can re-enter without deadlocking itself.
+    class Store
+      def initialize
+        @data = {}
+        @monitor = Monitor.new
+      end
+
+      def synchronize(&block)
+        @monitor.synchronize(&block)
+      end
+
+      def [](key)
+        @data[key]
+      end
+
+      def []=(key, value)
+        @data[key] = value
+      end
+
+      def to_h
+        @data.dup
+      end
+    end
+  end
+end

data/lib/fast/prometheus/summary.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+require_relative "metric"
+
+module Fast
+  module Prometheus
+    # Summary accumulates observations as sum + count per label set.
+    # Unlike the histogram, it provides no quantile computation.
+    class Summary < Metric
+      # Value holds the accumulated sum and count for a single label set.
+      class Value
+        attr_accessor :sum, :count
+
+        def initialize
+          @sum = 0.0
+          @count = 0
+        end
+      end
+
+      def type
+        :summary
+      end
+
+      def observe(value, labels: {})
+        key = resolve(labels)
+        store.synchronize do
+          slot = store[key] ||= Value.new
+          slot.sum += value
+          slot.count += 1
+        end
+      end
+
+      def get(labels: {})
+        key = resolve(labels)
+        store.synchronize { store[key] }
+      end
+
+      protected
+
+      def validate_label_names(labels)
+        labels.each do |label|
+          name = label.to_s
+          raise InvalidLabelName, "reserved label name: :quantile" if name == "quantile"
+        end
+
+        super
+      end
+    end
+  end
+end

data/lib/fast/prometheus/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Fast
+  module Prometheus
+    VERSION = "0.1.0"
+  end
+end

data/lib/fast/prometheus.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require_relative "prometheus/version"
+require_relative "prometheus/errors"
+require_relative "prometheus/metric"
+require_relative "prometheus/counter"
+require_relative "prometheus/gauge"
+require_relative "prometheus/histogram"
+require_relative "prometheus/summary"
+require_relative "prometheus/native_histogram"
+require_relative "prometheus/registry"
+require_relative "prometheus/snapshot"
+
+module Fast
+  module Prometheus
+  end
+end

metadata

@@ -0,0 +1,158 @@
+--- !ruby/object:Gem::Specification
+name: fast-prometheus
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Eric Jacobs
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: async
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.38'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.38'
+- !ruby/object:Gem::Dependency
+  name: protocol-http
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.60'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.60'
+- !ruby/object:Gem::Dependency
+  name: async-http
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.95'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.95'
+- !ruby/object:Gem::Dependency
+  name: async-grpc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+- !ruby/object:Gem::Dependency
+  name: google-protobuf
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.35'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.35'
+- !ruby/object:Gem::Dependency
+  name: console
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.37'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.37'
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- AGENTS.md
+- CHANGELOG.md
+- README.md
+- lib/fast/prometheus.rb
+- lib/fast/prometheus/counter.rb
+- lib/fast/prometheus/errors.rb
+- lib/fast/prometheus/exposition.rb
+- lib/fast/prometheus/formats/metrics_pb.rb
+- lib/fast/prometheus/formats/protobuf.rb
+- lib/fast/prometheus/formats/text.rb
+- lib/fast/prometheus/gauge.rb
+- lib/fast/prometheus/histogram.rb
+- lib/fast/prometheus/metric.rb
+- lib/fast/prometheus/middleware/exporter.rb
+- lib/fast/prometheus/middleware/instrumentation.rb
+- lib/fast/prometheus/native_histogram.rb
+- lib/fast/prometheus/otlp/grpc_exporter.rb
+- lib/fast/prometheus/otlp/http_exporter.rb
+- lib/fast/prometheus/otlp/mapper.rb
+- lib/fast/prometheus/otlp/pb/opentelemetry/proto/collector/metrics/v1/metrics_service_pb.rb
+- lib/fast/prometheus/otlp/pb/opentelemetry/proto/common/v1/common_pb.rb
+- lib/fast/prometheus/otlp/pb/opentelemetry/proto/metrics/v1/metrics_pb.rb
+- lib/fast/prometheus/otlp/pb/opentelemetry/proto/resource/v1/resource_pb.rb
+- lib/fast/prometheus/otlp/push.rb
+- lib/fast/prometheus/otlp/service_interface.rb
+- lib/fast/prometheus/rack/exporter.rb
+- lib/fast/prometheus/rack/instrumentation.rb
+- lib/fast/prometheus/registry.rb
+- lib/fast/prometheus/request_metrics.rb
+- lib/fast/prometheus/snapshot.rb
+- lib/fast/prometheus/store.rb
+- lib/fast/prometheus/summary.rb
+- lib/fast/prometheus/version.rb
+homepage: https://github.com/jetpks/fast-prometheus
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/jetpks/fast-prometheus
+  source_code_uri: https://github.com/jetpks/fast-prometheus
+  changelog_uri: https://github.com/jetpks/fast-prometheus/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.3'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.10
+specification_version: 4
+summary: A fiber-native Prometheus client for modern Ruby.
+test_files: []