Skip to main content
A run’s one trace lineage: resolve it, and open the run span that roots it when none exists.
  • resolve_trace_context reads the lineage a run already has: an explicit pair in its config, an explicit parent paired with the ambient deposit’s trace, or the ambient deposit. It never mints one.
  • begin_run_trace keeps that lineage, or opens one run span (a child of the live span, or the root of a new trace) and returns a RunTraceRoot whose step() makes it current and deposits it for one step of the run. A lineage the config names is made current and deposited the same way; one inherited from the ambient deposit stays deposited and is made current by nothing here.
  • open_run_trace holds a run kept in one block inside its lineage.
  • open_lineage_span opens one named span continuing a lineage handed over explicitly.
A span an opener opens records the run’s input (input_, given when it opens) and its output (RunTraceRoot.record_output, given when the run ends), both encoded by the writer as every other recorded payload. A kept lineage opens no span and records neither: the run is a step of a trace whose root carries its own input and output. Every writer member called here is fail-safe, so the openers raise nothing but InvalidRunTraceError for a config they refuse.

​
InvalidRunTraceError

tai42_kit.monitoring.run_trace.InvalidRunTraceError
A run’s config names a trace id or parent span that no monitoring writer can record under. The caller’s input is refused before the run starts, naming the configurable key and the value it carried.

​
RunTraceRoot

tai42_kit.monitoring.run_trace.RunTraceRoot
A run’s lineage and the run span it opened, if any. step() makes the span (with no span, the lineage) current and deposits the lineage for one step of the run; enter and exit it in the same context, never across a yield a consumer drives. record_output() records the run’s output and end() ends the span. Attributes

​
Members

​
step

tai42_kit.monitoring.run_trace.RunTraceRoot.step
The block in which the held span, else the lineage, is current and the lineage deposited. A no-op for a lineage inherited from the ambient deposit: it stays deposited and nothing is made current.

​
record_output

tai42_kit.monitoring.run_trace.RunTraceRoot.record_output
Record output as the held span’s output; a no-op when no span is held or it has ended. Parameters

​
fail

tai42_kit.monitoring.run_trace.RunTraceRoot.fail
Record error on the held span at ERROR. Parameters

​
end

tai42_kit.monitoring.run_trace.RunTraceRoot.end
End the held span; a second call does nothing.

​
begin_run_trace

tai42_kit.monitoring.run_trace.begin_run_trace
Begin a run’s one lineage without making anything current. A lineage the config or the ambient deposit already names is kept: one the config names is current and deposited only inside RunTraceRoot.step, one inherited from the ambient deposit is left as it is. Otherwise one run span opens with input_ as its input, a child of the live span or, with none live, the root of a new trace, and is current only inside RunTraceRoot.step. context is None when nothing records. Parameters

​
open_lineage_span

tai42_kit.monitoring.run_trace.open_lineage_span
Open one span named name with input_ as a child of parent, current and deposited for the block. The block records its output on the yielded root; the span ends on exit. Parameters

​
open_run_trace

tai42_kit.monitoring.run_trace.open_run_trace
Give a run held in one block its one lineage: the root of begin_run_trace, current and deposited. The block records the run’s output on the yielded root; a raise is recorded on it before it ends. Never hold it across a yield a consumer drives; an async generator uses begin_run_trace and binds step() per step. Parameters

​
resolve_trace_context

tai42_kit.monitoring.run_trace.resolve_trace_context
The lineage a run already has, from config and the ambient deposit; None when it has none. An explicit configurable[MONITORING_TRACE_ID_KEY] needs configurable[MONITORING_PARENT_SPAN_ID_KEY] beside it. An explicit parent alone pairs with the ambient deposit’s trace. Else the ambient deposit. Pure. A trace id that is not 32 lower-hex (not all zeros), a parent that is not 16 lower-hex (not all zeros), a trace without a parent, or a parent with no trace to pair with is refused with InvalidRunTraceError. An empty explicit trace id reads as absent. Parameters