perf-monitor-rs

# Cargo.toml
[dependencies]
perf_monitor = "0.2"

一个为应用程序监控性能而设计的工具包。它是

• 跨平台： perf-monitor 支持 Windows、macOS、Linux、iOS 和 Android。
• 安全包装： perf-monitor 在内部使用许多系统 C 接口，但对外提供安全的包装 API。
• 高效： perf-monitor 是对底层 API 的轻量级包装，注意不要引入不必要的开销，在许多同质 API 中选择最轻量级的方法。

特性

• CPU
  • 当前进程的使用情况
  • 其他进程的使用情况（即将推出）
  • 当前进程中的任何线程的使用情况
  • 逻辑核心数量
• 内存
  • 一个全局分配器，跟踪 Rust 分配
  • 当前进程的进程内存信息（Windows 和 MacOS，Linux 即将推出）。
• IO
  • 磁盘 IO
  • 网络 IO（即将推出）
• FD
  • FD 数量

示例

一个简单的活动监视器

    use perf_monitor::cpu::{ThreadStat, ProcessStat, processor_numbers};
    use perf_monitor::fd::fd_count_cur;
    use perf_monitor::io::get_process_io_stats;
    use perf_monitor::mem::get_process_memory_info;

    // cpu
    let core_num = processor_numbers().unwrap();
    let mut stat_p = ProcessStat::cur().unwrap();
    let mut stat_t = ThreadStat::cur().unwrap();

    let _ = (0..1_000).into_iter().sum::<i128>();

    let usage_p = stat_p.cpu().unwrap() * 100f64;
    let usage_t = stat_t.cpu().unwrap() * 100f64;

    println!("[CPU] core Number: {}, process usage: {:.2}%, current thread usage: {:.2}%", core_num, usage_p, usage_t);

    // mem
    let mem_info = get_process_memory_info().unwrap();
    println!("[Memory] memory used: {} bytes, virtural memory used: {} bytes ", mem_info.resident_set_size, mem_info.virtual_memory_size);

    // fd
    let fd_num = fd_count_cur().unwrap();
    println!("[FD] fd number: {}", fd_num);

    // io
    let io_stat = get_process_io_stats().unwrap();   
    println!("[IO] io-in: {} bytes, io-out: {} bytes", io_stat.read_bytes, io_stat.write_bytes);

上面的代码应该有以下输出

[CPU] core Number: 12, process usage: 502.16%, current thread usage: 2.91%
[Memory] memory used: 1073152 bytes, virtural memory used: 4405747712 bytes 
[FD] fd number: 7
[IO] io-in: 0 bytes, io-out: 32768 bytes

有关详细信息，请参阅 示例。

性能

我们关注获取性能信息时的开销。我们试图使用最有效的方法，同时确保 API 的可用性。

例如，CPU 使用率和 FD 数量的成本如下

• MacOS: MacBookPro15,1; 6-Core Intel Core i7; 2.6GHz; 16GB
• Windows: Windows10; Intel Core i3-2310M; 2.10GHz; 64位; 4GB
• Android: Pixel 2; android 10

支持的平台

请参阅每个模块的文档，了解用法和更多细节。

Rust 版本

编译文档需要使用 nightly 版本，其他版本应该都能在 stable 和 nightly 版本下运行。

cargo build

cargo +nightly doc 

cargo +nightly test
cargo test --lib

贡献

欢迎贡献力量！

打开一个 issue 或创建一个 PR 来报告错误、添加新功能或改进文档和测试。如果您是新的贡献者，请查看此页面以获取帮助。

为什么选择 perf-monitor-rs？

有一些crate可以进行类似的工作，例如spork、procfs和sysinfo。

我们的应用程序需要在运行时监控自身以帮助我们找出性能问题。例如，当CPU使用率异常升高时，我们希望找出导致这一现象的线程。

然而，上述crate中没有哪一个能满足我们的需求。

• spork除了调用线程之外，无法获取其他线程的信息。只能处理内存和CPU信息，并且已经停止更新多年。
• procfs看起来足够好，但现在只支持Linux平台。在我们开发perf_monitor_rs的早期阶段，无法获取线程信息。
• sysinfo支持我们需要的所有平台，但我们认为它的接口不够优雅，因为每次调用之前都需要显式刷新，否则会检索旧值，而且您无法从返回值中区分。更重要的是，它缺少一些功能，如fd、CPU使用率。

如果您正在构建跨平台应用程序并面临相同的问题，我们希望perf_monitor_rs能成为您的首选。

许可证

perf-monitor是在MIT许可证下提供的。请参阅LICENSE。