[router] remove old/oudated/useless comments (#10967)

sgl-router/src/logging.rs

@@ -8,20 +8,13 @@ use tracing_subscriber::layer::SubscriberExt;
 use tracing_subscriber::util::SubscriberInitExt;
 use tracing_subscriber::{EnvFilter, Layer};
 
-/// Configuration for the logging system
 #[derive(Debug, Clone)]
 pub struct LoggingConfig {
-    /// Log level for the application (default: INFO)
     pub level: Level,
-    /// Whether to use json format for logs (default: false)
     pub json_format: bool,
-    /// Path to store log files. If None, logs will only go to stdout/stderr
     pub log_dir: Option<String>,
-    /// Whether to colorize logs when output is a terminal (default: true)
     pub colorize: bool,
-    /// Log file name to use if log_dir is specified (default: "sgl-router")
     pub log_file_name: String,
-    /// Custom log targets to filter (default: "sglang_router_rs")
     pub log_targets: Option<Vec<String>>,
 }
 
@@ -38,30 +31,14 @@ impl Default for LoggingConfig {
     }
 }
 
-/// Guard that keeps the file appender worker thread alive
-///
-/// This must be kept in scope for the duration of the program
-/// to ensure logs are properly written to files
 #[allow(dead_code)]
 pub struct LogGuard {
     _file_guard: Option<WorkerGuard>,
 }
 
-/// Initialize the logging system with the given configuration
-///
-/// # Arguments
-/// * `config` - Configuration for the logging system
-///
-/// # Returns
-/// A LogGuard that must be kept alive for the duration of the program
-///
-/// # Panics
-/// Will not panic, as initialization errors are handled gracefully
 pub fn init_logging(config: LoggingConfig) -> LogGuard {
-    // Forward logs to tracing - ignore errors to allow for multiple initialization
     let _ = LogTracer::init();
 
-    // Convert log level to filter string
     let level_filter = match config.level {
         Level::TRACE => "trace",
         Level::DEBUG => "debug",
@@ -70,9 +47,7 @@ pub fn init_logging(config: LoggingConfig) -> LogGuard {
         Level::ERROR => "error",
     };
 
-    // Create env filter
     let env_filter = EnvFilter::try_from_default_env().unwrap_or_else(|_| {
-        // Format: <target>=<level>,<target2>=<level2>,...
         let filter_string = if let Some(targets) = &config.log_targets {
             targets
                 .iter()
@@ -92,13 +67,10 @@ pub fn init_logging(config: LoggingConfig) -> LogGuard {
         EnvFilter::new(filter_string)
     });
 
-    // Setup stdout/stderr layer
     let mut layers = Vec::new();
 
-    // Standard timestamp format: YYYY-MM-DD HH:MM:SS
     let time_format = "%Y-%m-%d %H:%M:%S".to_string();
 
-    // Configure the console stdout layer
     let stdout_layer = tracing_subscriber::fmt::layer()
         .with_ansi(config.colorize)
         .with_file(true)
@@ -113,14 +85,12 @@ pub fn init_logging(config: LoggingConfig) -> LogGuard {
 
     layers.push(stdout_layer);
 
-    // Create a file appender if log_dir is specified
     let mut file_guard = None;
 
     if let Some(log_dir) = &config.log_dir {
         let file_name = config.log_file_name.clone();
         let log_dir = PathBuf::from(log_dir);
 
-        // Create log directory if it doesn't exist
         if !log_dir.exists() {
             if let Err(e) = std::fs::create_dir_all(&log_dir) {
                 eprintln!("Failed to create log directory: {}", e);
@@ -134,7 +104,7 @@ pub fn init_logging(config: LoggingConfig) -> LogGuard {
         file_guard = Some(guard);
 
         let file_layer = tracing_subscriber::fmt::layer()
-            .with_ansi(false) // Never use ANSI colors in log files
+            .with_ansi(false)
             .with_file(true)
             .with_line_number(true)
             .with_timer(ChronoUtc::new(time_format))
@@ -149,14 +119,11 @@ pub fn init_logging(config: LoggingConfig) -> LogGuard {
         layers.push(file_layer);
     }
 
-    // Initialize the subscriber with all layers
-    // Use try_init to handle errors gracefully in case another subscriber is already set
     let _ = tracing_subscriber::registry()
         .with(env_filter)
         .with(layers)
         .try_init();
 
-    // Return the guard to keep the file appender worker thread alive
     LogGuard {
         _file_guard: file_guard,
     }