exis_ray 0.5.3 → 0.5.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d8bf4b504bfe6112b50328a358879a63b5ff19832e4724711a4650a110c94aaf
-  data.tar.gz: fd3332690b0ff0b3ca95ccf4dddbddcb99322fd01481f9da4e11a12d3f0bf801
+  metadata.gz: 13877001eee2022a6c6de0d2709ef5080b0cc2e43459d5e81ea99d9f28f9b216
+  data.tar.gz: c6b551a316813a3671ae980a0fc8061b32fc1b585bc39b49a5c761a73c3af145
 SHA512:
-  metadata.gz: 639eb1ab36f013dbf034dd7be88e5c13ab77779ed6a130d0f28cb75ace6baf36b0bb7b387f7ec77cb9a37236cb5ac703daa9bfa7116160aeee59ccc18e43b9be
-  data.tar.gz: '0882e98c833ebc8774e47f2ddca1d33ce73fd9b7d8a5427b9851eafcab4323c41b0253d512e2ec9b0fd2391120f6390eeb1be2995d924a3674e155cda7c36dcb'
+  metadata.gz: e41a2bc99ab67896aac64e6eb8becca74fd03217807fa16e24ed434477109b053f9d9580b206a2c4f4123fefa6beca5f580b934e22c468175d20fa808179a7eb
+  data.tar.gz: 80bc6a49ea2b9ed2e4b45aa3f4e501752edb2d5873a8871cce6ba3b4e1bf4f925fb793a3ba5ab1a0f9c717d4ee63c9411bc1d738ab7d9a742ed48585071664fd

data/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [0.5.4] - 2026-03-24
+
+### Changed
+- **Human-readable durations:** `duration_human` now uses a smarter format: sub-second values show as `"7.2ms"`, values under 60s show as `"1.25s"`, and longer durations use `ActiveSupport::Duration` prose (e.g., `"2 minutes 5 seconds"`).
+- **Shared duration helper:** Extracted `ExisRay::Tracer.format_duration` to consolidate duration formatting used by both `LogSubscriber` and `TaskMonitor`.
+
 ## [0.5.3] - 2026-03-24
 
 ### Changed

data/README.md

@@ -286,6 +286,25 @@ If you don't need extra fields, skip this step — `ExisRay::LogSubscriber` is u
 * **`ExisRay::LogSubscriber`**: Replaces Lograge for HTTP request logging. Subscribes to `process_action.action_controller` and suppresses Rails' default multi-line log subscribers. Compatible with Rails 6, 7, and 8. Subclass it and override `self.extra_fields(event)` to inject custom fields.
 * **`ExisRay::TaskMonitor`**: The entry point for non-HTTP processes.
 
+## Known Behaviors
+
+### Third-party gem warnings in `body`
+
+ExisRay captures all log output — including warnings emitted by third-party gems — and routes free-text lines to the `body` field. Some gems may include user-identifying data in their warnings.
+
+**Example:** The [Bullet](https://github.com/flyerhzm/bullet) N+1 query detector emits warnings like:
+
+```
+user: gabriel
+GET /clients?page=1
+USE eager loading detected
+  Client => [:gps_point]
+```
+
+This text lands verbatim in `body`. ExisRay does not filter or redact `body` content, as it cannot know what third-party gems will include.
+
+**Recommendation:** If you use Bullet or similar gems in production, configure them to use a separate notification channel (e.g., Slack, Honeybadger) instead of `Rails.logger`, to avoid leaking usernames or other PII into your structured logs.
+
 ## License
 
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/lib/exis_ray/log_subscriber.rb

@@ -84,7 +84,7 @@ module ExisRay
         action:         payload[:action],
         status:         status,
         duration_s:     duration_s,
-        duration_human: ActiveSupport::Duration.build(duration_s).inspect,
+        duration_human: ExisRay::Tracer.format_duration(duration_s),
         view_runtime_s: view_s,
         db_runtime_s:   db_s
       }

data/lib/exis_ray/task_monitor.rb

@@ -35,12 +35,12 @@ module ExisRay
       execute_with_optional_tags { yield }
 
       duration_s = ExisRay::Tracer.current_duration_s
-      human_time = ActiveSupport::Duration.build(duration_s).inspect
+      human_time = ExisRay::Tracer.format_duration(duration_s)
 
       log_event(:info, "component=exis_ray event=task_finished task=#{task_name} status=success duration_s=#{duration_s} duration_human=\"#{human_time}\"")
     rescue StandardError => e
       duration_s = ExisRay::Tracer.current_duration_s
-      human_time = ActiveSupport::Duration.build(duration_s).inspect
+      human_time = ExisRay::Tracer.format_duration(duration_s)
 
       log_event(:error, "component=exis_ray event=task_finished task=#{task_name} status=failed duration_s=#{duration_s} duration_human=\"#{human_time}\" error_class=#{e.class} error_message=#{e.message.inspect}")
       raise e

data/lib/exis_ray/tracer.rb

@@ -70,6 +70,23 @@ module ExisRay
       (Process.clock_gettime(Process::CLOCK_MONOTONIC) - created_at).round(4)
     end
 
+    # Formatea una duración en segundos a un string legible por humanos.
+    # - Menos de 1s  → "7.2ms"
+    # - Entre 1-60s  → "1.25s"
+    # - 60s o más    → "2 minutes 5 seconds" (via ActiveSupport::Duration)
+    #
+    # @param seconds [Float] Duración en segundos.
+    # @return [String]
+    def self.format_duration(seconds)
+      if seconds < 1.0
+        "#{(seconds * 1000).round(1)}ms"
+      elsif seconds < 60.0
+        "#{seconds.round(3)}s"
+      else
+        ActiveSupport::Duration.build(seconds.round).inspect
+      end
+    end
+
     # Construye el header de trazabilidad para enviar al siguiente servicio.
     #
     # @return [String] Header formateado: "Root=...;Self=...;CalledFrom=...;TotalTimeSoFar=...ms"

data/lib/exis_ray/version.rb

@@ -2,5 +2,5 @@
 
 module ExisRay
   # Versión actual de la gema.
-  VERSION = "0.5.3"
+  VERSION = "0.5.4"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: exis_ray
 version: !ruby/object:Gem::Version
-  version: 0.5.3
+  version: 0.5.4
 platform: ruby
 authors:
 - Gabriel Edera