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.StartedCount counts every fiber started.
  • registry.Interrupt id signals one live fiber to stop, and registry.InterruptByName "name" signals every live fiber with that name and returns how many it signalled. Neither waits; whoever joins or awaits the fiber sees Cause.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

NameSignatureSynopsis
Operations
``.ctor``FiberRegistry()Creates a registry that remembers the last 200 settled fibers and unobserved defects.
``.ctor``FiberRegistry(historyCapacity)No description available.
DumpAtthis.DumpAtRenders a snapshot of live fibers as a human-readable parent/child tree, timestamped at now.
Interruptthis.InterruptSignals the live fiber with id to stop, without waiting for it.
InterruptByNamethis.InterruptByNameSignals every live fiber forked with name to stop, without waiting for them.
Settledthis.SettledThe most recently settled fibers, oldest first, up to HistoryCapacity.
Snapshotthis.SnapshotTakes a structured dump of every live fiber, ordered by fiber id.
Statsthis.StatsTotals per fiber name for every fiber that settled since the registry was installed, ordered by name.
UnobservedDefectsthis.UnobservedDefectsThe most recent defects that nobody observed, oldest first, up to HistoryCapacity.
HistoryCapacitythis.HistoryCapacityHow many settled fibers and unobserved defects the registry remembers.
LiveFiberCountthis.LiveFiberCountThe number of live fibers currently tracked.
StartedCountthis.StartedCountHow many fibers have started since the registry was installed.
Observerthis.ObserverThe lifecycle observer that feeds the registry.

Operations

kind:member

``.ctor``

FiberRegistry()
Member
Creates a registry that remembers the last 200 settled fibers and unobserved defects.

Returns

FiberRegistry
kind:member

``.ctor``

FiberRegistry(historyCapacity)
Member

Parameters

NameTypeDescription
historyCapacityint

Returns

FiberRegistry
kind:member

DumpAt

this.DumpAt
Member
Renders a snapshot of live fibers as a human-readable parent/child tree, timestamped at now.

Parameters

NameTypeDescription
clockIClock

Returns

string
kind:member

Interrupt

this.Interrupt
Member
Signals the live fiber with id to stop, without waiting for it.

Parameters

NameTypeDescription
idFiberId

Returns

bool
kind:member

InterruptByName

this.InterruptByName
Member
Signals every live fiber forked with name to stop, without waiting for them.

Parameters

NameTypeDescription
namestring

Returns

int
kind:member

Settled

this.Settled
Member
The most recently settled fibers, oldest first, up to HistoryCapacity.

Returns

SettledFiber list
kind:member

Snapshot

this.Snapshot
Member
Takes a structured dump of every live fiber, ordered by fiber id.

Returns

FiberDump list
kind:member

Stats

this.Stats
Member
Totals per fiber name for every fiber that settled since the registry was installed, ordered by name.

Returns

FiberStats list
kind:member

UnobservedDefects

this.UnobservedDefects
Member
The most recent defects that nobody observed, oldest first, up to HistoryCapacity.

Returns

UnobservedDefect list
kind:member

HistoryCapacity

this.HistoryCapacity
Member
How many settled fibers and unobserved defects the registry remembers.

Returns

int
kind:member

LiveFiberCount

this.LiveFiberCount
Member
The number of live fibers currently tracked.

Returns

int
kind:member

StartedCount

this.StartedCount
Member
How many fibers have started since the registry was installed.

Returns

int64
kind:member

Observer

this.Observer
Member
The lifecycle observer that feeds the registry. Compose it if installing observers manually.

Returns

FiberObserver