docs/generated/vocabulary.mdgenerated from code
Reference · 5 min read
metric
Vocabulary: metric.
Read as
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.
| Value | Meaning |
|---|---|
lvcs.machine.step | A histogram, in milliseconds: how long one step ran in the machine's step slot, under its lock. |
lvcs.machine.queue_depth | An 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_wait | A histogram, in milliseconds: how long a queued event waited for a turn of its scope's cap. |
lvcs.machine.room_wait | A 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.close | A 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_wait | A 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.effect | A histogram, in milliseconds: how long one effect took in its machine's effect executor, with actor_kind and effect (discussion:owner/435). |
lvcs.phase.time | A histogram, in milliseconds: one phase span's self-time (its nested phases' time taken out), with phase ( discussion:owner/785). |
lvcs.machine.transition | A 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.unread | An 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.turn | A histogram, in milliseconds: how long one shell turn took, with shell_msg (discussion:owner/435), until the shell is gone. |
lvcs.journal.write | A 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.batch | A histogram: how many entries one journal write committed, with no attribute (discussion:owner/435). |
lvcs.journal.rotate | A histogram, in milliseconds: how long one journal rotation took, with no attribute (discussion:owner/435). |
lvcs.journal.ack | A 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.sync | A 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.duration | A 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.failed | A 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.usage | An observable gauge, in bytes: the process's resident memory (discussion:owner/435). |
lvcs.process.memory.peak | An observable gauge, in bytes: the process's peak resident memory (discussion:owner/435). |
process.cpu.time | An observable counter, in seconds: the process's CPU time, user and system together (discussion:owner/435). |
process.open_file_descriptor.count | An observable gauge: the process's open file descriptors (discussion:owner/435). |
process.thread.count | An observable gauge: the process's threads (discussion:owner/435). |
lvcs.memory_budget.past_limit | A counter: asks the memory budget admitted past its limit, with budget_admission (discussion:owner/762 rule 4a). |
lvcs.memory_budget.overshoot | A 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.admissions | A counter: what the plugin admitter did, with plugin_admission (discussion:owner/790 item 3). |
lvcs.plugin_admitter.held | A 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_held | A 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.waits | A 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_queued | A 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_bytes | A 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_grants | A 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_failed | A 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_asked | A 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_bare | A 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_loaded | A 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_failed | A 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_failed | A 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.