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
// Copyright 2019 The Fuchsia Authors
//
// Licensed under a BSD-style license <LICENSE-BSD>, Apache License, Version 2.0
// <LICENSE-APACHE or https://www.apache.org/licenses/LICENSE-2.0>, or the MIT
// license <LICENSE-MIT or https://opensource.org/licenses/MIT>, at your option.
// This file may not be copied, modified, or distributed except according to
// those terms.
use {
crate::protocol::request::{Event, InstallSource},
anyhow::Error,
std::{cell::RefCell, rc::Rc, time::Duration},
};
#[cfg(test)]
mod mock;
#[cfg(test)]
pub use mock::MockMetricsReporter;
mod stub;
pub use stub::StubMetricsReporter;
/// The list of metrics that can be reported.
#[derive(Debug, Eq, PartialEq)]
pub enum Metrics {
/// Elapsed time from sending an update check to getting a response from Omaha, with a bool to
/// hold whether that was a success or a failure.
UpdateCheckResponseTime {
response_time: Duration,
successful: bool,
},
/// Elapsed time from the previous update check to the current update check.
UpdateCheckInterval {
interval: Duration,
clock: ClockType,
install_source: InstallSource,
},
/// Elapsed time from starting an update to having successfully applied it.
SuccessfulUpdateDuration(Duration),
/// Elapsed time from first seeing an update to having successfully applied it.
SuccessfulUpdateFromFirstSeen(Duration),
/// Elapsed time from starting an update to encountering a failure.
FailedUpdateDuration(Duration),
/// Why an update check failed (network, omaha, proxy, etc).
UpdateCheckFailureReason(UpdateCheckFailureReason),
/// Number of omaha request attempts until a response within a single update check attempt,
/// with a bool to hold whether that was a success or a failure.
RequestsPerCheck { count: u64, successful: bool },
/// Number of update check attempts to get an update check to succeed.
AttemptsToSuccessfulCheck(u64),
/// Number of install attempts to get an update to succeed.
AttemptsToSuccessfulInstall { count: u64, successful: bool },
/// Elapsed time from having finished applying the update to when finally
/// running that software, it is sent after the reboot (and includes the
/// rebooting time).
WaitedForRebootDuration(Duration),
/// Record that an Omaha event report was lost.
OmahaEventLost(Event),
}
#[derive(Debug, Eq, PartialEq)]
pub enum UpdateCheckFailureReason {
Omaha = 0,
Network = 1,
Proxy = 2,
Configuration = 3,
Internal = 4,
}
#[derive(Debug, Eq, PartialEq)]
pub enum ClockType {
Monotonic,
Wall,
}
pub trait MetricsReporter {
fn report_metrics(&mut self, metrics: Metrics) -> Result<(), Error>;
}
impl<T> MetricsReporter for &mut T
where
T: MetricsReporter,
{
fn report_metrics(&mut self, metrics: Metrics) -> Result<(), Error> {
(*self).report_metrics(metrics)
}
}
impl<T> MetricsReporter for Rc<RefCell<T>>
where
T: MetricsReporter,
{
fn report_metrics(&mut self, metrics: Metrics) -> Result<(), Error> {
self.borrow_mut().report_metrics(metrics)
}
}