FiberRegistryType
PackageAxial
FiberRegistry
A FiberRegistry (core Axial, no telemetry dependency) tracks every live fiber below one edge install and answers
"what is my runtime doing right now?" Install it with Flow.withFiberRegistry; registry.DumpAt(clock) renders the
tree and registry.Snapshot() returns structured FiberDump values.
Method inventory
registry.Settled()returns the most recently settled fibers, oldest first. Each carries its final metadata (status, start and settle times,Duration) and, for a failed fiber, its cause rendered as text, for typed errors as well as defects.registry.Stats()returns totals per fiber name since the registry was installed: how many ran, failed, and were interrupted, with total and longest duration. Unnamed fibers are counted under(unnamed).registry.UnobservedDefects()returns defects that nobody joined or awaited.registry.StartedCountcounts every fiber started.registry.Interrupt idsignals one live fiber to stop, andregistry.InterruptByName "name"signals every live fiber with that name and returns how many it signalled. Neither waits; whoever joins or awaits the fiber seesCause.Interrupt.
History is bounded: FiberRegistry() keeps the last 200 settled fibers and unobserved defects, and
FiberRegistry(capacity) sets another bound. Totals are kept for every name. Install the registry with
Flow.withFiberRegistry to get typed failure text; an observer composed by hand sees defects only.
Read the observability guide for the operational interpretation and Supervision and fiber observability for unobserved-defect semantics.
Specification
Kind
Type
Members
13
Examples
0
``.ctor``Signature
FiberRegistry()
``.ctor``Signature
FiberRegistry(historyCapacity)
DumpAtSignature
this.DumpAt
InterruptSignature
this.Interrupt
InterruptByNameSignature
this.InterruptByName
Summary
| Name | Signature | Synopsis |
|---|---|---|
| Operations | ||
| ``.ctor`` | FiberRegistry() | Creates a registry that remembers the last 200 settled fibers and unobserved defects. |
| ``.ctor`` | FiberRegistry(historyCapacity) | No description available. |
| DumpAt | this.DumpAt | Renders a snapshot of live fibers as a human-readable parent/child tree, timestamped at now. |
| Interrupt | this.Interrupt | Signals the live fiber with id to stop, without waiting for it. |
| InterruptByName | this.InterruptByName | Signals every live fiber forked with name to stop, without waiting for them. |
| Settled | this.Settled | The most recently settled fibers, oldest first, up to HistoryCapacity. |
| Snapshot | this.Snapshot | Takes a structured dump of every live fiber, ordered by fiber id. |
| Stats | this.Stats | Totals per fiber name for every fiber that settled since the registry was installed, ordered by name. |
| UnobservedDefects | this.UnobservedDefects | The most recent defects that nobody observed, oldest first, up to HistoryCapacity. |
| LiveFiberCount | this.LiveFiberCount | The number of live fibers currently tracked. |
| HistoryCapacity | this.HistoryCapacity | How many settled fibers and unobserved defects the registry remembers. |
| Observer | this.Observer | The lifecycle observer that feeds the registry. |
| StartedCount | this.StartedCount | How many fibers have started since the registry was installed. |

