Skip to content

Metrics reference

This catalog is generated from the Gateway metric manifest and contains only families marked release. It proves the name, type, label schema, activation class, mapped writer, and upstream evidence classification at the frozen source revision. It does not prove that every family is present in a particular deployment: feature activation, traffic, build tags, hardware, and runtime configuration still determine whether a series is emitted.

  • Gateway source commit: 142e731e7568d30bf468065addd8b4929065e381
  • Gateway main eBPF submodule commit: 462a1e5412f46ca53574b9c079005bb3da3cfa20
  • Comparison release: v0.9.8.9-rc.1 at f08b18beda587217265c9ba6419159119914795c
  • Comparison release eBPF submodule commit: 5536a2117ad2ad1128900a0d808ad7dec2eee2b5
  • Release manifest availability: absent
  • Manifest path: deploy/monitoring/manifest/metric-manifest.json
  • Manifest SHA-256: 614ad0f5690736bfdfe26df8c3fb174d6a1189c89230ebdefd15355d4189bb10
  • Embedded manifest source revision: 593f1d37d9e3b6ecc0f6764d46cff45cf7ae2834
  • Embedded manifest generation time: 2026-09-22T12:08:49+00:00
  • Manifest schema version: 1
  • Release-scope families: 197
  • Raw writer paths and evidence prose are intentionally not copied into this public catalog.

The table below is therefore a current-main source catalog, not a claim that v0.9.8.9-rc.1 ships every listed family. The comparison release does not contain the generated metric manifest used by this page. Release packaging and runtime emission require separate qualification.

How to read evidence

Status Meaning
verified-runtime (48) writer plus recorded runtime evidence in the upstream manifest
verified-static (16) writer verified by static or unit evidence; no runtime claim
conditional-with-proven-writer (69) writer exists but the family appears only when its feature path is active
writer-mapped (64) writer source is mapped; runtime emission was not verified

A writer or registration point is source evidence, not deployment evidence. verified-runtime records upstream runtime evidence for that family, but this documentation build does not rerun Linux, GPU, DPU, HA, or release tests. The verification status page keeps those evidence lanes separate.

Activation codes

Combined codes such as D+V require both conditions.

Code Activation condition
E eager scalar
V lazy vector children
P pre-created children
C QoS custom collector; sample-lazy
H eager TTFB histogram
Q quota-lazy collector
DP datapath-gated scalar
D runtime DPU-gated
BD DOCA build-gated
T TTFT-window-lazy
S startup-created child

Release-scope families

Family Type Labels Activation Runtime scope Evidence status
loxilb_active_conntrack_entries gauge none E gateway-default writer-mapped
loxilb_active_flow_count_sctp gauge none E gateway-default writer-mapped
loxilb_active_flow_count_tcp gauge none E gateway-default writer-mapped
loxilb_active_flow_count_udp gauge none E gateway-default writer-mapped
loxilb_ai_active_streams gauge model V gateway-default conditional-with-proven-writer
loxilb_ai_engine_info gauge service, engine V gateway-default conditional-with-proven-writer
loxilb_ai_jwks_keys gauge profile E gateway-default conditional-with-proven-writer
loxilb_ai_jwks_last_success_timestamp_seconds gauge profile E gateway-default conditional-with-proven-writer
loxilb_ai_jwks_refresh_total counter profile, outcome E gateway-default conditional-with-proven-writer
loxilb_ai_jwks_usable gauge profile E gateway-default conditional-with-proven-writer
loxilb_ai_jwt_validation_total counter tenant, reason E gateway-default conditional-with-proven-writer
loxilb_ai_key_token_quota_limit_tokens gauge key_id Q gateway-default verified-runtime
loxilb_ai_key_token_quota_utilization gauge key_id Q gateway-default verified-runtime
loxilb_ai_keyed_services gauge none E gateway-default writer-mapped
loxilb_ai_kv_attest_echo_total counter result V gateway-default conditional-with-proven-writer
loxilb_ai_kv_attest_probe_fail_total counter reason V gateway-default conditional-with-proven-writer
loxilb_ai_kv_attest_state gauge rule, state V gateway-default conditional-with-proven-writer
loxilb_ai_kv_enforcement_fault gauge rule V gateway-default conditional-with-proven-writer
loxilb_ai_kv_trtllm_drain_ownership_fault_total counter reason V gateway-default conditional-with-proven-writer
loxilb_ai_kv_trtllm_drain_ownership_heal_total counter none E gateway-default conditional-with-proven-writer
loxilb_ai_llamacpp_probe_warnings_total counter service, kind V gateway-default conditional-with-proven-writer
loxilb_ai_model_not_allowed_total counter model, tenant V gateway-default verified-runtime
loxilb_ai_normal_session_hits_total counter model V gateway-default verified-runtime
loxilb_ai_pd_decode_ttft_seconds histogram model V gateway-default conditional-with-proven-writer
loxilb_ai_pd_kv_params_found_total counter model V gateway-default conditional-with-proven-writer
loxilb_ai_pd_kv_params_missing_total counter model V gateway-default conditional-with-proven-writer
loxilb_ai_pd_prefill_duration_seconds histogram model V gateway-default conditional-with-proven-writer
loxilb_ai_pd_requests_total counter model, phase, status V gateway-default conditional-with-proven-writer
loxilb_ai_pd_session_hits_total counter model V gateway-default verified-runtime
loxilb_ai_pd_tier_selected_total counter tier, model V gateway-default verified-runtime
loxilb_ai_policy_store_unavailable_total counter none E gateway-default conditional-with-proven-writer
loxilb_ai_rate_limit_hits_total counter tenant, reason V gateway-default verified-runtime
loxilb_ai_request_duration_seconds histogram model, tenant V gateway-default conditional-with-proven-writer
loxilb_ai_requests_total counter model, tenant, status, outcome V gateway-default conditional-with-proven-writer
loxilb_ai_token_quota_cold_open_total counter none E gateway-default verified-runtime
loxilb_ai_token_quota_denied_total counter tenant V gateway-default verified-runtime
loxilb_ai_token_quota_limit_tokens gauge tenant Q gateway-default verified-runtime
loxilb_ai_token_quota_model_limit_tokens gauge tenant, model Q gateway-default verified-runtime
loxilb_ai_token_quota_model_utilization gauge tenant, model Q gateway-default verified-runtime
loxilb_ai_token_quota_utilization gauge tenant Q gateway-default verified-runtime
loxilb_ai_tokens_consumed_total counter model, tenant, kind V gateway-default verified-runtime
loxilb_ai_tokens_estimated_total counter model, tenant V gateway-default conditional-with-proven-writer
loxilb_ai_tokens_missing_total counter model, tenant, reason V gateway-default verified-runtime
loxilb_ai_unmetered_requests_total counter vip V gateway-default conditional-with-proven-writer
loxilb_ai_user_model_token_quota_limit_tokens gauge tenant, user, model Q gateway-default verified-static
loxilb_ai_user_model_token_quota_utilization gauge tenant, user, model Q gateway-default verified-static
loxilb_ai_user_token_quota_limit_tokens gauge tenant, user Q gateway-default verified-static
loxilb_ai_user_token_quota_utilization gauge tenant, user Q gateway-default verified-static
loxilb_ai_vip_token_quota_limit_tokens gauge service Q gateway-default verified-runtime
loxilb_ai_vip_token_quota_utilization gauge service Q gateway-default verified-runtime
loxilb_ai_worker_scrape_total counter result P gateway-default verified-runtime
loxilb_autopersist_consecutive_failures gauge none E gateway-default writer-mapped
loxilb_backend_traffic_bytes_total counter service, endpoint P gateway-default verified-static
loxilb_backend_traffic_connections_total counter service, endpoint V gateway-default writer-mapped
loxilb_backend_traffic_packets_total counter service, endpoint P gateway-default verified-static
loxilb_boot_config_conflict_total counter none E gateway-default writer-mapped
loxilb_boot_legacy_fallback_total counter none E gateway-default writer-mapped
loxilb_client_traffic_packets_total counter service, sip V gateway-default conditional-with-proven-writer
loxilb_closed_connections_processed_total counter none E gateway-default writer-mapped
loxilb_config_dirty gauge none E gateway-default writer-mapped
loxilb_conntrack_max_entries gauge none DP gateway-default conditional-with-proven-writer
loxilb_conntrack_stat_resets_total counter none E gateway-default writer-mapped
loxilb_endpoint_traffic_bytes_total counter service, dip V gateway-default conditional-with-proven-writer
loxilb_errors_total counter none E gateway-default writer-mapped
loxilb_firewall_rules gauge none E gateway-default writer-mapped
loxilb_fw_drop_packets_total counter none E gateway-default writer-mapped
loxilb_fw_rule_drop_packets_total counter fw_rule V gateway-default conditional-with-proven-writer
loxilb_healthy_endpoints gauge none E gateway-default writer-mapped
loxilb_host_cpu_utilization_percent gauge none E gateway-default writer-mapped
loxilb_ipfilter_blacklist_bytes_total counter cidr, priority, zone V gateway-default conditional-with-proven-writer
loxilb_ipfilter_blacklist_packets_total counter cidr, priority, zone V gateway-default conditional-with-proven-writer
loxilb_ipfilter_rules gauge type V gateway-default conditional-with-proven-writer
loxilb_ipfilter_whitelist_bytes_total counter cidr, priority, zone V gateway-default conditional-with-proven-writer
loxilb_ipfilter_whitelist_packets_total counter cidr, priority, zone V gateway-default conditional-with-proven-writer
loxilb_kv_inv_cap_evictions_total counter service, ep V gateway-default conditional-with-proven-writer
loxilb_kv_inventory_fresh gauge service, ep V gateway-default conditional-with-proven-writer
loxilb_kv_subscriber_connected gauge service, ep V gateway-default conditional-with-proven-writer
loxilb_kv_subscriber_last_event_timestamp_seconds gauge service, ep V gateway-default conditional-with-proven-writer
loxilb_kv_subscriber_reconnect_total counter service, ep V gateway-default conditional-with-proven-writer
loxilb_kv_subscriber_recv_error_total counter service, ep V gateway-default conditional-with-proven-writer
loxilb_kv_subscriber_wire_reject_total counter service, ep, reason V gateway-default conditional-with-proven-writer
loxilb_l4_error_events_total counter proto, reason V gateway-default writer-mapped
loxilb_last_restore_timestamp_seconds gauge none E gateway-default verified-static
loxilb_lb_rule_interaction_bytes_total counter service, sip, dip V gateway-default conditional-with-proven-writer
loxilb_lb_rule_interaction_packets_total counter service, sip, dip V gateway-default conditional-with-proven-writer
loxilb_lb_rules gauge none E gateway-default writer-mapped
loxilb_lb_select_failure_shutdown_total counter none E gateway-default writer-mapped
loxilb_new_flows gauge none E gateway-default writer-mapped
loxilb_opa_circuit_breaker_state gauge none E gateway-default conditional-with-proven-writer
loxilb_opa_firewall_rules gauge none E gateway-default conditional-with-proven-writer
loxilb_opa_sync_duration_seconds histogram none E gateway-default conditional-with-proven-writer
loxilb_opa_watcher_syncs_total counter status V gateway-default conditional-with-proven-writer
loxilb_parser_attributes_extracted_total counter protocol V gateway-default conditional-with-proven-writer
loxilb_parser_body_size_bytes histogram protocol V gateway-default conditional-with-proven-writer
loxilb_parser_calls_total counter protocol, status V gateway-default conditional-with-proven-writer
loxilb_parser_duration_seconds histogram protocol V gateway-default conditional-with-proven-writer
loxilb_pd_admission_overflow_shed_total counter none E gateway-default verified-runtime
loxilb_pd_admission_queued_total counter none E gateway-default verified-runtime
loxilb_pd_admission_shed_total counter none E gateway-default verified-runtime
loxilb_pd_cb_flips_total counter none E gateway-default verified-runtime
loxilb_pd_cb_proactive_heal_total counter none E gateway-default verified-runtime
loxilb_pd_connect_failover_total counter none E gateway-default verified-runtime
loxilb_pd_connect_retry_same_ep_ok_total counter none E gateway-default verified-runtime
loxilb_pd_connect_retry_same_ep_total counter none E gateway-default verified-runtime
loxilb_pd_decode_ep_died_total counter none E gateway-default verified-runtime
loxilb_pd_decode_zero_byte_eof_total counter none E gateway-default verified-runtime
loxilb_pd_ep_info gauge service, ep_idx, ep V gateway-default conditional-with-proven-writer
loxilb_pd_fallback_to_normal_total counter none E gateway-default writer-mapped
loxilb_pd_kv_blocks gauge service, ep_idx V gateway-default conditional-with-proven-writer
loxilb_pd_kv_tier15_cold_seeds_total counter ep_idx V gateway-default conditional-with-proven-writer
loxilb_pd_kv_tier15_fallthrough_total counter none E gateway-default verified-runtime
loxilb_pd_kv_tier15_hits_total counter ep_idx V gateway-default conditional-with-proven-writer
loxilb_pd_kv_tier15_miss_reason_total counter reason P gateway-default conditional-with-proven-writer
loxilb_pd_kv_tier15_spills_total counter ep_idx V gateway-default conditional-with-proven-writer
loxilb_pd_kv_zero_hit_watchdog_total counter service_id V gateway-default conditional-with-proven-writer
loxilb_pd_prefill_ep_died_total counter none E gateway-default verified-runtime
loxilb_pd_sessions_active gauge none E gateway-default verified-runtime
loxilb_pd_sg_decode_close_drain_total counter none E gateway-default verified-runtime
loxilb_pd_sg_oversize_reject_total counter none E gateway-default verified-runtime
loxilb_pd_sg_prefill_abort_decode_total counter none E gateway-default verified-runtime
loxilb_pd_sg_prefill_reject_relay_total counter none E gateway-default verified-runtime
loxilb_pd_sg_room_retry_total counter none E gateway-default verified-runtime
loxilb_pd_trie_nodes gauge none E gateway-default verified-runtime
loxilb_pd_trt_ctx_early_exit_total counter none E gateway-default verified-runtime
loxilb_persist_total counter result P gateway-default writer-mapped
loxilb_policer_attached gauge ident C gateway-default verified-static
loxilb_processed_bytes_total counter none E gateway-default writer-mapped
loxilb_processed_packets_total counter none E gateway-default writer-mapped
loxilb_processed_sctp_bytes_total counter none E gateway-default writer-mapped
loxilb_processed_sctp_packets_total counter none E gateway-default writer-mapped
loxilb_processed_tcp_bytes_total counter none E gateway-default writer-mapped
loxilb_processed_tcp_packets_total counter none E gateway-default writer-mapped
loxilb_processed_udp_bytes_total counter none E gateway-default writer-mapped
loxilb_processed_udp_packets_total counter none E gateway-default writer-mapped
loxilb_proxy_active_connections gauge none E gateway-default writer-mapped
loxilb_proxy_active_ssl_connections gauge none E gateway-default writer-mapped
loxilb_proxy_cache_backpressure_ratio gauge none E gateway-default writer-mapped
loxilb_proxy_cache_bytes gauge none E gateway-default writer-mapped
loxilb_proxy_cache_bytes_max_conn gauge none E gateway-default writer-mapped
loxilb_proxy_cache_conns_queued gauge none E gateway-default writer-mapped
loxilb_proxy_cache_drain_partial_total counter none E gateway-default writer-mapped
loxilb_proxy_cache_high_water_events_total counter none E gateway-default writer-mapped
loxilb_proxy_chunked_responses_total counter none E gateway-default writer-mapped
loxilb_proxy_conversation_hits_total counter none E gateway-default writer-mapped
loxilb_proxy_conversation_misses_total counter none E gateway-default writer-mapped
loxilb_proxy_conversation_sessions gauge none E gateway-default writer-mapped
loxilb_proxy_conversation_ttl_expired_total counter none E gateway-default writer-mapped
loxilb_proxy_graceful_close_total counter none E gateway-default writer-mapped
loxilb_proxy_header_deadline_drops_total counter none E gateway-default verified-runtime
loxilb_proxy_http2_sessions_total counter none E gateway-default writer-mapped
loxilb_proxy_http_responses_by_status_total counter status_class V gateway-default conditional-with-proven-writer
loxilb_proxy_http_responses_total counter none E gateway-default writer-mapped
loxilb_proxy_http_ttfb_seconds histogram none H gateway-default conditional-with-proven-writer
loxilb_proxy_listen_drops_total counter none E gateway-default verified-static
loxilb_proxy_listen_overflows_total counter none E gateway-default verified-static
loxilb_proxy_pd_kv_params_overflow_total counter none E gateway-default writer-mapped
loxilb_proxy_qos_bytes_delayed_total counter vip, port, proto, direction C gateway-default verified-runtime
loxilb_proxy_qos_bytes_passed_total counter vip, port, proto, direction C gateway-default verified-runtime
loxilb_proxy_qos_cbs_bytes gauge vip, port, proto, direction C gateway-default verified-runtime
loxilb_proxy_qos_cir_bytes_per_second gauge vip, port, proto, direction C gateway-default verified-runtime
loxilb_proxy_qos_park_seconds_total counter vip, port, proto, direction C gateway-default verified-runtime
loxilb_proxy_qos_parked_connections gauge vip, port, proto, direction C gateway-default verified-runtime
loxilb_proxy_qos_parks_total counter vip, port, proto, direction C gateway-default verified-runtime
loxilb_proxy_qos_tokens_bytes gauge vip, port, proto, direction C gateway-default verified-runtime
loxilb_requests_total counter none E gateway-default writer-mapped
loxilb_restore_duration_seconds histogram none E gateway-default verified-static
loxilb_restore_total counter mode, result P gateway-default verified-static
loxilb_security_conn_blocked_total counter none E gateway-default writer-mapped
loxilb_security_conn_passed_total counter none E gateway-default writer-mapped
loxilb_security_syn_blocked_total counter none E gateway-default writer-mapped
loxilb_security_syn_cookies_total counter none E gateway-default writer-mapped
loxilb_security_syn_passed_total counter none E gateway-default writer-mapped
loxilb_security_udp_blocked_total counter none E gateway-default writer-mapped
loxilb_security_udp_bytes_blocked_total counter none E gateway-default writer-mapped
loxilb_security_udp_bytes_passed_total counter none E gateway-default writer-mapped
loxilb_security_udp_passed_total counter none E gateway-default writer-mapped
loxilb_security_unique_ips gauge none E gateway-default writer-mapped
loxilb_service_errors_total counter service V gateway-default conditional-with-proven-writer
loxilb_service_requests_total counter service V gateway-default conditional-with-proven-writer
loxilb_service_traffic_bytes_total counter service V gateway-default conditional-with-proven-writer
loxilb_service_traffic_packets_total counter service V gateway-default conditional-with-proven-writer
loxilb_snapshot_quarantine_total counter none E gateway-default writer-mapped
loxilb_snapshot_total counter trigger P gateway-default verified-static
loxilb_sockproxy_sync_apply_errors_total counter none E gateway-default conditional-with-proven-writer
loxilb_sockproxy_sync_conflict_total counter outcome V gateway-default conditional-with-proven-writer
loxilb_sockproxy_sync_drop_total counter reason V gateway-default verified-static
loxilb_sockproxy_sync_health_reject_total counter reason V gateway-default conditional-with-proven-writer
loxilb_sockproxy_sync_inflight_rpc gauge peer V gateway-default conditional-with-proven-writer
loxilb_sockproxy_sync_overflow_total counter kind V gateway-default conditional-with-proven-writer
loxilb_sockproxy_sync_peer_lag_seconds gauge peer V gateway-default verified-static
loxilb_sockproxy_sync_peer_scope_version gauge peer V gateway-default verified-runtime
loxilb_sockproxy_sync_peer_up gauge peer V gateway-default verified-static
loxilb_sockproxy_sync_push_latency_seconds histogram peer, rpc V gateway-default conditional-with-proven-writer
loxilb_system_cpu_utilization_percent gauge none E gateway-default writer-mapped
loxilb_system_disk_utilization_percent gauge none E gateway-default writer-mapped
loxilb_system_memory_utilization_percent gauge none E gateway-default writer-mapped
loxilb_unhealthy_endpoints gauge none E gateway-default writer-mapped

Label enums used by examples

The example validator rejects unknown metric names and selector labels. For the closed values below it also rejects exact (= or !=) selectors that use values outside the frozen source contract.

Family Label Allowed values
loxilb_ai_jwks_refresh_total outcome success, failure
loxilb_ai_pd_requests_total phase complete, prefill, decode, unknown
loxilb_ai_pd_requests_total status success, timeout, error, rejected
loxilb_ai_pd_tier_selected_total tier tier0, tier1, tier15, tier2
loxilb_ai_requests_total outcome completed, denied
loxilb_ai_tokens_consumed_total kind prompt, completion
loxilb_ai_worker_scrape_total result ok, unreachable, http_error, body_error, unparseable, bad_request, unknown