Metric Families

Find a metric by name, kind, or label, then use its registered fields in your query.

On this page

A Chio metric family is registered once, with its exact name, kind, labels, and help text, and histogram buckets where declared. The workspace registry holds 60 families.

Families are grouped under the Platform section that owns them, by name prefix. Copy the name and labels into your query as written. For the decision on one request, read its receipt; metrics count and time the work across requests.

Kernel

Name	Kind	Labels	Help
`chio_capability_revocation_lag_seconds`	histogram	authority	Capability revocation propagation lag in seconds. Buckets: 1, 5, 15, 30, 60, 120, 300.
`chio_guard_deny_total`	counter	guard_id, reason_class	Total WASM guard denies by reason class.
`chio_guard_eval_duration_seconds`	histogram	guard_id, verdict	WASM guard evaluation duration in seconds. Buckets: 0.0001, 0.0005, 0.001, 0.005, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1.
`chio_guard_evaluations_total`	counter	guard, outcome	Total guard evaluation outcomes across native and WASM guards.
`chio_guard_fuel_consumed_total`	counter	guard_id	Total WASM guard fuel units consumed.
`chio_guard_host_call_duration_seconds`	histogram	guard_id, host_fn	WASM guard host-call duration in seconds. Buckets: 0.00001, 0.00005, 0.0001, 0.0005, 0.001, 0.005, 0.01, 0.05, 0.1.
`chio_guard_module_bytes`	gauge	guard_id, epoch	Loaded WASM guard module size in bytes.
`chio_guard_pool_checkout_total`	counter	guard_id, tenant_id	Total WASM guard pool checkout outcomes by tenant.
`chio_guard_pool_evict_total`	counter	guard_id, tenant_id	Total WASM guard pool evictions by tenant.
`chio_guard_pool_warm_size`	gauge	guard_id, tenant_id	Warm WASM guard pool size by tenant.
`chio_guard_reload_total`	counter	guard_id, outcome	Total WASM guard reload outcomes.
`chio_guard_verdict_total`	counter	guard_id, verdict	Total WASM guard verdicts by guard and verdict.
`chio_kernel_decision_latency_seconds`	histogram	surface, outcome	Kernel mediation decision latency in seconds. Buckets: 0.025, 0.05, 0.075, 0.1, 0.25, 0.5, 1, 2.5.
`chio_receipt_seconds_since_last_checkpoint`	gauge	none	Seconds since the receipt-store checkpoint last advanced while data was pending on the local store.
`chio_receipt_uncheckpointed_seq_range`	gauge	none	Uncheckpointed receipt entry_seq range (end - start) on the local store.
`chio_receipt_write_latency_seconds`	histogram	store, outcome	Receipt write latency at the local store boundary in seconds. Buckets: 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1.
`chio_receipt_write_total`	counter	outcome	Total receipt write outcomes after policy or guard evaluation.

Node

Name	Kind	Labels	Help
`chio_alert_dispatch_latency_seconds`	histogram	route, outcome	PagerDuty or OpsGenie alert dispatch latency in seconds. Buckets: 0.25, 0.5, 1, 2.5, 5, 10.
`chio_alert_dispatch_total`	counter	route, outcome	Total PagerDuty or OpsGenie alert dispatch outcomes.
`chio_ambiguous_dispatch_retained_hold_total`	counter	reconciliation	Total budget or payment holds retained after an ambiguous post-dispatch outcome, labeled by whether durable reconciliation is available.
`chio_dispatch_failure_total`	counter	surface, outcome	Total tool-dispatch failures that did not bypass mediation.
`chio_dlq_depth`	gauge	exporter	Dead-letter queue depth by exporter.
`chio_fail_open_suspected_total`	counter	surface	Total suspected fail-open paths detected by SRE guards.
`chio_finding_market_edge_requests_total`	counter	outcome	Requests the hosted market edge admitted, refused, or shed.
`chio_otel_ingress_drop_total`	counter	none	Total OTEL ingress batches dropped by bounded queue admission.
`chio_otel_sink_drop_total`	counter	none	Total OTEL receipt sink batches dropped before append.
`chio_settlement_unresolved_total`	counter	none	Total settlement observer routing invocations with an unresolved outcome.
`chio_sidecar_requests_total`	counter	outcome	Total sidecar request outcomes at the mediation edge.
`chio_signing_queue_block_total`	counter	reason	Total receipt signing requests blocked by bounded queue capacity or byte budget.
`chio_soc_export_lag_seconds`	histogram	exporter, severity	SOC export lag in seconds from receipt persistence to sink acknowledgement. Buckets: 30, 60, 120, 300, 600, 1800.
`chio_soc_export_total`	counter	exporter, outcome	Total SOC export outcomes for audit rows.

Cluster

Name	Kind	Labels	Help
`chio_trust_control_ready`	gauge	none	Trust-control readiness state, where 1 is ready and 0 is not ready.

Swarm

Name	Kind	Labels	Help
`chio_anchor_round_latency_seconds`	histogram	witness, outcome	Anchor round latency in seconds. Buckets: 0.1, 0.5, 1, 2.5, 5, 10.
`chio_pheromone_queue_overflow_total`	counter	treaty, recipient	Total local pheromone gossip queue overflows.
`chio_pheromone_receiver_deposits_total`	counter	outcome	Total local pheromone receiver deposit admission outcomes.
`chio_pheromone_receiver_latency_seconds`	histogram	outcome	Local pheromone receiver batch verification latency in seconds. Buckets: 0.001, 0.005, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1.
`chio_pheromone_receiver_rejections_total`	counter	reason	Total local pheromone receiver rejections by bounded reason.
`chio_pheromone_relay_catchup_bytes_served_total`	counter	responder, treaty	Total bounded catch-up bytes served by relay.
`chio_pheromone_relay_catchup_denies_total`	counter	reason	Total bounded catch-up requests denied by reason.
`chio_pheromone_relay_dead_letters_total`	counter	reason	Total relay outbox batches moved to dead letter.
`chio_pheromone_relay_delivery_total`	counter	recipient, outcome	Total live pheromone relay delivery outcomes.
`chio_pheromone_relay_endpoint_denied_total`	counter	profile, reason	Total relay endpoints denied by profile lint or delivery policy.
`chio_pheromone_relay_latency_seconds`	histogram	outcome	Live pheromone relay delivery latency in seconds. Buckets: 0.001, 0.005, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1.
`chio_pheromone_relay_nonce_replay_conflicts_total`	counter	peer	Total relay nonce replay conflicts.
`chio_pheromone_relay_oldest_pending_age_seconds`	gauge	none	Oldest pending relay outbox age in seconds.
`chio_pheromone_relay_queue_depth`	gauge	status	Relay outbox depth by bounded status.
`chio_pheromone_relay_rejections_total`	counter	reason	Total live pheromone relay rejections by bounded reason.
`chio_pheromone_relay_stale_directories_total`	counter	profile	Total stale peer-directory bundles or documents rejected.
`chio_pheromone_relay_stale_leases`	gauge	none	Relay scheduler leases past their expiry.

Federation

Name	Kind	Labels	Help
`chio_federation_hop_latency_seconds`	histogram	result	Federation hop latency in seconds. Buckets: 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1.
`chio_federation_hop_total`	counter	result	Total federation hop outcomes.
`chio_federation_transport_accept_duration_seconds`	histogram	lane	Iroh federation-transport per-lane accept handler duration in seconds. Buckets: 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1.
`chio_federation_transport_accept_open`	gauge	lane	Iroh federation-transport in-flight accept handlers by lane (slowloris gauge).
`chio_federation_transport_admission_total`	counter	outcome	Total iroh federation-transport admission-gate outcomes at after_handshake.
`chio_federation_transport_catchup_epoch_gap_total`	counter	source	Total iroh federation-transport revocation catch-up epoch gaps detected.
`chio_federation_transport_directory_reload_total`	counter	outcome	Total iroh federation-transport directory reload outcomes.
`chio_federation_transport_lane_total`	counter	lane, outcome	Total iroh federation-transport per-lane accept outcomes.
`chio_federation_transport_outbox_total`	counter	outcome	Total iroh federation-transport pheromone outbox drain outcomes.
`chio_federation_transport_router_alive`	gauge	none	Iroh federation-transport router liveness (1 alive, 0 the router died).
`chio_federation_transport_verify_failures_total`	counter	seam, reason	Total iroh federation-transport verification failures by seam and bounded reason.

Registry source and grouping

The registry lives in metrics.snapshot, and emitters use its name constants. Every Chio release passes the sre-metrics-registry gate before it is tagged, so a renamed family fails the release before it reaches your dashboards. chio release verify --evidence qualification shows its result for the release you run. The registry carries no section field: each family is filed by its name prefix, and a prefix that matches no section files under Node.

Next: collect and alert on these families

Node ObservabilitySet up the scrape endpoint, collection path, export options, and alerting.Investigate a refused callRead the metric beside the call's receipt.

PreviousComponent Responsibilities NextSpec-to-Crate Index