Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Metrics reference

audience: operators

Complete per-organism metrics catalogue. Every metric is emitted via mosaik’s Prometheus exporter with the following common labels:

  • lattice — LATTICE_INSTANCE value.
  • chain_id — LATTICE_CHAIN_ID.
  • organism — one of zipnet | unseal | offer | atelier | relay | tally.
  • role — the organism-specific role (e.g. server, member).
  • member — per-member id, on metrics emitted by a specific committee member.

Status. Names are the proposed convention; organism crates pin them when they ship. The cross-organism labelling scheme is load-bearing and will not change.

Lattice-wide

MetricTypeDescription
lattice_idgauge1; label lattice_id_hex carries the fingerprint. Used as a sanity check that a host is in the intended lattice.
lattice_upgauge1 when the process is up.
discovery_peers_totalgaugeTotal peers in the discovery catalogue, from mosaik.

zipnet

Inherits the zipnet metrics reference. Key metrics to cross-reference at the lattice level:

  • zipnet_server_up{member=...}
  • zipnet_aggregator_up
  • zipnet_round_commit_latency_seconds
  • zipnet_broadcasts_appended_total
  • zipnet_client_submissions_total

unseal

MetricTypeDescription
unseal_member_upgauge1 when the unseal member is up.
unseal_member_tdx_attestedgauge1 when the member’s TDX quote is valid.
unseal_committee_sizegaugeBonded committee member count, from this member’s view.
unseal_shares_submitted_totalcounterRate of threshold-share submissions.
unseal_decrypt_latency_secondshistogramTime from zipnet::Broadcasts append to UnsealedPool commit.
unseal_pool_committed_totalcounterRate of UnsealedPool commits.
unseal_upstream_peers{source=...}gaugeBonded peers on upstream subscriptions.

offer

MetricTypeDescription
offer_member_upgauge1 when the offer member is up.
offer_committee_sizegaugeBonded committee size.
offer_bids_received_totalcounterRate of sealed bids accepted.
offer_bids_rejected_total{reason=...}counterBids rejected (bad size, wrong slot, bad ACL).
offer_auction_commit_latency_secondshistogramTime from slot open to auction-commit.
offer_winner_bid_weihistogramDistribution of winning bid amounts.
offer_upstream_peers{source=...}gaugeBonded peers on upstream subscriptions.

atelier

MetricTypeDescription
atelier_member_upgauge1 when the atelier member is up.
atelier_member_tdx_attestedgauge1 when the member’s TDX quote is valid.
atelier_committee_sizegaugeBonded committee size.
atelier_candidates_committed_totalcounterRate of Candidates commits.
atelier_candidate_build_latency_secondshistogramPer-slot build latency.
atelier_simulation_divergence_totalcounterCommittee simulation disagreements.
atelier_simulation_input_hashgaugeLabel-only: per-slot simulation input hash.
atelier_upstream_peers{source=...}gaugeBonded peers on upstream subscriptions.

relay

MetricTypeDescription
relay_member_upgauge1 when the relay member is up.
relay_committee_sizegaugeBonded committee size.
relay_headers_sent_total{proposer=...}counterRate of headers shipped to each proposer.
relay_proposer_ack_latency_secondshistogramRound-trip to proposer.
relay_accepted_headers_committed_totalcounterRate of AcceptedHeaders commits.
relay_committee_agreement_rategaugeFraction of slots the committee agreed on ack.
relay_on_chain_mismatches_totalcounterIncremented by downstream tally when an ack did not land on chain.
relay_upstream_peers{source=...}gaugeBonded peers on upstream subscriptions.

tally

MetricTypeDescription
tally_member_upgauge1 when the tally member is up.
tally_committee_sizegaugeBonded committee size.
tally_blocks_attributed_totalcounterRate of Refunds commits.
tally_attestation_latency_secondshistogramTime from on-chain inclusion to Attestations commit.
tally_evidence_failures_totalcounterAttribution attempts that failed upstream-evidence join.
tally_chain_rpc_lag_secondsgaugeLag between chain head and this member’s RPC feed.
tally_refund_amount_weihistogramDistribution of per-recipient refund amounts.
tally_upstream_peers{source=...}gaugeBonded peers on upstream subscriptions.

Cross-references