philiprehberger-structured_logger 0.3.4 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3c97dff36fddffd8ef26c0e08eee6912b41509c203803ef11d467b8e64fa8a1a
-  data.tar.gz: 6bb760bfb58992ca97db27ef7b5a220617984256f488a2eae4e7f1bd7320eab9
+  metadata.gz: dc7adb741998f54fcb27d66e78322d0abcb77c6537298e8b8d9be58b999bf571
+  data.tar.gz: bbeea6cf1479ffa7548be5ab32cdaca87dc42c8d5657a778e1e71574056ac4f1
 SHA512:
-  metadata.gz: 935b133170aacfd15bd0b9152cd30dd845a807fcf0e31d417fda1c2d6186c2ed0acedb11156554420370630a6151037697fa2a0f903cabe989fbb6a59234dae5
-  data.tar.gz: 2f30001a038326c9eb53e2427f85a905f001a1781bc91968e86e2ceff0a49b3bb4b0e606609242675630a73bebcd5eb3829546413f1113225ebdb06f99ca7cb3
+  metadata.gz: 67ac2a22e4a7b1b3397256fc39e9e04d11fe219b21096fd1b3c8e9996bb98f8120859baa378448d33cfe55425759c406aac72f17520582fcda4ad23e4171c4a2
+  data.tar.gz: db854b806432b15b8b891592011f02ca39741975657ef1948d6fcfad6f5408e69101b7100b46007b03588216fd85cb997c7d91fbfa299d99dcff82c88fdb5ace

data/CHANGELOG.md

@@ -7,6 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.4.0] - 2026-04-17
+
+### Added
+- `Logger#measure(event, **context) { block }` yields to the block, captures elapsed time, and emits a single info-level structured event with `duration_ms` (plus `error`/`error_class` on failure; original exception re-raised)
+
+## [0.3.5] - 2026-03-31
+
+### Added
+- Add GitHub issue templates, dependabot config, and PR template
+
 ## [0.3.4] - 2026-03-31
 
 ### Changed

data/README.md

@@ -121,6 +121,23 @@ end
 logger.log_exception(e, level: :fatal, user_id: 42)
 ```
 
+### Timing a block
+
+Use `measure` to time a block and emit a single structured event with `duration_ms`:
+
+```ruby
+logger.measure("db.query", table: "users") { User.find(1) }
+# => {"timestamp":"...","level":"info","message":"db.query","event":"db.query","table":"users","duration_ms":12.345}
+```
+
+On failure, the original exception is re-raised and the log entry also includes `error` and `error_class`:
+
+```ruby
+logger.measure("db.query") { raise "boom" }
+# => {"timestamp":"...","level":"info","message":"db.query","event":"db.query","duration_ms":0.123,"error":"boom","error_class":"RuntimeError"}
+# RuntimeError: boom
+```
+
 ### Multiple Outputs
 
 Log to multiple destinations simultaneously. Each output can have its own level filter and formatter:
@@ -257,6 +274,7 @@ When the buffer is full, writes fall back to synchronous mode (backpressure) to
 | `with_context(**extra, &block)` | Temporarily merge context for a block |
 | `silence(level = :fatal, &block)` | Temporarily raise log level for a block |
 | `log_exception(exception, level: :error, **extra)` | Log exception details |
+| `measure(event_name, **context) { block }` | Time a block, emit an info event with `duration_ms`, and re-raise on failure |
 | `add_output(io, level: nil, formatter: nil)` | Add an output destination at runtime |
 | `with_correlation_id(id = nil, &block)` | Set a correlation ID for the block |
 | `flush` | Force write of all buffered log entries |

data/lib/philiprehberger/structured_logger/logger.rb

@@ -76,6 +76,41 @@ module Philiprehberger
             **extra)
       end
 
+      # Yields to the given block, measures its monotonic wall-clock
+      # duration, and emits a single info-level log entry describing the
+      # outcome. On success, the block's return value is returned. On
+      # exception, the failure is logged and the original exception is
+      # re-raised.
+      #
+      # @param event_name [String, Symbol] the event name to record as
+      #   the `event` field in the log entry.
+      # @param context [Hash] extra context merged into the log entry.
+      # @yield executes the measured block.
+      # @return [Object] the block's return value on success.
+      # @raise re-raises any exception raised by the block.
+      #
+      # @example Measuring a database query
+      #   logger.measure('db.query', table: 'users') { User.find(1) }
+      #   # logs event: 'db.query', table: 'users', duration_ms: 12.345
+      def measure(event_name, **context)
+        start = Process.clock_gettime(Process::CLOCK_MONOTONIC)
+        begin
+          result = yield
+          duration_ms = ((Process.clock_gettime(Process::CLOCK_MONOTONIC) - start) * 1000.0).round(3)
+          log(:info, event_name.to_s, event: event_name, duration_ms: duration_ms, **context)
+          result
+        rescue StandardError => e
+          duration_ms = ((Process.clock_gettime(Process::CLOCK_MONOTONIC) - start) * 1000.0).round(3)
+          log(:info, event_name.to_s,
+              event: event_name,
+              duration_ms: duration_ms,
+              error: e.message,
+              error_class: e.class.name,
+              **context)
+          raise
+        end
+      end
+
       def flush
         @monitor.synchronize { @outputs.each { |out| out[:io].flush if out[:io].respond_to?(:flush) } }
       end

data/lib/philiprehberger/structured_logger/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module StructuredLogger
-    VERSION = '0.3.4'
+    VERSION = '0.4.0'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-structured_logger
 version: !ruby/object:Gem::Version
-  version: 0.3.4
+  version: 0.4.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-03-31 00:00:00.000000000 Z
+date: 2026-04-18 00:00:00.000000000 Z
 dependencies: []
 description: A zero-dependency Ruby gem for structured JSON logging with context merging,
   child loggers, level filtering, and pluggable outputs.
@@ -26,11 +26,11 @@ files:
 - lib/philiprehberger/structured_logger/formatter.rb
 - lib/philiprehberger/structured_logger/logger.rb
 - lib/philiprehberger/structured_logger/version.rb
-homepage: https://github.com/philiprehberger/rb-structured-logger
+homepage: https://philiprehberger.com/open-source-packages/ruby/philiprehberger-structured_logger
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://github.com/philiprehberger/rb-structured-logger
+  homepage_uri: https://philiprehberger.com/open-source-packages/ruby/philiprehberger-structured_logger
   source_code_uri: https://github.com/philiprehberger/rb-structured-logger
   changelog_uri: https://github.com/philiprehberger/rb-structured-logger/blob/main/CHANGELOG.md
   rubygems_mfa_required: 'true'