philiprehberger-metric
In-process application metrics with counters, gauges, histograms, and summaries
Requirements
- Ruby >= 3.1
Installation
Add to your Gemfile:
gem "philiprehberger-metric"Or install directly:
gem install philiprehberger-metricUsage
require "philiprehberger/metric"
Philiprehberger::Metric.counter("http_requests_total", help: "Total HTTP requests")
Philiprehberger::Metric.increment("http_requests_total", labels: { method: "GET" })
counter = Philiprehberger::Metric.get("http_requests_total")
counter.get(labels: { method: "GET" }) # => 1Counters
Philiprehberger::Metric.counter("events_total", help: "Total events processed")
Philiprehberger::Metric.increment("events_total")
Philiprehberger::Metric.increment("events_total", labels: { type: "click" })Gauges
Philiprehberger::Metric.gauge("temperature", help: "Current temperature")
Philiprehberger::Metric.set("temperature", 72.5)
gauge = Philiprehberger::Metric.get("temperature")
gauge.increment
gauge.decrementHistograms
Philiprehberger::Metric.histogram("request_duration", help: "Request duration", buckets: [0.1, 0.5, 1, 5, 10])
Philiprehberger::Metric.observe("request_duration", 0.342)
data = Philiprehberger::Metric.snapshot("request_duration")Summaries
Philiprehberger::Metric.summary("response_size", help: "Response sizes", quantiles: [0.5, 0.9, 0.99])
Philiprehberger::Metric.observe("response_size", 1024)
Philiprehberger::Metric.observe("response_size", 2048)
summary = Philiprehberger::Metric.get("response_size")
summary.get # => { count: 2, sum: 3072.0, 0.5 => 1024.0, 0.9 => 2048.0, 0.99 => 2048.0 }Timing Helper
registry = Philiprehberger::Metric::Registry.new
registry.histogram("operation_duration", help: "Operation duration")
result = registry.time("operation_duration", labels: { op: "compute" }) do
expensive_operation
endPrometheus Export
output = Philiprehberger::Metric.to_prometheus
# => "# HELP http_requests_total Total HTTP requests\n# TYPE http_requests_total counter\n..."JSON Export
json = Philiprehberger::Metric.to_json
# => '{"http_requests_total":{"type":"counter","help":"Total HTTP requests","values":{...}}}'StatsD Export
output = Philiprehberger::Metric.to_statsd
# => "http_requests_total,method=GET:1|c"API
Metric (Module)
| Method | Description |
|---|---|
.counter(name, help:) |
Register a counter metric |
.gauge(name, help:) |
Register a gauge metric |
.histogram(name, help:, buckets:) |
Register a histogram metric |
.summary(name, help:, quantiles:) |
Register a summary metric |
.increment(name, labels:) |
Increment a counter |
.set(name, value, labels:) |
Set a gauge value |
.observe(name, value, labels:) |
Observe a histogram or summary value |
.time(name, labels:) { block } |
Measure block duration as histogram observation |
.get(name) |
Get a registered metric by name |
.snapshot(name) |
Get a snapshot of a metric's values |
.to_prometheus |
Export all metrics in Prometheus text format |
.to_json |
Export all metrics as JSON |
.to_statsd |
Export all metrics in StatsD line protocol |
.reset |
Reset and clear all registered metrics |
Counter
| Method | Description |
|---|---|
#increment(amount:, labels:) |
Increment the counter |
#get(labels:) |
Get the current value |
Gauge
| Method | Description |
|---|---|
#set(value, labels:) |
Set the gauge value |
#increment(amount:, labels:) |
Increment the gauge |
#decrement(amount:, labels:) |
Decrement the gauge |
#get(labels:) |
Get the current value |
Histogram
| Method | Description |
|---|---|
#observe(value, labels:) |
Observe a value |
#get(labels:) |
Get bucket counts, sum, and count |
Summary
| Method | Description |
|---|---|
#observe(value, labels:) |
Observe a value |
#get(labels:) |
Get quantile values, sum, and count |
Development
bundle install
bundle exec rspec
bundle exec rubocopSupport
If you find this project useful: