// Copyright 2024 RustFS Team // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. #![allow(dead_code)] //! System CPU metrics collector. //! //! Collects CPU metrics including load average, CPU time distribution, //! and process-level CPU usage. //! //! This module provides both system-level and process-level CPU metrics, //! with process-level metrics migrated from `rustfs-obs::system`. use crate::metrics::report::PrometheusMetric; use crate::metrics::schema::system_cpu::*; use crate::metrics::schema::system_process::{PROCESS_CPU_USAGE_MD, PROCESS_CPU_UTILIZATION_MD}; use std::borrow::Cow; /// System CPU statistics. #[derive(Debug, Clone, Default)] pub struct CpuStats { /// Average CPU idle time (percentage, 0-100) pub avg_idle: f64, /// Average CPU I/O wait time (percentage, 0-100) pub avg_iowait: f64, /// CPU load average over 1 minute pub load_avg: f64, /// CPU load average as percentage pub load_avg_perc: f64, /// CPU nice time (percentage, 0-100) pub nice: f64, /// CPU steal time (percentage, 0-100) pub steal: f64, /// CPU system time (percentage, 0-100) pub system: f64, /// CPU user time (percentage, 0-100) pub user: f64, } /// Process CPU statistics. /// /// Contains CPU usage metrics for a specific process. #[derive(Debug, Clone, Default)] pub struct ProcessCpuStats { /// CPU usage percentage (0-100) pub usage: f64, /// CPU utilization percentage (considering multiple cores, can exceed 100) pub utilization: f64, } /// Collects CPU metrics from the given stats. /// /// Uses the metric descriptors from `metrics_type::system_cpu` module. /// Returns a vector of Prometheus metrics for CPU statistics. pub fn collect_cpu_metrics(stats: &CpuStats) -> Vec { vec![ PrometheusMetric::from_descriptor(&SYS_CPU_AVG_IDLE_MD, stats.avg_idle), PrometheusMetric::from_descriptor(&SYS_CPU_AVG_IOWAIT_MD, stats.avg_iowait), PrometheusMetric::from_descriptor(&SYS_CPU_LOAD_MD, stats.load_avg), PrometheusMetric::from_descriptor(&SYS_CPU_LOAD_PERC_MD, stats.load_avg_perc), PrometheusMetric::from_descriptor(&SYS_CPU_NICE_MD, stats.nice), PrometheusMetric::from_descriptor(&SYS_CPU_STEAL_MD, stats.steal), PrometheusMetric::from_descriptor(&SYS_CPU_SYSTEM_MD, stats.system), PrometheusMetric::from_descriptor(&SYS_CPU_USER_MD, stats.user), ] } /// Collects process CPU metrics from the given stats. /// /// Uses the metric descriptors from `metrics_type::system_process` module. /// Returns a vector of Prometheus metrics for process CPU statistics. /// /// # Arguments /// /// * `stats` - Process CPU statistics /// * `labels` - Optional additional labels (e.g., process attributes) pub fn collect_process_cpu_metrics( stats: &ProcessCpuStats, labels: Option<&[(&'static str, Cow<'static, str>)]>, ) -> Vec { let mut usage_metric = PrometheusMetric::from_descriptor(&PROCESS_CPU_USAGE_MD, stats.usage); let mut utilization_metric = PrometheusMetric::from_descriptor(&PROCESS_CPU_UTILIZATION_MD, stats.utilization); if let Some(l) = labels { usage_metric.labels.extend(l.iter().map(|(k, v)| (*k, v.clone()))); utilization_metric.labels.extend(l.iter().map(|(k, v)| (*k, v.clone()))); } vec![usage_metric, utilization_metric] } #[cfg(test)] mod tests { use super::*; use crate::metrics::report::report_metrics; #[test] fn test_collect_cpu_metrics() { let stats = CpuStats { avg_idle: 75.5, avg_iowait: 2.3, load_avg: 1.5, load_avg_perc: 37.5, nice: 0.5, steal: 0.1, system: 10.0, user: 15.0, }; let metrics = collect_cpu_metrics(&stats); report_metrics(&metrics); assert_eq!(metrics.len(), 8); // Verify that metric names are properly generated from descriptors assert!(metrics.iter().all(|m| m.name.starts_with("rustfs_system_cpu_"))); } #[test] fn test_collect_cpu_metrics_default() { let stats = CpuStats::default(); let metrics = collect_cpu_metrics(&stats); assert_eq!(metrics.len(), 8); for metric in &metrics { assert_eq!(metric.value, 0.0); assert!(metric.labels.is_empty()); } } #[test] fn test_collect_process_cpu_metrics() { let stats = ProcessCpuStats { usage: 45.5, utilization: 182.0, // 4 cores at ~45% each }; let metrics = collect_process_cpu_metrics(&stats, None); report_metrics(&metrics); assert_eq!(metrics.len(), 2); // Verify usage metric let usage_metric = metrics.iter().find(|m| m.name.contains("cpu_usage")); assert!(usage_metric.is_some()); assert_eq!(usage_metric.map(|m| m.value), Some(45.5)); // Verify utilization metric let util_metric = metrics.iter().find(|m| m.name.contains("cpu_utilization")); assert!(util_metric.is_some()); assert_eq!(util_metric.map(|m| m.value), Some(182.0)); } #[test] fn test_collect_process_cpu_metrics_with_labels() { let stats = ProcessCpuStats { usage: 25.0, utilization: 100.0, }; let labels = vec![ ("process_pid", Cow::Borrowed("12345")), ("process_executable_name", Cow::Borrowed("rustfs")), ]; let metrics = collect_process_cpu_metrics(&stats, Some(&labels)); assert_eq!(metrics.len(), 2); // All metrics should have the labels for metric in &metrics { assert_eq!(metric.labels.len(), 2); } } }