// PD (Prefill-Decode) Router Implementation // This module handles routing for disaggregated prefill-decode systems use super::pd_types::{api_path, Bootstrap, ChatReqInput, GenerateReqInput, PDRouterError}; use super::request_adapter::ToPdRequest; use crate::core::{HealthChecker, Worker, WorkerFactory, WorkerLoadGuard}; use crate::openai_api_types::{ChatCompletionRequest, CompletionRequest, GenerateRequest}; use crate::policies::LoadBalancingPolicy; use crate::tree::Tree; use actix_web::http::header::{HeaderValue, CONTENT_TYPE}; use actix_web::{HttpRequest, HttpResponse}; use futures_util::{StreamExt, TryStreamExt}; use metrics::{counter, histogram}; use serde_json::Value; use std::collections::HashMap; use std::sync::{Arc, Mutex, RwLock}; use std::time::{Duration, Instant}; use tracing::{debug, error, info, warn}; use uuid::Uuid; #[derive(Debug)] pub struct PDRouter { pub prefill_workers: Arc>>>, pub decode_workers: Arc>>>, pub policy: Arc, pub prefill_tree: Option>>, pub timeout_secs: u64, pub interval_secs: u64, pub worker_loads: Arc>>, pub load_monitor_handle: Option>>, pub http_client: reqwest::Client, _prefill_health_checker: Option, _decode_health_checker: Option, } impl PDRouter { // Dynamic worker management methods for service discovery pub async fn add_prefill_server( &self, url: String, bootstrap_port: Option, ) -> Result { // Wait for the new server to be healthy crate::routers::router::Router::wait_for_healthy_workers( &[url.clone()], self.timeout_secs, self.interval_secs, ) .map_err(|_| PDRouterError::HealthCheckFailed { url: url.clone() })?; // Create Worker for the new prefill server let worker = WorkerFactory::create_prefill(url.clone(), bootstrap_port); // Add to prefill workers list let mut workers = self .prefill_workers .write() .map_err(|_| PDRouterError::LockError { operation: "prefill_workers write".to_string(), })?; // Check if already exists if workers.iter().any(|w| w.url() == &url) { return Err(PDRouterError::WorkerAlreadyExists { url: url.clone() }); } workers.push(worker); // Add to cache tree if using cache-aware policy if let Some(ref tree) = self.prefill_tree { tree.lock().unwrap().insert("", &url); } info!("Added prefill server: {}", url); Ok(format!("Successfully added prefill server: {}", url)) } pub async fn add_decode_server(&self, url: String) -> Result { // Wait for the new server to be healthy crate::routers::router::Router::wait_for_healthy_workers( &[url.clone()], self.timeout_secs, self.interval_secs, ) .map_err(|_| PDRouterError::HealthCheckFailed { url: url.clone() })?; // Create Worker for the new decode server let worker = WorkerFactory::create_decode(url.clone()); // Add to decode workers list let mut workers = self .decode_workers .write() .map_err(|_| PDRouterError::LockError { operation: "decode_workers write".to_string(), })?; // Check if already exists if workers.iter().any(|w| w.url() == &url) { return Err(PDRouterError::WorkerAlreadyExists { url: url.clone() }); } workers.push(worker); info!("Added decode server: {}", url); Ok(format!("Successfully added decode server: {}", url)) } pub async fn remove_prefill_server(&self, url: &str) -> Result { let mut workers = self .prefill_workers .write() .map_err(|_| PDRouterError::LockError { operation: "prefill_workers write".to_string(), })?; // Find and remove the server let initial_len = workers.len(); workers.retain(|w| w.url() != url); if workers.len() == initial_len { return Err(PDRouterError::WorkerNotFound { url: url.to_string(), }); } // Remove from cache tree if using cache-aware policy if let Some(ref tree) = self.prefill_tree { // Note: Tree doesn't have a remove method, so we rebuild it let mut tree_guard = tree.lock().unwrap(); *tree_guard = Tree::new(); for worker in workers.iter() { tree_guard.insert("", worker.url()); } } info!("Removed prefill server: {}", url); Ok(format!("Successfully removed prefill server: {}", url)) } pub async fn remove_decode_server(&self, url: &str) -> Result { let mut workers = self .decode_workers .write() .map_err(|_| PDRouterError::LockError { operation: "decode_workers write".to_string(), })?; // Find and remove the server let initial_len = workers.len(); workers.retain(|w| w.url() != url); if workers.len() == initial_len { return Err(PDRouterError::WorkerNotFound { url: url.to_string(), }); } info!("Removed decode server: {}", url); Ok(format!("Successfully removed decode server: {}", url)) } pub fn new( prefill_urls: Vec<(String, Option)>, decode_urls: Vec, policy: Arc, timeout_secs: u64, interval_secs: u64, ) -> Result { // Convert URLs to Worker trait objects let prefill_workers: Vec> = prefill_urls .into_iter() .map(|(url, port)| WorkerFactory::create_prefill(url, port)) .collect(); let decode_workers: Vec> = decode_urls .into_iter() .map(WorkerFactory::create_decode) .collect(); // Wait for PD workers to be healthy (skip if empty - for service discovery mode) let all_urls: Vec = prefill_workers .iter() .chain(decode_workers.iter()) .map(|worker| worker.url().to_string()) .collect(); if !all_urls.is_empty() { crate::routers::router::Router::wait_for_healthy_workers( &all_urls, timeout_secs, interval_secs, )?; } // Initialize cache-aware components if needed let prefill_tree = if policy.name() == "cache_aware" { // Initialize the policy's internal tree with prefill workers if let Some(cache_policy) = policy .as_any() .downcast_ref::() { cache_policy.init_workers(&prefill_workers); } let tree = Arc::new(Mutex::new(Tree::new())); // Initialize tree with prefill workers for worker in &prefill_workers { tree.lock().unwrap().insert("", worker.url()); } Some(tree) } else { None }; // Set up background load monitoring for power-of-two selection let (tx, rx) = tokio::sync::watch::channel(HashMap::new()); let worker_loads = Arc::new(rx); // Create a shared HTTP client for all operations let http_client = reqwest::Client::builder() .timeout(Duration::from_secs(timeout_secs)) .build() .map_err(|e| format!("Failed to create HTTP client: {}", e))?; let load_monitor_handle = if policy.name() == "power_of_two" { let monitor_urls = all_urls.clone(); let monitor_interval = interval_secs; let monitor_client = http_client.clone(); let policy_clone = Arc::clone(&policy); Some(Arc::new(tokio::spawn(async move { Self::monitor_worker_loads_with_client( monitor_urls, tx, monitor_interval, monitor_client, policy_clone, ) .await; }))) } else { None }; let prefill_workers = Arc::new(RwLock::new(prefill_workers)); let decode_workers = Arc::new(RwLock::new(decode_workers)); // Start health checkers for both worker pools let prefill_health_checker = crate::core::start_health_checker(Arc::clone(&prefill_workers), interval_secs); let decode_health_checker = crate::core::start_health_checker(Arc::clone(&decode_workers), interval_secs); Ok(PDRouter { prefill_workers, decode_workers, policy, prefill_tree, timeout_secs, interval_secs, worker_loads, load_monitor_handle, http_client, _prefill_health_checker: Some(prefill_health_checker), _decode_health_checker: Some(decode_health_checker), }) } // Route a typed generate request pub async fn route_generate( &self, client: &reqwest::Client, req: &HttpRequest, mut typed_req: GenerateReqInput, route: &str, ) -> HttpResponse { let start = Instant::now(); let _request_id = Uuid::new_v4(); // Get stream flag and return_logprob flag before moving the request let is_stream = typed_req.stream; let return_logprob = typed_req .other .get("return_logprob") .and_then(|v| v.as_bool()) .unwrap_or(false); // Extract text for cache-aware routing from the typed request let request_text = typed_req.text.as_ref().and_then(|t| match t { super::pd_types::InputText::Single(s) => Some(s.as_str()), super::pd_types::InputText::Batch(v) => v.first().map(|s| s.as_str()), }); // Select servers let (prefill, decode) = match self.select_pd_pair(client, request_text).await { Ok(pair) => pair, Err(e) => { error!("Failed to select PD pair: {}", e); counter!("sgl_router_pd_errors_total", "error" => "server_selection").increment(1); return HttpResponse::ServiceUnavailable() .body(format!("No available servers: {}", e)); } }; // Log routing decision info!( "PD routing: {} -> prefill={}, decode={}", route, prefill.url(), decode.url() ); // Add bootstrap info using the trait method if let Err(e) = typed_req.add_bootstrap_info(prefill.as_ref()) { error!("Failed to add bootstrap info: {}", e); counter!("sgl_router_pd_errors_total", "error" => "bootstrap_injection").increment(1); return HttpResponse::InternalServerError() .body(format!("Bootstrap injection failed: {}", e)); } // Convert to JSON after bootstrap injection let json_with_bootstrap = match serde_json::to_value(&typed_req) { Ok(json) => json, Err(e) => { error!("Failed to serialize request: {}", e); return HttpResponse::InternalServerError().body("Failed to serialize request"); } }; // Execute dual dispatch self.execute_dual_dispatch( client, req, json_with_bootstrap, route, prefill.as_ref(), decode.as_ref(), is_stream, return_logprob, start, ) .await } // Route a typed chat request pub async fn route_chat( &self, client: &reqwest::Client, req: &HttpRequest, mut typed_req: ChatReqInput, route: &str, ) -> HttpResponse { let start = Instant::now(); // Get stream flag and return_logprob flag before moving the request let is_stream = typed_req.stream; let return_logprob = typed_req .other .get("return_logprob") .and_then(|v| v.as_bool()) .unwrap_or(false); // Extract text for cache-aware routing from chat messages let request_text = typed_req .other .get("messages") .and_then(|messages| messages.as_array()) .and_then(|arr| arr.first()) .and_then(|msg| msg.get("content")) .and_then(|content| content.as_str()); // Select servers let (prefill, decode) = match self.select_pd_pair(client, request_text).await { Ok(pair) => pair, Err(e) => { error!("Failed to select PD pair: {}", e); counter!("sgl_router_pd_errors_total", "error" => "server_selection").increment(1); return HttpResponse::ServiceUnavailable() .body(format!("No available servers: {}", e)); } }; // Log routing decision info!( "PD routing: {} -> prefill={}, decode={}", route, prefill.url(), decode.url() ); // Add bootstrap info using the trait method if let Err(e) = typed_req.add_bootstrap_info(prefill.as_ref()) { error!("Failed to add bootstrap info: {}", e); counter!("sgl_router_pd_errors_total", "error" => "bootstrap_injection").increment(1); return HttpResponse::InternalServerError() .body(format!("Bootstrap injection failed: {}", e)); } // Convert to JSON after bootstrap injection let json_with_bootstrap = match serde_json::to_value(&typed_req) { Ok(json) => json, Err(e) => { error!("Failed to serialize request: {}", e); return HttpResponse::InternalServerError().body("Failed to serialize request"); } }; // Execute dual dispatch self.execute_dual_dispatch( client, req, json_with_bootstrap, route, prefill.as_ref(), decode.as_ref(), is_stream, return_logprob, start, ) .await } // Execute the dual dispatch to prefill and decode servers #[allow(clippy::too_many_arguments)] async fn execute_dual_dispatch( &self, client: &reqwest::Client, req: &HttpRequest, json_request: serde_json::Value, route: &str, prefill: &dyn Worker, decode: &dyn Worker, is_stream: bool, return_logprob: bool, start_time: Instant, ) -> HttpResponse { // Update load tracking for both workers let _guard = WorkerLoadGuard::new_multi(vec![prefill, decode]); // Build requests using .json() method let mut prefill_request = client .post(api_path(prefill.url(), route)) .json(&json_request); let mut decode_request = client .post(api_path(decode.url(), route)) .json(&json_request); // Copy headers from original request for (name, value) in crate::routers::router::copy_request_headers(req) { if name.to_lowercase() != "content-type" && name.to_lowercase() != "content-length" { prefill_request = prefill_request.header(&name, &value); decode_request = decode_request.header(&name, &value); } } // Send both requests concurrently let (prefill_result, decode_result) = tokio::join!(prefill_request.send(), decode_request.send()); // Update metrics let duration = start_time.elapsed(); histogram!("sgl_router_pd_request_duration_seconds", "route" => route.to_string()) .record(duration.as_secs_f64()); counter!("sgl_router_pd_requests_total", "route" => route.to_string()).increment(1); counter!("sgl_router_pd_prefill_requests_total", "worker" => prefill.url().to_string()) .increment(1); counter!("sgl_router_pd_decode_requests_total", "worker" => decode.url().to_string()) .increment(1); // Process decode response match decode_result { Ok(res) => { let status = actix_web::http::StatusCode::from_u16(res.status().as_u16()) .unwrap_or(actix_web::http::StatusCode::INTERNAL_SERVER_ERROR); if !status.is_success() { counter!("sgl_router_pd_decode_errors_total", "worker" => decode.url().to_string()).increment(1); error!( "Decode server {} returned error status: {}", decode.url(), status ); // Return the error response from decode server match res.bytes().await { Ok(error_body) => { return HttpResponse::build(status).body(error_body.to_vec()); } Err(e) => { return HttpResponse::build(status) .body(format!("Decode server error: {}", e)); } } } // Log prefill errors for debugging if let Err(e) = &prefill_result { error!( "Prefill server {} failed (non-critical): {}", prefill.url(), e ); counter!("sgl_router_pd_prefill_errors_total", "worker" => prefill.url().to_string()).increment(1); } if is_stream { // Streaming response if return_logprob { // Get prefill logprobs for merging let prefill_logprobs = match prefill_result { Ok(prefill_res) => match prefill_res.bytes().await { Ok(body) => serde_json::from_slice::(&body) .ok() .and_then(|json| { json.pointer("/meta_info/input_token_logprobs").cloned() }), Err(_) => None, }, Err(_) => None, }; // Stream with logprob merging HttpResponse::build(status) .insert_header(( CONTENT_TYPE, HeaderValue::from_static("text/event-stream"), )) .streaming(res.bytes_stream().map(move |chunk_result| { match chunk_result { Ok(chunk) => { // Try to merge logprobs if let Ok(merged) = Self::merge_streaming_logprobs( prefill_logprobs.clone(), &chunk, ) { Ok(merged) } else { Ok(chunk) } } Err(e) => Err(actix_web::error::ErrorInternalServerError( format!("Stream error: {}", e), )), } })) } else { // No logprob merging needed HttpResponse::build(status) .insert_header((CONTENT_TYPE, HeaderValue::from_static("text/event-stream"))) .streaming({ let decode_url = decode.url().to_string(); res.bytes_stream().map_err(move |e| { error!("Stream error from decode server {}: {}", decode_url, e); counter!("sgl_router_pd_stream_errors_total", "worker" => decode_url.to_string()).increment(1); actix_web::error::ErrorInternalServerError(format!("Stream error: {}", e)) }) }) } } else { // Non-streaming response match res.bytes().await { Ok(decode_body) => { if return_logprob { self.merge_logprobs(prefill_result, decode_body, status) .await } else { HttpResponse::build(status).body(decode_body.to_vec()) } } Err(e) => { error!("Failed to read decode response: {}", e); HttpResponse::InternalServerError().body("Failed to read response") } } } } Err(e) => { error!("Decode request failed: {}", e); counter!("sgl_router_pd_decode_errors_total", "worker" => decode.url().to_string()) .increment(1); HttpResponse::BadGateway().body(format!("Decode server error: {}", e)) } } } // Merge logprobs from prefill and decode responses async fn merge_logprobs( &self, prefill_result: Result, decode_body: bytes::Bytes, status: actix_web::http::StatusCode, ) -> HttpResponse { match prefill_result { Ok(prefill_res) => { match prefill_res.bytes().await { Ok(prefill_body) => { match ( serde_json::from_slice::(&prefill_body), serde_json::from_slice::(&decode_body), ) { (Ok(prefill_json), Ok(mut decode_json)) => { // Merge input_token_logprobs if let (Some(prefill_meta), Some(decode_meta)) = ( prefill_json.get("meta_info"), decode_json.get_mut("meta_info"), ) { if let (Some(prefill_logprobs), Some(decode_logprobs)) = ( prefill_meta.get("input_token_logprobs"), decode_meta.get_mut("input_token_logprobs"), ) { if let (Some(p_arr), Some(d_arr)) = ( prefill_logprobs.as_array(), decode_logprobs.as_array(), ) { let mut merged = p_arr.clone(); merged.extend(d_arr.clone()); decode_meta["input_token_logprobs"] = Value::Array(merged); } } } HttpResponse::build(status).json(&decode_json) } _ => { warn!("Failed to parse responses for logprob merging"); HttpResponse::build(status).body(decode_body.to_vec()) } } } Err(e) => { warn!("Failed to read prefill response: {}", e); HttpResponse::build(status).body(decode_body.to_vec()) } } } Err(_) => HttpResponse::build(status).body(decode_body.to_vec()), } } // Select a pair of prefill and decode servers async fn select_pd_pair( &self, _client: &reqwest::Client, request_text: Option<&str>, ) -> Result<(Box, Box), String> { // Get read locks for both worker lists let prefill_workers = self .prefill_workers .read() .map_err(|e| format!("Failed to acquire prefill workers lock: {}", e))?; let decode_workers = self .decode_workers .read() .map_err(|e| format!("Failed to acquire decode workers lock: {}", e))?; // Check we have workers if prefill_workers.is_empty() { return Err("No prefill workers available. Please check if prefill servers are configured and healthy.".to_string()); } if decode_workers.is_empty() { return Err("No decode workers available. Please check if decode servers are configured and healthy.".to_string()); } // Use the policy to select worker pair match self .policy .select_worker_pair(&prefill_workers, &decode_workers, request_text) { Some((prefill_idx, decode_idx)) => { let prefill = prefill_workers[prefill_idx].clone_worker(); let decode = decode_workers[decode_idx].clone_worker(); Ok((prefill, decode)) } None => Err("Failed to select worker pair".to_string()), } } // Background task to monitor worker loads with shared client async fn monitor_worker_loads_with_client( worker_urls: Vec, tx: tokio::sync::watch::Sender>, interval_secs: u64, client: reqwest::Client, policy: Arc, ) { loop { let mut loads = HashMap::new(); let futures: Vec<_> = worker_urls .iter() .map(|url| { let client = client.clone(); let url = url.clone(); async move { let load = get_worker_load(&client, &url).await.unwrap_or(0); (url, load) } }) .collect(); let results = futures_util::future::join_all(futures).await; for (url, load) in results { loads.insert(url, load); } debug!("Worker loads updated: {:?}", loads); // Update the policy with current loads policy.update_loads(&loads); // Check if receiver is still active if tx.send(loads).is_err() { info!("Load monitor receiver dropped, shutting down monitor task"); break; } tokio::time::sleep(Duration::from_secs(interval_secs)).await; } } // Simple helper to merge logprobs in streaming responses fn merge_streaming_logprobs( prefill_logprobs: Option, decode_chunk: &[u8], ) -> Result { // Skip non-data chunks let chunk_str = std::str::from_utf8(decode_chunk).map_err(|_| ())?; if !chunk_str.starts_with("data: ") || chunk_str.contains("[DONE]") { return Err(()); } // Parse JSON from chunk let json_str = chunk_str.trim_start_matches("data: ").trim(); let mut decode_json: Value = serde_json::from_str(json_str).map_err(|_| ())?; // Merge prefill logprobs if available if let Some(ref p_logprobs) = prefill_logprobs { if let Some(meta) = decode_json.get_mut("meta_info") { if let Some(d_logprobs) = meta.get_mut("input_token_logprobs") { if let (Some(p_arr), Some(d_arr)) = (p_logprobs.as_array(), d_logprobs.as_array()) { let mut merged = p_arr.clone(); merged.extend(d_arr.clone()); *d_logprobs = Value::Array(merged); } } } } // Re-serialize let merged_str = format!( "data: {}\n\n", serde_json::to_string(&decode_json).unwrap_or_default() ); Ok(bytes::Bytes::from(merged_str)) } } // Helper functions async fn get_worker_load(client: &reqwest::Client, worker_url: &str) -> Option { match client.get(format!("{}/get_load", worker_url)).send().await { Ok(res) if res.status().is_success() => match res.bytes().await { Ok(bytes) => match serde_json::from_slice::(&bytes) { Ok(data) => data .get("load") .and_then(|v| v.as_i64()) .map(|v| v as isize), Err(e) => { debug!("Failed to parse load response from {}: {}", worker_url, e); None } }, Err(e) => { debug!("Failed to read load response from {}: {}", worker_url, e); None } }, Ok(res) => { debug!( "Worker {} returned non-success status: {}", worker_url, res.status() ); None } Err(e) => { debug!("Failed to get load from {}: {}", worker_url, e); None } } } // PD-specific endpoints impl PDRouter { pub async fn health_generate(&self, client: &reqwest::Client) -> HttpResponse { // Test model generation capability by selecting a random pair and testing them // Note: This endpoint actually causes the model to generate tokens, so we only test one pair // Select a random worker pair using the policy let (prefill, decode) = match self.select_pd_pair(client, None).await { Ok(pair) => pair, Err(e) => { return HttpResponse::ServiceUnavailable() .body(format!("No healthy worker pair available: {}", e)); } }; // Test prefill server's health_generate let prefill_url = format!("{}/health_generate", prefill.url()); let prefill_result = client.get(&prefill_url).send().await; // Test decode server's health_generate let decode_url = format!("{}/health_generate", decode.url()); let decode_result = client.get(&decode_url).send().await; // Check results let mut errors = Vec::new(); match prefill_result { Ok(res) if res.status().is_success() => { debug!( "Health generate passed for prefill server: {}", prefill.url() ); } Ok(res) => { errors.push(format!( "Prefill {} returned status {}", prefill.url(), res.status() )); } Err(e) => { errors.push(format!("Prefill {} error: {}", prefill.url(), e)); } } match decode_result { Ok(res) if res.status().is_success() => { debug!("Health generate passed for decode server: {}", decode.url()); } Ok(res) => { errors.push(format!( "Decode {} returned status {}", decode.url(), res.status() )); } Err(e) => { errors.push(format!("Decode {} error: {}", decode.url(), e)); } } if errors.is_empty() { HttpResponse::Ok().body(format!( "Health generate passed on selected pair: prefill={}, decode={}", prefill.url(), decode.url() )) } else { HttpResponse::ServiceUnavailable().body(format!("Health generate failed: {:?}", errors)) } } pub async fn get_server_info(&self, client: &reqwest::Client) -> HttpResponse { // Get info from the first decode server to match sglang's server info format let first_decode_url = if let Ok(workers) = self.decode_workers.read() { workers.first().map(|w| w.url().to_string()) } else { return HttpResponse::InternalServerError().body("Failed to access decode workers"); }; if let Some(worker_url) = first_decode_url { match client .get(format!("{}/get_server_info", worker_url)) .send() .await { Ok(res) if res.status().is_success() => { match res.json::().await { Ok(info) => { // The decode server should already return the proper format // with tokenizer_path and other fields that bench_one_batch_server.py expects HttpResponse::Ok().json(info) } Err(e) => { error!("Failed to parse server info: {}", e); HttpResponse::InternalServerError() .body(format!("Failed to parse server info: {}", e)) } } } Ok(res) => { let status = actix_web::http::StatusCode::from_u16(res.status().as_u16()) .unwrap_or(actix_web::http::StatusCode::INTERNAL_SERVER_ERROR); HttpResponse::build(status) .body(format!("Decode server returned status: {}", res.status())) } Err(e) => { error!("Failed to get server info: {}", e); HttpResponse::InternalServerError() .body(format!("Failed to get server info: {}", e)) } } } else { HttpResponse::ServiceUnavailable().body("No decode servers available") } } pub async fn get_models(&self, client: &reqwest::Client, req: &HttpRequest) -> HttpResponse { // Get first prefill worker URL to avoid holding lock across await let first_worker_url = if let Ok(workers) = self.prefill_workers.read() { workers.first().map(|w| w.url().to_string()) } else { return HttpResponse::InternalServerError().body("Failed to access prefill workers"); }; if let Some(worker_url) = first_worker_url { // Send request directly without going through Router let mut request_builder = client.get(format!("{}/v1/models", worker_url)); for (name, value) in crate::routers::router::copy_request_headers(req) { if name.to_lowercase() != "content-type" && name.to_lowercase() != "content-length" { request_builder = request_builder.header(name, value); } } match request_builder.send().await { Ok(res) => { let status = actix_web::http::StatusCode::from_u16(res.status().as_u16()) .unwrap_or(actix_web::http::StatusCode::INTERNAL_SERVER_ERROR); match res.bytes().await { Ok(body) => HttpResponse::build(status).body(body.to_vec()), Err(e) => HttpResponse::InternalServerError() .body(format!("Failed to read response body: {}", e)), } } Err(e) => HttpResponse::InternalServerError() .body(format!("Failed to send request: {}", e)), } } else { HttpResponse::ServiceUnavailable().body("No prefill servers available") } } pub async fn get_loads(&self, client: &reqwest::Client) -> HttpResponse { let p_urls: Vec<_> = self .prefill_workers .read() .unwrap() .iter() .map(|w| w.url().to_string()) .collect(); let d_urls: Vec<_> = self .decode_workers .read() .unwrap() .iter() .map(|w| w.url().to_string()) .collect(); let mut prefill_loads = Vec::new(); let mut decode_loads = Vec::new(); for url in &p_urls { let load = get_worker_load(client, url).await.unwrap_or(-1); prefill_loads.push(serde_json::json!({ "engine": format!("(Prefill@{})", url), "load": load as i64 })); } for url in &d_urls { let load = get_worker_load(client, url).await.unwrap_or(-1); decode_loads.push(serde_json::json!({ "engine": format!("(Decode@{})", url), "load": load as i64 })); } HttpResponse::Ok().json(serde_json::json!({ "prefill": prefill_loads, "decode": decode_loads })) } pub async fn get_model_info( &self, client: &reqwest::Client, req: &HttpRequest, ) -> HttpResponse { // Get model info from the first prefill server (matches original Rust PDLB behavior) // Get first prefill worker URL to avoid holding lock across await let first_worker_url = if let Ok(workers) = self.prefill_workers.read() { workers.first().map(|w| w.url().to_string()) } else { return HttpResponse::InternalServerError().body("Failed to access prefill workers"); }; if let Some(worker_url) = first_worker_url { let mut request_builder = client.get(format!("{}/get_model_info", worker_url)); for (name, value) in crate::routers::router::copy_request_headers(req) { if name.to_lowercase() != "content-type" && name.to_lowercase() != "content-length" { request_builder = request_builder.header(name, value); } } match request_builder.send().await { Ok(res) => { let status = actix_web::http::StatusCode::from_u16(res.status().as_u16()) .unwrap_or(actix_web::http::StatusCode::INTERNAL_SERVER_ERROR); match res.bytes().await { Ok(body) => HttpResponse::build(status).body(body.to_vec()), Err(e) => HttpResponse::InternalServerError() .body(format!("Failed to read response body: {}", e)), } } Err(e) => HttpResponse::InternalServerError() .body(format!("Failed to send request: {}", e)), } } else { HttpResponse::ServiceUnavailable().body("No prefill servers available") } } pub async fn flush_cache(&self, client: &reqwest::Client) -> HttpResponse { let mut tasks = Vec::new(); // Flush cache on all prefill servers for worker in self.prefill_workers.read().unwrap().iter() { let url = format!("{}/flush_cache", worker.url()); tasks.push(client.post(&url).send()); } // Flush cache on all decode servers for worker in self.decode_workers.read().unwrap().iter() { let url = format!("{}/flush_cache", worker.url()); tasks.push(client.post(&url).send()); } let results = futures_util::future::join_all(tasks).await; let mut all_success = true; for (i, result) in results.into_iter().enumerate() { match result { Ok(res) if res.status().is_success() => {} Ok(res) => { all_success = false; warn!( "Server {} returned status {} for flush_cache", i, res.status() ); } Err(e) => { all_success = false; error!("Server {} error during flush_cache: {}", i, e); } } } if all_success { HttpResponse::Ok().body("Cache flushed on all servers") } else { HttpResponse::InternalServerError().body("Cache flush failed on one or more servers") } } } use crate::routers::{RouterTrait, WorkerManagement}; use async_trait::async_trait; use reqwest::Client; #[async_trait] impl WorkerManagement for PDRouter { async fn add_worker(&self, _worker_url: &str) -> Result { // For PD router, we don't support adding workers via this generic method Err( "PD router requires specific add_prefill_server or add_decode_server methods" .to_string(), ) } fn remove_worker(&self, worker_url: &str) { // For PD router, we would need to know if it's a prefill or decode server // For now, try both if let Ok(mut workers) = self.prefill_workers.write() { if let Some(index) = workers.iter().position(|w| w.url() == worker_url) { workers.remove(index); info!("Removed prefill worker: {}", worker_url); return; } } if let Ok(mut workers) = self.decode_workers.write() { if let Some(index) = workers.iter().position(|w| w.url() == worker_url) { workers.remove(index); info!("Removed decode worker: {}", worker_url); } } } fn get_worker_urls(&self) -> Vec { let mut urls = Vec::new(); // Add prefill worker URLs if let Ok(workers) = self.prefill_workers.read() { for worker in workers.iter() { urls.push(worker.url().to_string()); } } // Add decode worker URLs if let Ok(workers) = self.decode_workers.read() { for worker in workers.iter() { urls.push(worker.url().to_string()); } } urls } } #[async_trait(?Send)] impl RouterTrait for PDRouter { fn as_any(&self) -> &dyn std::any::Any { self } async fn health(&self, _client: &Client, _req: &HttpRequest) -> HttpResponse { // This is a server readiness check - checking if we have healthy workers // Workers handle their own health checks in the background let mut all_healthy = true; let mut unhealthy_servers = Vec::new(); // Check prefill servers for worker in self.prefill_workers.read().unwrap().iter() { if !worker.is_healthy() { all_healthy = false; unhealthy_servers.push(format!("Prefill: {}", worker.url())); } } // Check decode servers for worker in self.decode_workers.read().unwrap().iter() { if !worker.is_healthy() { all_healthy = false; unhealthy_servers.push(format!("Decode: {}", worker.url())); } } if all_healthy { HttpResponse::Ok().body("All servers healthy") } else { HttpResponse::ServiceUnavailable() .body(format!("Unhealthy servers: {:?}", unhealthy_servers)) } } async fn health_generate(&self, client: &Client, _req: &HttpRequest) -> HttpResponse { // Use the existing PDRouter health_generate method PDRouter::health_generate(self, client).await } async fn get_server_info(&self, client: &Client, _req: &HttpRequest) -> HttpResponse { // Use the existing PDRouter get_server_info method PDRouter::get_server_info(self, client).await } async fn get_models(&self, client: &Client, req: &HttpRequest) -> HttpResponse { // Get first prefill worker URL to avoid holding lock across await let first_worker_url = if let Ok(workers) = self.prefill_workers.read() { workers.first().map(|w| w.url().to_string()) } else { return HttpResponse::InternalServerError().body("Failed to access prefill workers"); }; if let Some(worker_url) = first_worker_url { // Send request directly without going through Router let mut request_builder = client.get(format!("{}/v1/models", worker_url)); for (name, value) in crate::routers::router::copy_request_headers(req) { if name.to_lowercase() != "content-type" && name.to_lowercase() != "content-length" { request_builder = request_builder.header(name, value); } } match request_builder.send().await { Ok(res) => { let status = actix_web::http::StatusCode::from_u16(res.status().as_u16()) .unwrap_or(actix_web::http::StatusCode::INTERNAL_SERVER_ERROR); match res.bytes().await { Ok(body) => HttpResponse::build(status).body(body.to_vec()), Err(e) => HttpResponse::InternalServerError() .body(format!("Failed to read response body: {}", e)), } } Err(e) => HttpResponse::InternalServerError() .body(format!("Failed to send request: {}", e)), } } else { HttpResponse::ServiceUnavailable().body("No prefill servers available") } } async fn get_model_info(&self, client: &Client, req: &HttpRequest) -> HttpResponse { // For PD router, get model info from the first prefill server // Get first prefill worker URL to avoid holding lock across await let first_worker_url = if let Ok(workers) = self.prefill_workers.read() { workers.first().map(|w| w.url().to_string()) } else { return HttpResponse::InternalServerError().body("Failed to access prefill workers"); }; if let Some(worker_url) = first_worker_url { let mut request_builder = client.get(format!("{}/get_model_info", worker_url)); for (name, value) in crate::routers::router::copy_request_headers(req) { if name.to_lowercase() != "content-type" && name.to_lowercase() != "content-length" { request_builder = request_builder.header(name, value); } } match request_builder.send().await { Ok(res) => { let status = actix_web::http::StatusCode::from_u16(res.status().as_u16()) .unwrap_or(actix_web::http::StatusCode::INTERNAL_SERVER_ERROR); match res.bytes().await { Ok(body) => HttpResponse::build(status).body(body.to_vec()), Err(e) => HttpResponse::InternalServerError() .body(format!("Failed to read response body: {}", e)), } } Err(e) => HttpResponse::InternalServerError() .body(format!("Failed to send request: {}", e)), } } else { HttpResponse::ServiceUnavailable().body("No prefill servers available") } } async fn route_generate( &self, client: &Client, req: &HttpRequest, body: serde_json::Value, ) -> HttpResponse { match serde_json::from_value::(body.clone()) { Ok(openai_req) => { // Convert OpenAI format to PD format let pd_req = openai_req.to_pd_request(); PDRouter::route_generate(self, client, req, pd_req, "/generate").await } Err(_) => { // If that fails, try to deserialize directly as PD format (for backwards compatibility) match serde_json::from_value::(body) { Ok(pd_req) => { PDRouter::route_generate(self, client, req, pd_req, "/generate").await } Err(e) => { HttpResponse::BadRequest().body(format!("Invalid request format: {}", e)) } } } } } async fn route_chat( &self, client: &Client, req: &HttpRequest, body: serde_json::Value, ) -> HttpResponse { match serde_json::from_value::(body.clone()) { Ok(openai_req) => { // Convert OpenAI format to PD format let pd_req = openai_req.to_pd_request(); PDRouter::route_chat(self, client, req, pd_req, "/v1/chat/completions").await } Err(_) => { // If that fails, try to deserialize directly as PD format (for backwards compatibility) match serde_json::from_value::(body) { Ok(pd_req) => { PDRouter::route_chat(self, client, req, pd_req, "/v1/chat/completions") .await } Err(e) => { HttpResponse::BadRequest().body(format!("Invalid request format: {}", e)) } } } } } async fn route_completion( &self, client: &Client, req: &HttpRequest, body: serde_json::Value, ) -> HttpResponse { match serde_json::from_value::(body.clone()) { Ok(openai_req) => { // Convert OpenAI format to PD format (CompletionRequest -> GenerateReqInput) let pd_req = openai_req.to_pd_request(); PDRouter::route_generate(self, client, req, pd_req, "/v1/completions").await } Err(_) => { // If that fails, try to deserialize directly as PD format (for backwards compatibility) match serde_json::from_value::(body) { Ok(pd_req) => { PDRouter::route_generate(self, client, req, pd_req, "/v1/completions").await } Err(e) => { HttpResponse::BadRequest().body(format!("Invalid request format: {}", e)) } } } } } async fn flush_cache(&self, client: &Client) -> HttpResponse { // Use the existing PDRouter flush_cache method PDRouter::flush_cache(self, client).await } async fn get_worker_loads(&self, client: &Client) -> HttpResponse { // Use the existing PDRouter get_loads method PDRouter::get_loads(self, client).await } fn router_type(&self) -> &'static str { "pd" } fn readiness(&self) -> HttpResponse { // PD router is ready if it has at least one healthy prefill AND one healthy decode worker let healthy_prefill_count = self .prefill_workers .read() .unwrap() .iter() .filter(|w| w.is_healthy()) .count(); let healthy_decode_count = self .decode_workers .read() .unwrap() .iter() .filter(|w| w.is_healthy()) .count(); let total_prefill = self.prefill_workers.read().unwrap().len(); let total_decode = self.decode_workers.read().unwrap().len(); if healthy_prefill_count > 0 && healthy_decode_count > 0 { HttpResponse::Ok().json(serde_json::json!({ "status": "ready", "prefill": { "healthy": healthy_prefill_count, "total": total_prefill }, "decode": { "healthy": healthy_decode_count, "total": total_decode } })) } else { let mut reasons = Vec::new(); if healthy_prefill_count == 0 { reasons.push("no healthy prefill workers"); } if healthy_decode_count == 0 { reasons.push("no healthy decode workers"); } HttpResponse::ServiceUnavailable().json(serde_json::json!({ "status": "not_ready", "reason": reasons.join(", "), "prefill": { "healthy": healthy_prefill_count, "total": total_prefill }, "decode": { "healthy": healthy_decode_count, "total": total_decode } })) } } }