metrics guide

prometheus exporter for the crosslink feature net. scrape /metrics into your stack. all gauges prefixed ctaz_.

scrape config

scrape_configs:
  - job_name: ctaz-crosslink
    scrape_interval: 30s
    metrics_path: /metrics
    scheme: https
    static_configs:
      - targets: ['ctaz.zat-explorer.cash']

available metrics

name	type	what it measures
`ctaz_pow_tip`	gauge	latest pow block height seen
`ctaz_pow_finalized`	gauge	latest bft-finalized pow block height
`ctaz_pow_finality_gap_blocks`	gauge	pow blocks between finalized tip and pow tip
`ctaz_peers`	gauge	number of p2p peers connected
`ctaz_bft_latest_signers`	gauge	signer count on the most recent observed bft cert
`ctaz_bft_median_signers`	gauge	median signer count over the recent window
`ctaz_bft_min_signers`	gauge	min signer count in window
`ctaz_bft_max_signers`	gauge	max signer count in window
`ctaz_bft_latest_degraded`	gauge	1 when latest cert is below degraded threshold
`ctaz_bft_latest_pos_height`	gauge	pos height of the latest observed cert
`ctaz_reorgs_observed_total`	counter	reorgs observed since tracker start
`ctaz_finalizers_active`	gauge	size of the active finalizer roster
`ctaz_finalizers_silent`	gauge	finalizers absent from the last 50 plus observed certs
`ctaz_stake_total_zats`	gauge	sum of voting power across roster in zatoshis
`ctaz_staking_cycle_pos`	gauge	position inside the 150-block staking cycle
`ctaz_staking_window_live`	gauge	1 if the staking window is currently open
`ctaz_staking_blocks_remaining`	gauge	pow blocks left in the current staking window
`ctaz_staking_next_window_in`	gauge	pow blocks until the next window opens
`ctaz_tracker_certs_observed`	gauge	distinct bft certs the tracker has seen
`ctaz_tracker_pos_events`	gauge	pos finalization events recorded
`ctaz_tracker_heights_tracked`	gauge	pow heights the reorg detector is tracking

grafana dashboard

download ctaz-crosslink-grafana.json and import into your grafana. pre-configured panels for pow tip, finalized height, finality gap, peers, bft signer trends, finalizer drop-off, reorgs, staking cycle, and total stake. refreshes every 30s, 1-hour default window.

import path in grafana: Dashboards, New, Import, Upload dashboard JSON file.

alerting suggestions

useful prometheus alert rules:

- alert: CtazBftDegraded
  expr: ctaz_bft_latest_degraded == 1
  for: 2m
  labels: {severity: warning}

- alert: CtazFinalityGapHigh
  expr: ctaz_pow_finality_gap_blocks > 50
  for: 5m
  labels: {severity: warning}

- alert: CtazPeersLow
  expr: ctaz_peers < 5
  for: 5m
  labels: {severity: warning}

- alert: CtazSilentFinalizers
  expr: ctaz_finalizers_silent >= 3
  for: 10m
  labels: {severity: info}

if you want to anchor metrics with zap1 attestations on zcash mainnet, protocol docs at api.frontiercompute.cash/docs. full developer hub at /devs. related: /chain-health for human-readable view of the same signals, /api/chain-health for json, /guide/staking for the operator reference.