44 个版本

0.7.12 2024年8月8日
0.7.11 2023年11月9日
0.7.10 2023年9月14日
0.7.8 2023年6月6日
0.3.9 2021年12月29日

#8 in #retrieving

Download history 9/week @ 2024-05-20 7/week @ 2024-05-27 6/week @ 2024-06-03 5/week @ 2024-06-10 2/week @ 2024-06-24 2/week @ 2024-07-01 1/week @ 2024-07-15 24/week @ 2024-07-29 110/week @ 2024-08-05

135 每月下载量
precord 中使用

Apache-2.0 OR MIT

1.5MB
40K SLoC

precord

crates.io docs.rs Minimum rustc version

用于记录进程或系统性能数据的命令行工具。

安装

使用 cargo 安装

cargo install precord

使用方法

precord -p 1203 -o result.svg

选项

precord -h
  • -c / --category - 记录的分类,可能的值
    • cpu - 进程的 CPU 使用率
    • mem - 进程的内存使用率
    • alloc - 进程的分配
    • gpu - 进程的 GPU 使用率
    • vram - 进程的 VRAM 使用率
    • fps - 进程的帧率
    • net_in/net_out - 进程的网络接收/发送
    • disk_read/disk_write - 进程的磁盘读/写
    • kobject - 进程的内核对象计数
    • thread - 进程的线程计数
    • sys_cpu - 系统的 CPU 使用率
    • sys_cpu_freq - 系统的 CPU 频率
    • sys_cpu_temp - 系统的 CPU 温度
    • sys_gpu - 系统的 GPU 使用率
    • sys_power - 系统的功耗
    • sys_npu_power - npu 的功耗
  • -p / --process - 进程的 ID
  • --name - 进程的名称
  • -o / --output - 指定输出文件,可能的扩展名
    • .svg
    • .html
    • .json
    • .csv
  • -i / --interval - 记录的间隔
  • -n - 记录的次数
  • --time - 记录的时间限制,例如 --time 1h30m59s
  • -r / --recurse-children - 递归子进程的标志
  • --skip - 跳过的记录数
  • --gpu-calc - Gpu计算,可能的值
    • 最大值
    • 总和
  • --interactive - 交互模式
  • --auto-save - 自动保存间隔

命令模式

在录制时输入 : 将进入命令模式,按 Esc 返回录制。支持的命令有

  • w - 写入(保存)输出
  • q - 退出
  • wq - wq 的组合
  • time - 修改录制时间限制

子命令

  • thread-list <PID> - 列出线程和CPU使用情况

precord-core

用于检索进程和系统性能数据的库。

use precord_core::{Features, GpuCalculation, System};
use std::thread;
use std::time::Duration;

fn main() {
  let mut system = System::new(Features::PROCESS || Features::GPU, [1203]).unwrap();
  thread::sleep(Duration::from_secs(1));
  system.update();

  if let Some(cpu_usage) = system.process_cpu_usage(1203) {
    println!("Process({}) %CPU: {:.2}%", 1203, cpu_usage)
  }
  
  #[cfg(target_os = "windows")]
  if let Some(gpu_usage) = system.process_gpu_usage(1203, GpuCalculation::Max) {
    println!("Process({}) %GPU: {:.2}%", 1203, gpu_usage)
  }
  
  if let Some(sys_gpu_usage) = system.system_gpu_usage(GpuCalculation::Max) {
    println!("System %GPU: {:.2}%", sys_gpu_usage);
  }
}

支持的平台

macOS Windows Linux
cpu
mem
alloc
gpu
vram
fps
net_in/net_out
disk_read/disk_write
kobject
thread
sys_cpu
sys_cpu_freq
sys_cpu_temp
sys_gpu
sys_power
sys_npu_power

权限

macOS Windows Linux
cpu
mem
alloc
gpu
vram
fps 管理员 + get-task-allow 管理员
net_in/net_out 管理员
disk_read/disk_write
kobject
thread
sys_cpu
sys_cpu_freq 管理员
sys_cpu_temp
sys_gpu
sys_power
sys_npu_power 管理员
系统进程
(WindowServer, dwm.exe等)
管理员 管理员

待办事项

依赖项

~1–40MB
~606K SLoC