coder / slog
96%

DEFAULT BRANCH: main
Repo Added
Token RwaFMiyeLjsSbbPvnzRlCGnFaUGTPofYK regen
Build 169 Last
Files 12
Badge
Embed ▾
README BADGES
x

If you need to use a raster PNG badge, change the '.svg' to '.png' in the link

Markdown

Textile

RDoc

HTML

Rst

LAST BUILD ON BRANCH main
branch: SELECT
CHANGE BRANCH
x
Sync Branches

coverage: 96.08% (+0.05%) from 96.034%
a4f439e455e1db7c96c91b1c24bd5ca561e2df89

push

github

web-flow 
feat: add FlightRecorder sink for deferred low-level logging (#237)

* feat: add Buffer sink for deferred low-level logging

Buffer is a Sink that holds entries below a configured level in a
fixed-size in-memory ring, forwarding entries at or above the level
immediately. Flush replays the buffered entries to the wrapped sinks.

This lets a program run its logger at LevelDebug to capture verbose
entries while only emitting them on demand (e.g. on an error or
connection failure), with a configurable buffer size. When full, the
oldest entry is evicted.

* feat: add Flusher interface for deferred sinks

Flusher (Flush(ctx)) lets callers trigger a flush without depending on
the concrete Buffer type, which is handy when the buffer is created in
one place and flushed in another. Buffer implements it.

* refactor: rename buffer.go and buffer_test.go to flightrecorder.go and
flightrecorder_test.go

* refactor: rename Buffer to FlightRecorder

* refactor: make flight recording a Logger flag with auto-flush on error

Rework the flight recorder from a standalone Buffer/Flusher sink into a
Logger capability. Logger.FlightRecorder(size) enables a rolling
in-memory history of below-level entries; the history is flushed to the
sinks automatically when an entry at LevelError or above is logged, or
manually via Logger.Flush.

Enabling flight recording is independent of the Logger level, so it is
order-independent with Leveled(). Derived loggers (With, Named, Leveled)
share the underlying ring and capture their derived fields and names.

Replace the fill-tracking branch in the ring with a monotonic written
counter: the ring is allocated at full length and writes always land at
written%size, so the write path is branchless and drain derives the
entry count and oldest position from written.

* refactor: track ring position and length instead of unbounded counter

Replace the monotonic written counter with bounded pos and length fields,
so neither grows without limit and t... (continued)

61 of 63 new or added lines in 2 files covered. (96.83%)

956 of 995 relevant lines covered (96.08%)

99.66 hits per line

Relevant lines Covered
995 RELEVANT LINES 956 COVERED LINES
99.66 HITS PER LINE
Source Files on main

Recent builds

Builds Branch Commit Type Ran Committer Via Coverage
a4f439e4... main feat: add FlightRecorder sink for deferred low-level logging (#237) * feat: add Buffer sink for deferred low-level logging Buffer is a Sink that holds entries below a configured level in a fixed-size in-memory ring, forwarding entries at or abov... push web-flow github
96.08
5573165b... add-log-buffer-sink Merge 72b7255f8 into 244048fb9 Pull #237 web-flow github
96.08
198933e2... add-log-buffer-sink Merge 310f9fab1 into 244048fb9 Pull #237 web-flow github
96.09
596366c8... add-log-buffer-sink Merge 792bc1b10 into 244048fb9 Pull #237 web-flow github
96.04
9d465b7a... add-log-buffer-sink Merge 695581203 into 244048fb9 Pull #237 web-flow github
96.04
8097d450... add-log-buffer-sink Merge de93e212e into 244048fb9 Pull #237 web-flow github
96.04
8db1d452... dependabot/go_modules/google.golang.org/grpc-1.83.1 Merge 14357818b into 244048fb9 Pull #236 web-flow github
96.03
5ca8eb9c... dependabot/go_modules/cloud.google.com/go/logging-1.19.1 Merge 91952eec1 into 244048fb9 Pull #235 web-flow github
96.03
bc1f86e0... dependabot/go_modules/otel-da2746b111 Merge 81495d7c4 into 244048fb9 Pull #234 web-flow github
96.03
af41645d... dependabot/go_modules/google.golang.org/grpc-1.82.1 Merge 4c34f5122 into 244048fb9 Pull #233 web-flow github
96.03
See All Builds (169)

Badge your Repo: slog

We detected this repo isn’t badged! Grab the embed code to the right, add it to your repo to show off your code coverage, and when the badge is live hit the refresh button to remove this message.
Embed ▾
README BADGES
x

If you need to use a raster PNG badge, change the '.svg' to '.png' in the link

Markdown

Textile

RDoc

HTML

Rst

Refresh