self-meter 0.6.0

A tiny library to measure resource usage of the process it's used in.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129

use std::time::{Duration};
use std::collections::hash_map::Iter;

use {Pid, Meter, Report, Snapshot, ThreadReport};


/// Iterator over thread reports returned by ``Meter::thread_report``
pub struct ThreadReportIter<'a> {
    threads: Iter<'a,Pid, String>,
    last: &'a Snapshot,
    prev: &'a Snapshot,
    centisecs: f32,
}

fn duration_from_ms(ms: u64) -> Duration {
    Duration::new(ms / 1000, ((ms % 1000) * 1000_000) as u32)
}


impl Meter {
    /// Get report of the last scan interval
    ///
    /// We need at least two scans to measure CPU usage, so this method
    /// returns None if less than two scans were done ever in the past.
    pub fn report(&self) -> Option<Report> {
        if self.snapshots.len() < 2 {
            return None;
        }
        let n = self.snapshots.len();
        let last = &self.snapshots[n-1];
        let prev = &self.snapshots[n-2];
        let lpro = &last.process;
        let ppro = &prev.process;
        let centisecs = (last.uptime - prev.uptime) as f32;
        let secs = centisecs / 100.0;
        let mut cpu_usage = 100.0 * (1.0 -
                (last.idle_time - prev.idle_time) as f32 /
                (centisecs * self.num_cpus as f32));
        if cpu_usage < 0. {  // sometimes we get inaccuracy
            cpu_usage = 0.;
        }
        Some(Report {
            timestamp: last.timestamp,
            duration: last.instant - prev.instant,
            start_time: self.start_time,
            system_uptime: duration_from_ms(last.uptime * 10),  // centisecs
            global_cpu_usage: cpu_usage,
            process_cpu_usage: 100.0 *
                (lpro.user_time + lpro.system_time -
                 (ppro.user_time + ppro.system_time)) as f32 / centisecs,
            gross_cpu_usage: 100.0 *
                ((lpro.user_time  + lpro.system_time +
                  lpro.child_user_time + lpro.child_system_time) -
                 (ppro.user_time + ppro.system_time +
                  ppro.child_user_time + ppro.child_system_time)) as f32 /
                centisecs,
            memory_rss: last.memory_rss,
            memory_virtual: last.memory_virtual,
            memory_swap: last.memory_swap,
            memory_rss_peak: self.memory_rss_peak,
            memory_virtual_peak: last.memory_virtual_peak,
            memory_swap_peak: self.memory_swap_peak,
            disk_read: (last.read_disk_bytes - prev.read_disk_bytes) as f32
                / secs,
            disk_write: (last.write_disk_bytes - prev.write_disk_bytes) as f32
                / secs,
            disk_cancelled: (last.write_cancelled_bytes -
                             prev.write_cancelled_bytes) as f32 / secs,
            io_read: (last.read_bytes - prev.read_bytes) as f32 / secs,
            io_write: (last.write_bytes - prev.write_bytes) as f32 / secs,
            io_read_ops: (last.read_ops - prev.read_ops) as f32 / secs,
            io_write_ops: (last.write_ops - prev.write_ops) as f32 / secs,
        })
    }
    /// Returns iterator over reports for threads
    ///
    /// Note: each thread must be registered with `Meter::track_thread` or
    /// `Meter::track_current_thread` to be tracked here.
    ///
    /// We need at least two scans to measure CPU usage, so this method
    /// returns None if less than two scans were done ever in the past.
    pub fn thread_report(&self) -> Option<ThreadReportIter> {
        if self.snapshots.len() < 2 {
            return None;
        }
        let n = self.snapshots.len();
        let last = &self.snapshots[n-1];
        let prev = &self.snapshots[n-2];
        let centisecs = (last.uptime - prev.uptime) as f32;
        Some(ThreadReportIter {
            threads: self.thread_names.iter(),
            last: last,
            prev: prev,
            centisecs: centisecs,
        })
    }
}

impl<'a> Iterator for ThreadReportIter<'a> {
    type Item = (&'a str, ThreadReport);
    fn next(&mut self) -> Option<(&'a str, ThreadReport)> {
        while let Some((&pid, name)) = self.threads.next() {
            let lth = if let Some(thread) = self.last.threads.get(&pid) {
                thread
            } else {
                continue;  // not enough stats for a thread yet
            };
            let pth = if let Some(thread) = self.prev.threads.get(&pid) {
                thread
            } else {
                continue;  // not enough stats for a thread yet
            };
            let udelta = lth.user_time - pth.user_time;
            let sdelta = lth.system_time - pth.system_time;
            return Some((&name[..], ThreadReport {
                cpu_usage: 100.0 * (udelta + sdelta) as f32 / self.centisecs,
                system_cpu: 100.0 * sdelta as f32 / self.centisecs,
                user_cpu: 100.0 * udelta as f32 / self.centisecs,
            }))
        }
        None
    }
    fn size_hint(&self) -> (usize, Option<usize>) {
        let (_min, max) = self.threads.size_hint();
        // unfortunately we skip non-scanned threads, so we must assume that
        // minimum size is zero
        return (0, max);
    }
}