app_pulse 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7c1aec98d66b0f9fd087644ebee850f073ea9c72c442fe1bc4bbcc786e8582f9
-  data.tar.gz: 2d8cf0ba73dd26124f22501824822b23cd26a93b25198a8a1363d1eae48566c9
+  metadata.gz: 6888fe36e5d524ac66e2271ce7ec98616d288ecb5ab9063757bf855eb46442fe
+  data.tar.gz: 51510fc7a1b30b64c225fd52d0d9493303ac49e7ba2af9e6380876cbeabfde50
 SHA512:
-  metadata.gz: fbf275986ceb81b3bd263989a5993f1b58ccca8dc9b89ab531a70a8e1e5256b8346f41efcdd2b9a630f62c3e3094fae9718f74282199a42691a5d9830194a450
-  data.tar.gz: c95753a115e8de8cdc47c7d3c69be8d6a2a9b46507a76d00e528518a5067f4a1d22a6d8fa44f309faf75a8f2569fc35255eca232f3a18336bd32c1f3505de6ee
+  metadata.gz: a9e261eee9d6f4b6852a350db3f9b9d76b0fbc79b6713004685a508fcd238d6aafade804a970e310b23f14af7a190a41e536f800cec471cf0439afa09cc22737
+  data.tar.gz: 5a9220e56f30d779356dc9ed496396eda00c98b9fcf2ad1fba9be7437cb42b5f9bcc2da34ea62a04b963d7753a0a99ec8d63c667a944d9f8ec3bba1d036ec398

data/CHANGELOG.md

@@ -1,4 +1,17 @@
 # CHANGELOG
+
+## [0.2.0] – Signal Filtering
+
+### Added
+- Configurable slow request threshold (`slow_threshold_ms`)
+- Ability to collect only slow requests without changing signal semantics
+
+### Notes
+- Filtering is applied after sampling
+- Default behavior is unchanged when the threshold is not set
+- No insights, rankings, or opinions are introduced
+- Backward compatible and opt-in
+
 ## [0.1.1] – Packaging Fix
 
 ### Fixed

data/README.md

@@ -1,3 +1,5 @@
+[![Gem Version](https://badge.fury.io/rb/app_pulse.svg)](https://rubygems.org/gems/app_pulse)
+
 # app_pulse
 
 > **Lightweight request signal collection for Ruby applications**  
@@ -76,6 +78,7 @@ AppPulse.configure do |config|
   config.output_path = "log/app_pulse"
   config.output_format = :csv
   config.sampling_rate = 1.0
+  config.slow_threshold_ms = 500
 end
 ```
 
@@ -85,6 +88,7 @@ require "app_pulse"
 
 AppPulse.configure do |config|
   config.output_path = "log/app_pulse"
+  config.slow_threshold_ms = 500
 end
 
 use AppPulse::Middleware::Request
@@ -161,7 +165,36 @@ Sampling is:
 
 - Industry standard
 
-#Fault Tolerance
+## Slow Request Threshold
+
+By default, app_pulse collects all sampled requests.
+
+You can optionally configure a slow request threshold to collect
+only requests that exceed a given duration.
+
+```ruby
+config.slow_threshold_ms = 500
+```
+**Behavior:**
+
+- `nil` (default) → collect all requests
+
+- `500` → collect only requests taking 500ms or longer
+
+This helps reduce noise in high-traffic applications
+without changing the meaning of collected signals.
+
+**Notes:**
+
+- The threshold is applied after sampling
+
+- No errors or insights are inferred
+
+- This is a filtering mechanism, not an optimization
+
+--- 
+
+## Fault Tolerance
 
 - Errors inside app_pulse never break your app
 
@@ -171,7 +204,9 @@ Sampling is:
 
 - Observability must never affect availability.
 
-#Compatibility
+---
+
+## Compatibility
 **Ruby**
 
 - Ruby 2.3+ (tested on 2.3.8 and modern Ruby)
@@ -196,53 +231,116 @@ Sampling is:
 
 - No ActiveSupport
 
+---
+
+# Versioning
+
+`app_pulse` follows Semantic Versioning with a deliberately conservative approach.
+
+- **v0.x**
+
+  - Core behavior is stable
+
+  - Internal structure may evolve
+
+  - New features are additive and opt-in
+
+  - Breaking changes (if any) are documented clearly
+
+- **v1.0**
+
+  - Core APIs are frozen
+
+  - Extension points are finalized
+
+  - Intended for long-term production use
+
+Version bumps are intentional and documented in the changelog.
+
+---
 # Roadmap
-**v0.1.0 (current)**
 
-- Request lifecycle collection
+- **v0.1.x**
+
+  - Request lifecycle signal collection
+
+  - Rack middleware
+
+  - CSV / JSON / Text writers
+
+  - File-based storage
+
+  - Configurable sampling
+
+  - Production-safe, fault-tolerant design
 
-- CSV / JSON / Text writers
+- **v0.2.x**
 
-- Rack middleware
+  - Configurable signal filtering
 
-- File-based storage
+  - Slow request thresholds
 
-**Planned**
+- **v0.3.x**
 
-- v0.2.x → configurable thresholds
+  - Aggregation helpers
 
-- v0.3.x → aggregation helpers
+  - Slow endpoint identification
 
-- v1.0 → stable observability core
+  - Error frequency summaries
 
-**Future Extensions (separate gems)**
+  - Structured data preparation for reports
 
-- `app_pulse-sql`
+- **v1.0**
 
-- `app_pulse-jobs`
+  - Stable observability core
 
-- `app_pulse-exporter`
+  - Frozen public APIs
 
-- `app_pulse-dashboard`
+  - Extension-ready architecture
 
-**Development & Testing**
+- **Future Extensions (separate projects)**
+
+  - `app_pulse-sql` → database query timing
+
+  - `app_pulse-jobs` → background job tracking
+
+  - `app_pulse-exporter` → external systems
+
+  - `app_pulse-dashboard` → UI & reports
+
+---
+
+## Development & Testing
 
 - RSpec for unit tests
 
 - Tested with:
 
-- - Rails (modern Ruby)
+    - Rails (modern Ruby)
 
-- - Rack (Ruby 2.3)
+    - Rack (Ruby 2.3)
 
 - RuboCop compatible
 
 - No CI lock-in
 
-#License
+# License
 
 MIT License © Virendra Jadhav
 
+## Feedback & Roadmap
+
+app_pulse is intentionally minimal in its early versions.
+
+Feedback, real-world use cases, and design discussions are welcome.
+Please open an issue for:
+- feature requests
+- design questions
+- integration ideas
+
+Dashboards and insights are planned as separate projects.
+
+
 **Final Notes**
 
 `app_pulse` is intentionally boring.

data/lib/app_pulse/collectors/request_collector.rb

@@ -9,6 +9,7 @@ module AppPulse
       class << self
         def collect(env:, status:, duration:, error: nil)
           return unless sample?
+          return unless slow_enough?(duration)
 
           data = build_payload(env, status, duration, error)
           writer.write(data)
@@ -37,6 +38,12 @@ module AppPulse
         def sample?
           rand <= AppPulse.config.sampling_rate
         end
+        def slow_enough?(duration)
+          threshold = AppPulse.config.slow_threshold_ms
+          return true unless threshold
+
+          duration >= threshold
+        end
       end
     end
   end

data/lib/app_pulse/version.rb

@@ -1,3 +1,3 @@
 module AppPulse
-  VERSION = "0.1.1"
+  VERSION = "0.2.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: app_pulse
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - Virendra Jadhav
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-01-10 00:00:00.000000000 Z
+date: 2026-01-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec