docs/generated/vocabulary.mdgenerated from code

Reference · 3 min read

attribute

Vocabulary: attribute.

The only attribute keys LVCS spans and metrics may carry. Each value set is bounded: a key whose values are a vocabulary is bounded by that vocabulary's rendered Cardinality line (discussion:owner/44). Never use full paths, peer ids, node ids, frontier ids, or message text as attribute values.

ValueMeaning
subtreeSubtree: one of at most SUBTREE_CAP directory prefixes listed in lvcs.toml [telemetry] subtrees, the longest that contains the path, otherwise other.
actor_kindActor kind: an actor_kind value, Context::KIND.
doc_kindDocument kind: a doc_kind value.
opOperation name: an op value.
outcomeOutcome: an outcome value.
wire_kindWire message kind: a wire_kind value, on spans of the net actors (M3.sync, M3.gossip, M3.coord). A kind outside the set (a newer minor version) is reported as its envelope is ignored, never as an attribute value.
rejectionWhy a wire message, a synced change, or a request was refused: a rejection value, recorded with outcome = rejected (M3.gossip, M3.sync, M3.doc, M3.grants, M3.secrets).
announce_sourceWho made a local notification: a announce_source value, on the announce span only (discussion:owner/165).
step_kindWhat a step runs: a step_kind value, on the action.step span only (discussion:owner/245).
rpc_transportWhich connection a request came on: a rpc_transport value, on the rpc span (discussion:owner/300).
eventThe event a step handled: the variant name of its machine's generated events enum, on the actor span (discussion:owner/435). Bounded by the variants each kind's table declares, a compile-time set of at most a few dozen per kind.
effectThe effect an effect executor ran: the variant name of its machine's output enum, on lvcs.machine.effect (discussion:owner/435). Bounded by the variants each kind's output enum declares.
from_stateThe state a transition left: a state name of its machine's table, on lvcs.machine.transition (discussion:owner/435). Bounded by the states each kind's table declares, at most a few dozen.
to_stateThe state a transition entered, as from_state is bounded.
shell_msgThe kind of message a shell turn handled (discussion:owner/435): a variant name of the shell's message enum, on the shell_turn span and lvcs.shell.turn. Bounded by that enum, a few dozen, and shrinking as the shell is removed (owner/18).
error_codeWhy the daemon refused a request: an error_code value, on a refused rpc or rpc_call span and its error event ( discussion:owner/551). Bounded by the error_code vocabulary.
ruleWhich rule refused a request: a rule value, with error_code = rejected (discussion:owner/551). Bounded by the rule vocabulary.
claim.skippedWhy a runner opened no claim for a run, on the claim span (discussion:owner/648 and session-9468d544/21): a claim_skipped value, bounded by that vocabulary; label values never become attributes.
phaseWhich part of a required path a phase span times ( discussion:owner/785): a phase value, bounded by that vocabulary.
budget_admissionWhy the memory budget admitted an ask past its limit (discussion:owner/762 rule 4a): the budget_admission vocabulary.
plugin_admissionWhat the plugin admitter did with an ask or a serve (discussion:owner/790 item 3): the plugin_admission vocabulary.
rest_causeWhy a document rested: a rest_cause value, on the rester's line for each counted rest (release-qual/21).

Cardinality: 22.