period string (rendered in the page subtitle as
Metered transport · {period}), the four meter-strip counters, the land
and block statistics, a short land series for the chart, and a recent
error list.
What billing.usage returns
The meter strip: tx_sent, tx_bytes, fanout, landed
The four cards across the top are raw counters for the meteringperiod.
They are cumulative for that period, not windowed like the chart below them.
tx_sent— sub-labelledingested → fan-out. This counts transactions the BDN accepted from your submit path and handed to fan-out. It is the denominator you reach for first when a downstream number looks low: iftx_sentis flat, nothing reached the network and the problem is on the submit side, not the relay side.tx_bytes— sub-labelledraw tx volume. Payload bytes for those transactions. Compare againsttx_sentto get an average transaction size; a sudden jump in bytes without a jump in count means larger payloads, which is what drives block compression and short-id behaviour further down the page.fanout— thebdn.tx_fanoutcounter. This is the propagation multiplier: how many peer deliveries the BDN performed for the transactions it ingested.fanoutnear zero whiletx_sentclimbs means the node ingested traffic but did not propagate it.landed— transactions that landed, withlandFailprinted underneath asN failed. These two are the numerator and the failure count behind the land success percentage.
Land success and land failures
landSuccessPct is reported by the procedure as its own field rather than being
computed in the browser, and it is nullable. When it is null the console prints
an em dash — that is the “nothing to measure yet” state, not zero percent. A
freshly provisioned tenant that has submitted nothing shows — here while
landed and landFail both sit at zero.
Read landSuccessPct together with the landFail count on the meter card and
with the error feed at the bottom of the page. A falling success percentage
tells you the ratio moved; the error feed tells you which cluster and which
error moved it.
Land latency: what is timed and where percentiles come from
Two percentiles are exposed,landP50 and landP95, both in milliseconds and
both rendered directly from the fields — the console does no bucketing of its
own. landP95 is tinted with the warning colour on the screen so that tail
latency is visually separable from the median at a glance.
Use them as a pair:
- p50 and p95 close together means a uniform path — the transport is behaving consistently for every submission.
- p50 stable while p95 climbs means a tail problem. A subset of submissions is
taking a slower route or retrying; the aggregate count in
landedwill not show it, which is exactly why the percentile split exists on this screen. - both climbing together points at the whole path, not a subset.
Lands over the recent window
The bar chart is titled Lands · recent window and is subtitledper stats tick (~2s). Each bar in landedSeries is one stats tick, and the
chart’s axis labels run −2m on the left to now on the right — so the chart
covers roughly the last two minutes of land activity, independent of the
period that scopes the meter cards above it.
The card’s right-hand corner shows {landed} total, which is the period
counter, not the sum of the bars. Do not expect the bars to add up to it.
When landedSeries is empty the chart is replaced by an empty state:
“No throughput yet — Submit a transaction to see live land throughput.”
That is the normal state before your first submission.
Block publication: compression, short-id table, get-txs recovery
The lower four stat rows describe the block side of the BDN rather than the transaction side.compressionPct— how much smaller published blocks are than their uncompressed form. Compression on the BDN comes from replacing transactions the peer already holds with short ids, so this number is a direct consequence of how well the short-id table is populated.shortIdTable— the current size of the short-id table. This is the working set of transactions that can be referenced by id instead of shipped in full. A small table and a lowcompressionPctusually move together.blocks— blocks published over the period. This is the denominator for reasoning about the compression and get-txs numbers; a compression percentage computed over a handful of blocks is not yet meaningful.getTxHitPct— the hit rate when resolving short ids in a received block. A hit means the referenced transaction was already held locally and no round trip was needed.gettxRecovered/rxMissing— rendered together as{gettxRecovered} / {rxMissing} miss.rxMissingcounts short ids that missed the local table;gettxRecoveredcounts how many of those were then recovered with an explicit get-txs request. The gap between the two is the set of misses that were not recovered.
shortIdTable drives getTxHitPct down,
which drives rxMissing up, which drives get-txs round trips, which is the work
that compressionPct was meant to avoid.
Reading the error feed
The bottom card, Recent errors, is subtitledland / submit failures across nodes. It is an observability feed, not a billing artifact. Each row has three
columns:
Because the message column is truncated in the console, treat it as a
classifier — enough to tell whether failures are all the same error or a mix —
and go to your logs for the full text.
The
Cluster column is what makes this feed actionable: failures concentrated
on one cluster point at that cluster’s connectivity or peering, while failures
spread evenly across clusters point at the submitted transactions themselves.
When errors is empty the card shows “No recent errors — Land + submit paths
healthy.”
Aggregation window and stats tick
There are three distinct time bases on this one screen, and mixing them up is the most common misreading:
The stats tick is also the practical refresh granularity for anything derived
from live BDN metrics: a change you make to your submit path will not appear in
the chart faster than the next tick, and a single tick of data is not enough to
move a percentile.
Related
- Telemetry — metric, trace, and record streams emitted platform-wide
- Telephony Metrics — how percentile and success-ratio metrics are read elsewhere in the platform