/ 
Punk-Observe-0.09

Changes for version 0.09 - 2026-09-16

  • Fixes: the flamegraph dropped the ROOT SPAN of every trace. The store hands back a parent span id and the trace page ran it through the resolver written for Trace::analyse's parent INDEX, so the root indexed itself, assembly read that as a cycle and the frame builder skipped it. Both were called `parent`; they are `parent_span_id` and `parent_index` now, so the two cannot be confused again. The waterfall beside it was always right, which is why this went unseen.
  • Fixes: collapsing a subtree in the waterfall hid the wrong rows. Rows are emitted chronologically, so descendants are not adjacent when sibling subtrees overlap in time; it walked forward while depth was greater. Collapse is by parent identity now, and every row carries data-parent.
  • Fixes: a span in a cycle has depth -1 and was indented -9px, out of its own cell. Clamped, and such a row no longer collapses.

Modules

Punk::Observe
an OpenTelemetry observability and logging backend
Punk::Observe::Alert
rule evaluation, and the two states everybody forgets
Punk::Observe::Backend
where the configuration lives
Punk::Observe::Backend::Pg
configuration in PostgreSQL
Punk::Observe::Backend::SQLite
the default configuration store
Punk::Observe::Cache
the settled part of a window, computed once
Punk::Observe::Config
reading and writing what the screens are configured with
Punk::Observe::Dashboard
a panel is an OQL string with a title
Punk::Observe::Decode
OTLP protobuf, read as records
Punk::Observe::Evaluate
the alert evaluation pass, and its delivery
Punk::Observe::Exec
planning and running a query
Punk::Observe::Flame
aggregated self-time across traces
Punk::Observe::Health
poll the services being observed
Punk::Observe::Ingest
the OTLP receiver
Punk::Observe::Key
ingest keys
Punk::Observe::Limit
three limits, failing three different ways
Punk::Observe::Live
the log tail, and what it admits losing
Punk::Observe::Log
compressed log blocks and the trigram filter
Punk::Observe::Map
laying out the service graph
Punk::Observe::Metric
compressed metric chunks
Punk::Observe::Plot
query results as chart figures
Punk::Observe::Query
one query language over traces, metrics and logs
Punk::Observe::Retain
compaction, rollups and deletion
Punk::Observe::Route
grouping, silences, and the outbox key
Punk::Observe::SVG
chart primitives
Punk::Observe::Scan
what a query can decide without reading
Punk::Observe::SegIO
one segment carrying all three signals
Punk::Observe::Segment
immutable segments, series ids and the symbol table
Punk::Observe::Store
sealing, and the read path over what is sealed
Punk::Observe::Target
where a webhook is allowed to point
Punk::Observe::Tenant
the tenant seam, kept honest
Punk::Observe::Trace
spans, trace assembly and the service graph
Punk::Observe::View
the screens, and what they are given to render
Punk::Observe::WAL
the write-ahead log
Punk::Observe::Warm
the settled chunks, computed where nobody is waiting
Punk::Plugin::Observe
mount Punk::Observe in a Punk application

Examples

Other files