docs/generated/vocabulary.mdgenerated from code

Reference · 5 min read

metric

Vocabulary: metric.

The metrics LVCS records (discussion:owner/403 and discussion:owner/435): a machine's scheduler's carry only actor_kind, the process gauges none, and each other's attributes are named on it.

ValueMeaning
lvcs.machine.stepA histogram, in milliseconds: how long one step ran in the machine's step slot, under its lock.
lvcs.machine.queue_depthAn up-down counter: the events queued for the machines of one kind and not yet run, summed over that kind's machines (one added when an event is queued, taken when its step starts).
lvcs.machine.turn_waitA histogram, in milliseconds: how long a queued event waited for a turn of its scope's cap.
lvcs.machine.room_waitA histogram, in milliseconds: how long a step for the blocking pool (a document's) waited, after its turn, for room there under the daemon's bound, with actor_kind.
lvcs.machine.closeA histogram, in milliseconds: how long a step's close took once the machine ran it: journaling it and handing its outputs to the machine's effect executor (discussion:owner/435).
lvcs.machine.close_waitA histogram, in milliseconds: how long a step's close waited, from its step to its turn in the machine's closer, behind the closes of the machine's earlier steps (their journal acks and their outputs), with actor_kind (discussion:owner/439): what a burst through one machine queues, never the journal's own cost.
lvcs.machine.effectA histogram, in milliseconds: how long one effect took in its machine's effect executor, with actor_kind and effect (discussion:owner/435).
lvcs.phase.timeA histogram, in milliseconds: one phase span's self-time (its nested phases' time taken out), with phase ( discussion:owner/785).
lvcs.machine.transitionA counter: the state transitions of the machines of one kind, with actor_kind, from_state, and to_state, taken from each step's trace, so a tree's file members' (discussion:owner/433) count under tree_file: how many paths went Dirty to Saving, or Saving to Stale (discussion:owner/435).
lvcs.watcher.unreadAn up-down counter: the file watcher events the daemon has not read yet, status's unread_changes, with no attribute (discussion:owner/435).
lvcs.shell.turnA histogram, in milliseconds: how long one shell turn took, with shell_msg (discussion:owner/435), until the shell is gone.
lvcs.journal.writeA histogram, in milliseconds: how long one journal write took, one group commit of any number of entries, with no attribute (discussion:owner/435).
lvcs.journal.batchA histogram: how many entries one journal write committed, with no attribute (discussion:owner/435).
lvcs.journal.rotateA histogram, in milliseconds: how long one journal rotation took, with no attribute (discussion:owner/435).
lvcs.journal.ackA histogram, in milliseconds: how long one step's close waited for its journal entry's ack once its turn in the machine's closer came, with actor_kind (discussion:owner/435): the part of lvcs.machine.close the journal costs.
lvcs.journal.syncA histogram, in milliseconds: how long one background sync of the journal took, a plain fsync at most JOURNAL_SYNC_MS after the first unsynced write (discussion:owner/455).
lvcs.rpc.durationA histogram, in milliseconds: how long one JSON-RPC request took from its arrival to its reply, with op, outcome, and rpc_transport (discussion:owner/435).
lvcs.rpc.failedA counter: requests that failed or were refused, counted by the process that made them (a plugin's rpc_call) and by the daemon that answered them (its rpc), with op, outcome, and, when the daemon refused, error_code and rule (discussion:owner/551).
process.memory.usageAn observable gauge, in bytes: the process's resident memory (discussion:owner/435).
lvcs.process.memory.peakAn observable gauge, in bytes: the process's peak resident memory (discussion:owner/435).
process.cpu.timeAn observable counter, in seconds: the process's CPU time, user and system together (discussion:owner/435).
process.open_file_descriptor.countAn observable gauge: the process's open file descriptors (discussion:owner/435).
process.thread.countAn observable gauge: the process's threads (discussion:owner/435).
lvcs.memory_budget.past_limitA counter: asks the memory budget admitted past its limit, with budget_admission (discussion:owner/762 rule 4a).
lvcs.memory_budget.overshootA gauge, in bytes: how far past its limit the memory budget's charge stood after its latest admission past the limit: at most the limit itself, or the whole charge of a held ask that ran alone (discussion:owner/762 rule 4a).
lvcs.plugin_admitter.admissionsA counter: what the plugin admitter did, with plugin_admission (discussion:owner/790 item 3).
lvcs.plugin_admitter.heldA gauge, in bytes: what the plugin admitter holds against the plugins' share after its step (discussion:owner/790 item 3). No attributes.
lvcs.durable.answers_heldA gauge: the answers a project's durability executor holds, each waiting for its changes to be written and signed, set once per batch (discussion:owner/784). No attributes.
lvcs.durable.waitsA gauge: the change waits those held answers have, set once per batch; a change counts once per answer waiting on it, so a chain counts more than its changes (discussion:owner/784). No attributes.
lvcs.rester.load_queuedA counter: document loads the daemon's rester queued, each waiting for a rest to make room under the loaded-bytes budget (daemon-memory/7). No attributes.
lvcs.rester.overdraw_bytesA gauge: the stored bytes the daemon's rester holds loaded past the loaded-bytes budget, in its LOADS_IN_FLIGHT_MIN places and, while every loaded document is barred for thrash, up to LOADED_ROOM_BYTES (owner/776, option C), told at each sample while non-zero and once when it returns to 0. No attributes.
lvcs.granter.unrendered_grantsA counter: documents that opened on the grants the Granter held before the caps document's first render, because it held as many waiting asks as it can (GRANTER_ASKS_HELD_MAX): each may lift a stored refusal once, to be judged again (discussion:owner/787). No attributes.
lvcs.ledger.answer_read_failedA counter: sync answers whose stored changes the document's executor couldn't read from the ledger file, each sent no further and answered again (discussion:owner/792 step 3). No attributes.
lvcs.sync.resend_askedA counter: sync answers that asked a node to send again because it holds changes the document lacks and sent none, at most once per unchanged pair of the two sides' haves (discussion:owner/799). No attributes.
lvcs.sync.answered_bareA counter: sync rounds (a join, a have the document lacks nothing against, a resend of changes it holds) a rested document answered from its stored ledger without loading (channel-judge/5). No attributes.
lvcs.sync.bare_loadedA counter: sync rounds to a rested document its stored ledger couldn't answer, or whose document started meanwhile, so it loaded for them (channel-judge/5). No attributes.
lvcs.ledger.rejudge_read_failedA counter: re-check reads whose held changes the document's executor couldn't read from the ledger file, each judging nothing until the next report (discussion:owner/792 step 4). No attributes.
lvcs.ledger.evidence_read_failedA counter: equivocations whose held change the document's executor couldn't read from the ledger file, each pair pending until the next step that sends evidence, or dropped when its record moved (discussion:owner/792 step 5). No attributes.

Cardinality: 38.