Bump version to 0.1.4

CHANGELOG.md

@@ -1,5 +1,22 @@
 ## [Change Log]
 
+## [0.1.4] - 2025-01-14
+
+- Support instrumentation via event hook approach
+- Support metrics logging via StatsdListener
+
+## [0.1.3] - 2025-01-14
+
+- Support testing by mocking MockRedis#evalsha
+
+## [0.1.2] - 2025-01-07
+
+- Support auto-releasing gem
+
+## [0.1.1] - 2025-01-07
+
+- Allow configuring idempotent methods instead of hardcoding POST
+
 ## [0.1.0] - 2024-11-13
 
 - Initial release

Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    idempotency (0.1.3)
+    idempotency (0.1.4)
       base64
       dry-configurable
       dry-monitor

README.md

@@ -100,3 +100,31 @@ RSpec.configure do |config|
 end
 ```
 
+### Instrumentation
+
+The gem supports instrumentation through StatsD. It tracks the following metrics:
+
+- `idempotency_cache_hit_count` - Incremented when a cached response is found
+- `idempotency_cache_miss_count` - Incremented when no cached response exists
+- `idempotency_lock_conflict_count` - Incremented when concurrent requests conflict
+- `idempotency_cache_duration_seconds` - Histogram of operation duration
+
+Each metric includes tags:
+- `action` - Either the specified action name or `"{HTTP_METHOD}:{PATH}"`
+- `namespace` - Your configured namespace (if provided)
+- `metric` - The metric name (for duration histogram only)
+
+To enable above instrumentation, configure a StatsD listener:
+
+```ruby
+statsd_client = Datadog::Statsd.new
+statsd_listener = Idempotency::Instrumentation::StatsdListener.new(
+  statsd_client,
+  'my_service_name'
+)
+
+Idempotency.configure do |config|
+  config.instrumentation_listeners = [statsd_listener]
+end
+```
+

lib/idempotency/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 class Idempotency
-  VERSION = '0.1.3'
+  VERSION = '0.1.4'
 end