LLM Request Router Metrics

View as Markdown

The LLM Request Router serves Prometheus metrics from llm-request-router:9090/metrics when llmRequestRouter.metrics.enabled is true. The standalone request-router chart defaults this value to false.

The self-managed stack maps addons.llm.requestRouter.metrics.enabled to this chart value. It defaults to true when the LLM add-on is enabled. The request-router chart passes --metrics-port and uses Stargate’s default stargate_ metric prefix and stargate trace service name.

Label Boundaries

Use bounded labels only. Keep routing_key, model, inference_server_id, algorithm, selection, status, result, and reason to bounded service dimensions. Do not add request IDs, session IDs, function IDs, organization IDs, project IDs, raw URLs, raw prompts, authorization values, or other unbounded request fields as metric labels.

Metrics

Metric nameTypeSource endpointLabelsNotes
stargate_requests_totalCounterllm-request-router:9090/metricsrouting_key, model, inference_server_id, statusTotal proxied requests by selected backend and status.
stargate_proxy_attempts_totalCounterllm-request-router:9090/metricsrouting_key, model, inference_server_id, resultUpstream proxy attempts by selected backend and result.
stargate_proxy_retries_totalCounterllm-request-router:9090/metricsrouting_key, model, reasonTotal proxy retries by retry reason.
stargate_routing_selections_totalCounterllm-request-router:9090/metricsrouting_key, model, algorithm, selectionPrimary and ranked fallback cluster choices used for upstream attempts.
stargate_routing_kv_free_token_fallback_selections_totalCounterllm-request-router:9090/metricsrouting_key, model, algorithmRoutes selected after a higher-ranked candidate failed the KV free-token check.
stargate_proxy_retry_exhausted_totalCounterllm-request-router:9090/metricsrouting_key, model, reasonTotal requests that exhausted retry options.
stargate_admission_rejections_totalCounterllm-request-router:9090/metricsrouting_key, model, reasonRequests rejected by local input-work admission control.
stargate_quic_connection_evictions_totalCounterllm-request-router:9090/metricsinference_server_id, reasonTotal QUIC pool evictions by backend and reason.
stargate_quic_hot_path_reconnect_totalCounterllm-request-router:9090/metricsinference_server_id, resultDirect QUIC reconnect attempts from the proxy hot path.
stargate_tls_reloads_totalCounterllm-request-router:9090/metricsmaterial_type, resultMounted TLS server identity reload attempts by result.
stargate_tls_certificate_expiry_secondsGaugellm-request-router:9090/metricsmaterial_typeUnix timestamp when the active server identity expires.
stargate_proxy_replay_buffer_bytesHistogramllm-request-router:9090/metricsmodelProxied request replay buffer size in bytes.
stargate_proxy_duration_secondsHistogramllm-request-router:9090/metricsrouting_key, model, inference_server_idTime to first byte from upstream in seconds.
stargate_routing_duration_secondsHistogramllm-request-router:9090/metricsrouting_key, modelLoad-balancer decision time in seconds.
stargate_active_inference_serversGaugellm-request-router:9090/metricsrouting_key, modelCurrently routable inference servers for a routing target.