blob: 614cf8672cf48e31c0571f05c7e41bcd4e5a1f10 [file] [log] [blame]
Thieu Le3426c8f2012-01-11 17:35:11 -08001// Copyright (c) 2012 The Chromium OS Authors. All rights reserved.
Thieu Le48e6d6d2011-12-06 00:40:27 +00002// Use of this source code is governed by a BSD-style license that can be
3// found in the LICENSE file.
4
Wade Guthrie60a37062013-04-02 11:39:09 -07005#ifndef SHILL_METRICS_H_
6#define SHILL_METRICS_H_
Thieu Le48e6d6d2011-12-06 00:40:27 +00007
8#include <list>
9
Thieu Le48e6d6d2011-12-06 00:40:27 +000010#include <base/memory/scoped_vector.h>
11#include <metrics/metrics_library.h>
12#include <metrics/timer.h>
13
Thieu Le6c1e3bb2013-02-06 15:20:35 -080014#include "shill/event_dispatcher.h"
Wade Guthried4977f22012-08-22 12:37:54 -070015#include "shill/ieee80211.h"
Thieu Le85e050b2012-03-13 15:04:38 -070016#include "shill/portal_detector.h"
Thieu Leb84ba342012-03-02 15:15:19 -080017#include "shill/power_manager.h"
Thieu Le48e6d6d2011-12-06 00:40:27 +000018#include "shill/refptr_types.h"
19#include "shill/service.h"
20
21namespace shill {
22
Gaurav Shah6d2c72d2012-10-16 16:30:44 -070023class WiFiMainTest;
Thieu Le48e6d6d2011-12-06 00:40:27 +000024class WiFiService;
25
26class Metrics {
27 public:
28 enum WiFiChannel {
29 kWiFiChannelUndef = 0,
30 kWiFiChannel2412 = 1,
31 kWiFiChannel2417 = 2,
32 kWiFiChannel2422 = 3,
33 kWiFiChannel2427 = 4,
34 kWiFiChannel2432 = 5,
35 kWiFiChannel2437 = 6,
36 kWiFiChannel2442 = 7,
37 kWiFiChannel2447 = 8,
38 kWiFiChannel2452 = 9,
39 kWiFiChannel2457 = 10,
40 kWiFiChannel2462 = 11,
41 kWiFiChannel2467 = 12,
42 kWiFiChannel2472 = 13,
43 kWiFiChannel2484 = 14,
44
45 kWiFiChannel5180 = 15,
46 kWiFiChannel5200 = 16,
47 kWiFiChannel5220 = 17,
48 kWiFiChannel5240 = 18,
49 kWiFiChannel5260 = 19,
50 kWiFiChannel5280 = 20,
51 kWiFiChannel5300 = 21,
52 kWiFiChannel5320 = 22,
53
54 kWiFiChannel5500 = 23,
55 kWiFiChannel5520 = 24,
56 kWiFiChannel5540 = 25,
57 kWiFiChannel5560 = 26,
58 kWiFiChannel5580 = 27,
59 kWiFiChannel5600 = 28,
60 kWiFiChannel5620 = 29,
61 kWiFiChannel5640 = 30,
62 kWiFiChannel5660 = 31,
63 kWiFiChannel5680 = 32,
64 kWiFiChannel5700 = 33,
65
66 kWiFiChannel5745 = 34,
67 kWiFiChannel5765 = 35,
68 kWiFiChannel5785 = 36,
69 kWiFiChannel5805 = 37,
70 kWiFiChannel5825 = 38,
71
72 kWiFiChannel5170 = 39,
73 kWiFiChannel5190 = 40,
74 kWiFiChannel5210 = 41,
75 kWiFiChannel5230 = 42,
76
77 /* NB: ignore old 11b bands 2312..2372 and 2512..2532 */
78 /* NB: ignore regulated bands 4920..4980 and 5020..5160 */
79 kWiFiChannelMax
80 };
81
Thieu Lead1ec2c2012-01-05 23:39:48 +000082 enum WiFiNetworkPhyMode {
83 kWiFiNetworkPhyModeUndef = 0, // Unknown/undefined
84 kWiFiNetworkPhyMode11a = 1, // 802.11a
85 kWiFiNetworkPhyMode11b = 2, // 802.11b
86 kWiFiNetworkPhyMode11g = 3, // 802.11g
87 kWiFiNetworkPhyMode11n = 4, // 802.11n
88 kWiFiNetworkPhyModeHalf = 5, // PSB Half-width
89 kWiFiNetworkPhyModeQuarter = 6, // PSB Quarter-width
90 kWiFiNetworkPhyModeTurbo = 7, // Atheros Turbo mode
91
92 kWiFiNetworkPhyModeMax
93 };
94
Paul Stewart21f40962013-03-01 14:27:28 -080095 enum EapOuterProtocol {
96 kEapOuterProtocolUnknown = 0,
97 kEapOuterProtocolLeap = 1,
98 kEapOuterProtocolPeap = 2,
99 kEapOuterProtocolTls = 3,
100 kEapOuterProtocolTtls = 4,
101
102 kEapOuterProtocolMax
103 };
104
105 enum EapInnerProtocol {
106 kEapInnerProtocolUnknown = 0,
107 kEapInnerProtocolNone = 1,
108 kEapInnerProtocolPeapMd5 = 2,
109 kEapInnerProtocolPeapMschapv2 = 3,
110 kEapInnerProtocolTtlsEapMd5 = 4,
111 kEapInnerProtocolTtlsEapMschapv2 = 5,
112 kEapInnerProtocolTtlsMschapv2 = 6,
113 kEapInnerProtocolTtlsMschap = 7,
114 kEapInnerProtocolTtlsPap = 8,
115 kEapInnerProtocolTtlsChap = 9,
116
117 kEapInnerProtocolMax
118 };
119
Thieu Lead1ec2c2012-01-05 23:39:48 +0000120 enum WiFiSecurity {
121 kWiFiSecurityUnknown = 0,
122 kWiFiSecurityNone = 1,
123 kWiFiSecurityWep = 2,
124 kWiFiSecurityWpa = 3,
125 kWiFiSecurityRsn = 4,
126 kWiFiSecurity8021x = 5,
127 kWiFiSecurityPsk = 6,
128
129 kWiFiSecurityMax
130 };
131
Thieu Le85e050b2012-03-13 15:04:38 -0700132 enum PortalResult {
133 kPortalResultSuccess = 0,
134 kPortalResultDNSFailure = 1,
135 kPortalResultDNSTimeout = 2,
136 kPortalResultConnectionFailure = 3,
137 kPortalResultConnectionTimeout = 4,
138 kPortalResultHTTPFailure = 5,
139 kPortalResultHTTPTimeout = 6,
140 kPortalResultContentFailure = 7,
141 kPortalResultContentTimeout = 8,
142 kPortalResultUnknown = 9,
143
144 kPortalResultMax
145 };
146
Paul Stewartff845fc2012-08-07 07:28:44 -0700147 enum LinkMonitorFailure {
148 kLinkMonitorMacAddressNotFound = 0,
149 kLinkMonitorClientStartFailure = 1,
150 kLinkMonitorTransmitFailure = 2,
151 kLinkMonitorFailureThresholdReached = 3,
152
153 kLinkMonitorFailureMax
154 };
155
Wade Guthried4977f22012-08-22 12:37:54 -0700156 enum WiFiStatusType {
157 kStatusCodeTypeByAp,
158 kStatusCodeTypeByClient,
159 kStatusCodeTypeByUser,
160 kStatusCodeTypeConsideredDead,
161 kStatusCodeTypeMax
162 };
163
164 enum WiFiDisconnectByWhom {
165 kDisconnectedByAp,
166 kDisconnectedNotByAp
167 };
168
Paul Stewart85aea152013-01-22 09:31:56 -0800169 enum ServiceFixupProfileType {
170 kMetricServiceFixupDefaultProfile,
171 kMetricServiceFixupUserProfile,
172 kMetricServiceFixupMax
173 };
174
Arman Uguray6d528f12012-09-13 13:44:55 -0700175 enum TerminationActionResult {
Arman Ugurayab22c162012-10-08 19:08:38 -0700176 kTerminationActionResultSuccess,
177 kTerminationActionResultFailure,
Arman Uguray6d528f12012-09-13 13:44:55 -0700178 kTerminationActionResultMax
179 };
180
Arman Ugurayab22c162012-10-08 19:08:38 -0700181 enum TerminationActionReason {
182 kTerminationActionReasonSuspend,
183 kTerminationActionReasonTerminate
184 };
185
Thieu Le26fc01b2013-01-28 12:08:48 -0800186 enum CellularDropTechnology {
187 kCellularDropTechnology1Xrtt = 0,
188 kCellularDropTechnologyEdge = 1,
189 kCellularDropTechnologyEvdo = 2,
190 kCellularDropTechnologyGprs = 3,
191 kCellularDropTechnologyGsm = 4,
192 kCellularDropTechnologyHspa = 5,
193 kCellularDropTechnologyHspaPlus = 6,
194 kCellularDropTechnologyLte = 7,
195 kCellularDropTechnologyUmts = 8,
196 kCellularDropTechnologyUnknown = 9,
197 kCellularDropTechnologyMax
198 };
199
Thieu Le5133b712013-02-19 14:47:21 -0800200 enum CorruptedProfile {
201 kCorruptedProfile = 1,
202 kCorruptedProfileMax
203 };
204
Paul Stewart91a43cb2013-03-02 21:34:15 -0800205 enum VpnDriver {
206 kVpnDriverOpenVpn = 0,
207 kVpnDriverL2tpIpsec = 1,
208 kVpnDriverMax
209 };
210
211 enum VpnRemoteAuthenticationType {
212 kVpnRemoteAuthenticationTypeOpenVpnDefault = 0,
213 kVpnRemoteAuthenticationTypeOpenVpnCertificate = 1,
214 kVpnRemoteAuthenticationTypeL2tpIpsecDefault = 2,
215 kVpnRemoteAuthenticationTypeL2tpIpsecCertificate = 3,
216 kVpnRemoteAuthenticationTypeL2tpIpsecPsk = 4,
217 kVpnRemoteAuthenticationTypeMax
218 };
219
220 enum VpnUserAuthenticationType {
221 kVpnUserAuthenticationTypeOpenVpnNone = 0,
222 kVpnUserAuthenticationTypeOpenVpnCertificate = 1,
223 kVpnUserAuthenticationTypeOpenVpnUsernamePassword = 2,
224 kVpnUserAuthenticationTypeOpenVpnUsernamePasswordOtp = 3,
225 kVpnUserAuthenticationTypeL2tpIpsecNone = 4,
226 kVpnUserAuthenticationTypeL2tpIpsecCertificate = 5,
227 kVpnUserAuthenticationTypeL2tpIpsecUsernamePassword = 6,
228 kVpnUserAuthenticationTypeMax
229 };
230
Thieu Le67370f62012-02-14 23:01:42 +0000231 static const char kMetricDisconnect[];
232 static const int kMetricDisconnectMax;
233 static const int kMetricDisconnectMin;
234 static const int kMetricDisconnectNumBuckets;
Thieu Le48e6d6d2011-12-06 00:40:27 +0000235 static const char kMetricNetworkChannel[];
236 static const int kMetricNetworkChannelMax;
Paul Stewart21f40962013-03-01 14:27:28 -0800237 static const char kMetricNetworkEapInnerProtocol[];
238 static const int kMetricNetworkEapInnerProtocolMax;
239 static const char kMetricNetworkEapOuterProtocol[];
240 static const int kMetricNetworkEapOuterProtocolMax;
Thieu Lead1ec2c2012-01-05 23:39:48 +0000241 static const char kMetricNetworkPhyMode[];
242 static const int kMetricNetworkPhyModeMax;
243 static const char kMetricNetworkSecurity[];
244 static const int kMetricNetworkSecurityMax;
Thieu Le48e6d6d2011-12-06 00:40:27 +0000245 static const char kMetricNetworkServiceErrors[];
246 static const int kMetricNetworkServiceErrorsMax;
Paul Stewart23b393a2012-09-25 21:21:06 -0700247 static const char kMetricNetworkSignalStrength[];
248 static const int kMetricNetworkSignalStrengthMin;
249 static const int kMetricNetworkSignalStrengthMax;
250 static const int kMetricNetworkSignalStrengthNumBuckets;
Thieu Lea20cbc22012-01-09 22:01:43 +0000251 static const char kMetricTimeOnlineSeconds[];
252 static const int kMetricTimeOnlineSecondsMax;
253 static const int kMetricTimeOnlineSecondsMin;
254 static const int kMetricTimeOnlineSecondsNumBuckets;
Thieu Leb84ba342012-03-02 15:15:19 -0800255 static const char kMetricTimeResumeToReadyMilliseconds[];
Thieu Le48e6d6d2011-12-06 00:40:27 +0000256 static const char kMetricTimeToConfigMilliseconds[];
Thieu Lecdb5a212013-01-25 11:17:18 -0800257 static const char kMetricTimeToConnectMilliseconds[];
258 static const int kMetricTimeToConnectMillisecondsMax;
259 static const int kMetricTimeToConnectMillisecondsMin;
260 static const int kMetricTimeToConnectMillisecondsNumBuckets;
Thieu Lea20cbc22012-01-09 22:01:43 +0000261 static const char kMetricTimeToDropSeconds[];
262 static const int kMetricTimeToDropSecondsMax;
263 static const int kMetricTimeToDropSecondsMin;
Thieu Lea2519bf2013-01-23 16:51:54 -0800264 static const char kMetricTimeToDisableMilliseconds[];
265 static const int kMetricTimeToDisableMillisecondsMax;
266 static const int kMetricTimeToDisableMillisecondsMin;
267 static const int kMetricTimeToDisableMillisecondsNumBuckets;
Thieu Lece4483e2013-01-23 15:12:03 -0800268 static const char kMetricTimeToEnableMilliseconds[];
269 static const int kMetricTimeToEnableMillisecondsMax;
270 static const int kMetricTimeToEnableMillisecondsMin;
271 static const int kMetricTimeToEnableMillisecondsNumBuckets;
Thieu Lec8078a62013-01-22 18:01:12 -0800272 static const char kMetricTimeToInitializeMilliseconds[];
Thieu Lec8078a62013-01-22 18:01:12 -0800273 static const int kMetricTimeToInitializeMillisecondsMax;
Thieu Lece4483e2013-01-23 15:12:03 -0800274 static const int kMetricTimeToInitializeMillisecondsMin;
Thieu Lec8078a62013-01-22 18:01:12 -0800275 static const int kMetricTimeToInitializeMillisecondsNumBuckets;
Thieu Le48e6d6d2011-12-06 00:40:27 +0000276 static const char kMetricTimeToJoinMilliseconds[];
277 static const char kMetricTimeToOnlineMilliseconds[];
278 static const char kMetricTimeToPortalMilliseconds[];
Thieu Le18c11072013-01-28 17:21:37 -0800279 static const char kMetricTimeToScanMilliseconds[];
280 static const int kMetricTimeToScanMillisecondsMax;
281 static const int kMetricTimeToScanMillisecondsMin;
282 static const int kMetricTimeToScanMillisecondsNumBuckets;
Thieu Lea20cbc22012-01-09 22:01:43 +0000283 static const int kTimerHistogramMillisecondsMax;
284 static const int kTimerHistogramMillisecondsMin;
Thieu Le48e6d6d2011-12-06 00:40:27 +0000285 static const int kTimerHistogramNumBuckets;
286
Thieu Le85e050b2012-03-13 15:04:38 -0700287 // The number of portal detections attempted for each pass.
288 // This includes both failure/timeout attempts and successful attempt
289 // (if any).
290 static const char kMetricPortalAttempts[];
291 static const int kMetricPortalAttemptsMax;
292 static const int kMetricPortalAttemptsMin;
293 static const int kMetricPortalAttemptsNumBuckets;
294
295 // The total number of portal detections attempted between the Connected
296 // state and the Online state. This includes both failure/timeout attempts
297 // and the final successful attempt.
298 static const char kMetricPortalAttemptsToOnline[];
299 static const int kMetricPortalAttemptsToOnlineMax;
300 static const int kMetricPortalAttemptsToOnlineMin;
301 static const int kMetricPortalAttemptsToOnlineNumBuckets;
302
303 // The result of the portal detection.
304 static const char kMetricPortalResult[];
305
Wade Guthrie60a37062013-04-02 11:39:09 -0700306 // Wifi connection frequencies.
307 static const char kMetricFrequenciesConnectedEver[];
308 static const int kMetricFrequenciesConnectedMax;
309 static const int kMetricFrequenciesConnectedMin;
310 static const int kMetricFrequenciesConnectedNumBuckets;
311
Thieu Leb84ba342012-03-02 15:15:19 -0800312 static const char kMetricPowerManagerKey[];
313
Paul Stewartff845fc2012-08-07 07:28:44 -0700314 // LinkMonitor statistics.
315 static const char kMetricLinkMonitorFailure[];
316 static const char kMetricLinkMonitorResponseTimeSample[];
Paul Stewartf1961f82012-09-11 20:45:39 -0700317 static const int kMetricLinkMonitorResponseTimeSampleMin;
318 static const int kMetricLinkMonitorResponseTimeSampleMax;
Paul Stewartff845fc2012-08-07 07:28:44 -0700319 static const int kMetricLinkMonitorResponseTimeSampleNumBuckets;
Paul Stewart0443aa52012-08-09 10:43:50 -0700320 static const char kMetricLinkMonitorSecondsToFailure[];
Paul Stewartf1961f82012-09-11 20:45:39 -0700321 static const int kMetricLinkMonitorSecondsToFailureMin;
322 static const int kMetricLinkMonitorSecondsToFailureMax;
Paul Stewart0443aa52012-08-09 10:43:50 -0700323 static const int kMetricLinkMonitorSecondsToFailureNumBuckets;
324 static const char kMetricLinkMonitorBroadcastErrorsAtFailure[];
325 static const char kMetricLinkMonitorUnicastErrorsAtFailure[];
Paul Stewartf1961f82012-09-11 20:45:39 -0700326 static const int kMetricLinkMonitorErrorCountMin;
327 static const int kMetricLinkMonitorErrorCountMax;
Paul Stewart0443aa52012-08-09 10:43:50 -0700328 static const int kMetricLinkMonitorErrorCountNumBuckets;
Paul Stewartff845fc2012-08-07 07:28:44 -0700329
Wade Guthried4977f22012-08-22 12:37:54 -0700330 static const char kMetricLinkClientDisconnectReason[];
331 static const char kMetricLinkApDisconnectReason[];
332 static const char kMetricLinkClientDisconnectType[];
333 static const char kMetricLinkApDisconnectType[];
334
Arman Uguray6d528f12012-09-13 13:44:55 -0700335 // Shill termination action statistics.
Arman Ugurayab22c162012-10-08 19:08:38 -0700336 static const char kMetricTerminationActionTimeOnTerminate[];
337 static const char kMetricTerminationActionResultOnTerminate[];
338 static const char kMetricTerminationActionTimeOnSuspend[];
339 static const char kMetricTerminationActionResultOnSuspend[];
340 static const int kMetricTerminationActionTimeMillisecondsMax;
341 static const int kMetricTerminationActionTimeMillisecondsMin;
Arman Uguray6d528f12012-09-13 13:44:55 -0700342
Paul Stewart85aea152013-01-22 09:31:56 -0800343 // WiFiService Entry Fixup.
344 static const char kMetricServiceFixupEntries[];
345
Thieu Le26fc01b2013-01-28 12:08:48 -0800346 // Cellular specific statistics.
347 static const char kMetricCellularDrop[];
Thieu Le6c1e3bb2013-02-06 15:20:35 -0800348 static const char kMetricCellularDropsPerHour[];
349 static const int kMetricCellularDropsPerHourMax;
350 static const int kMetricCellularDropsPerHourMin;
351 static const int kMetricCellularDropsPerHourNumBuckets;
Thieu Leb7aa5f72013-01-31 15:57:48 -0800352 static const char kMetricCellularFailureReason[];
Thieu Le26fc01b2013-01-28 12:08:48 -0800353 static const char kMetricCellularSignalStrengthBeforeDrop[];
354 static const int kMetricCellularSignalStrengthBeforeDropMax;
355 static const int kMetricCellularSignalStrengthBeforeDropMin;
356 static const int kMetricCellularSignalStrengthBeforeDropNumBuckets;
Thieu Le7cf36b02013-01-30 17:15:56 -0800357 static const char kMetricCellularAutoConnectTries[];
358 static const int kMetricCellularAutoConnectTriesMax;
359 static const int kMetricCellularAutoConnectTriesMin;
360 static const int kMetricCellularAutoConnectTriesNumBuckets;
361 static const char kMetricCellularAutoConnectTotalTime[];
362 static const int kMetricCellularAutoConnectTotalTimeMax;
363 static const int kMetricCellularAutoConnectTotalTimeMin;
364 static const int kMetricCellularAutoConnectTotalTimeNumBuckets;
Thieu Le26fc01b2013-01-28 12:08:48 -0800365
Thieu Le5133b712013-02-19 14:47:21 -0800366 // Profile statistics.
367 static const char kMetricCorruptedProfile[];
368
Paul Stewart91a43cb2013-03-02 21:34:15 -0800369 // VPN connection statistics.
370 static const char kMetricVpnDriver[];
371 static const int kMetricVpnDriverMax;
372 static const char kMetricVpnRemoteAuthenticationType[];
373 static const int kMetricVpnRemoteAuthenticationTypeMax;
374 static const char kMetricVpnUserAuthenticationType[];
375 static const int kMetricVpnUserAuthenticationTypeMax;
376
Thieu Le6c1e3bb2013-02-06 15:20:35 -0800377 explicit Metrics(EventDispatcher *dispatcher);
Thieu Le48e6d6d2011-12-06 00:40:27 +0000378 virtual ~Metrics();
379
Thieu Le48e6d6d2011-12-06 00:40:27 +0000380 // Converts the WiFi frequency into the associated UMA channel enumerator.
381 static WiFiChannel WiFiFrequencyToChannel(uint16 frequency);
382
Thieu Lead1ec2c2012-01-05 23:39:48 +0000383 // Converts a flimflam security string into its UMA security enumerator.
384 static WiFiSecurity WiFiSecurityStringToEnum(const std::string &security);
385
Paul Stewart21f40962013-03-01 14:27:28 -0800386 // Converts a flimflam EAP outer protocol string into its UMA enumerator.
387 static EapOuterProtocol EapOuterProtocolStringToEnum(
388 const std::string &outer);
389
390 // Converts a flimflam EAP inner protocol string into its UMA enumerator.
391 static EapInnerProtocol EapInnerProtocolStringToEnum(
392 const std::string &inner);
393
Thieu Le85e050b2012-03-13 15:04:38 -0700394 // Converts portal detection result to UMA portal result enumerator.
395 static PortalResult PortalDetectionResultToEnum(
396 const PortalDetector::Result &result);
397
Thieu Le6c1e3bb2013-02-06 15:20:35 -0800398 // Starts this object. Call this during initialization.
399 virtual void Start();
400
401 // Stops this object. Call this during cleanup.
402 virtual void Stop();
403
Thieu Le48e6d6d2011-12-06 00:40:27 +0000404 // Registers a service with this object so it can use the timers to track
405 // state transition metrics.
406 void RegisterService(const Service *service);
407
408 // Deregisters the service from this class. All state transition timers
409 // will be removed.
410 void DeregisterService(const Service *service);
411
412 // Tracks the time it takes |service| to go from |start_state| to
413 // |stop_state|. When |stop_state| is reached, the time is sent to UMA.
414 void AddServiceStateTransitionTimer(const Service *service,
415 const std::string &histogram_name,
416 Service::ConnectState start_state,
417 Service::ConnectState stop_state);
418
419 // Specializes |metric_name| for the specified |technology_id|.
420 std::string GetFullMetricName(const char *metric_name,
421 Technology::Identifier technology_id);
422
423 // Notifies this object that the default service has changed.
424 // |service| is the new default service.
Thieu Lea20cbc22012-01-09 22:01:43 +0000425 virtual void NotifyDefaultServiceChanged(const Service *service);
Thieu Le48e6d6d2011-12-06 00:40:27 +0000426
427 // Notifies this object that |service| state has changed.
428 virtual void NotifyServiceStateChanged(const Service *service,
429 Service::ConnectState new_state);
430
Thieu Le67370f62012-02-14 23:01:42 +0000431 // Notifies this object that |service| has been disconnected.
432 void NotifyServiceDisconnect(const Service *service);
Thieu Le48e6d6d2011-12-06 00:40:27 +0000433
Thieu Leb84ba342012-03-02 15:15:19 -0800434 // Notifies this object of a power management state change.
435 void NotifyPowerStateChange(PowerManager::SuspendState new_state);
Thieu Le48e6d6d2011-12-06 00:40:27 +0000436
Arman Ugurayab22c162012-10-08 19:08:38 -0700437 // Notifies this object that termination actions started executing.
438 void NotifyTerminationActionsStarted(TerminationActionReason reason);
439
440 // Notifies this object that termination actions have been completed.
441 // |success| is true, if the termination actions completed successfully.
442 void NotifyTerminationActionsCompleted(
443 TerminationActionReason reason, bool success);
444
Paul Stewartff845fc2012-08-07 07:28:44 -0700445 // Notifies this object of a failure in LinkMonitor.
446 void NotifyLinkMonitorFailure(
Paul Stewart0443aa52012-08-09 10:43:50 -0700447 Technology::Identifier technology,
448 LinkMonitorFailure failure,
Paul Stewartf1961f82012-09-11 20:45:39 -0700449 int seconds_to_failure,
450 int broadcast_error_count,
451 int unicast_error_count);
Paul Stewartff845fc2012-08-07 07:28:44 -0700452
453 // Notifies this object that LinkMonitor has added a response time sample
454 // for |connection| with a value of |response_time_milliseconds|.
455 void NotifyLinkMonitorResponseTimeSampleAdded(
456 Technology::Identifier technology,
Paul Stewartf1961f82012-09-11 20:45:39 -0700457 int response_time_milliseconds);
Paul Stewartff845fc2012-08-07 07:28:44 -0700458
Wade Guthried4977f22012-08-22 12:37:54 -0700459 // Notifies this object of WiFi disconnect.
460 void Notify80211Disconnect(WiFiDisconnectByWhom by_whom,
461 IEEE_80211::WiFiReasonCode reason);
462
Thieu Lec8078a62013-01-22 18:01:12 -0800463 // Registers a device with this object so the device can use the timers to
464 // track state transition metrics.
465 void RegisterDevice(int interface_index,
466 Technology::Identifier technology);
467
Thieu Le9abd6742013-01-23 23:35:37 -0800468 // Checks to see if the device has already been registered.
469 bool IsDeviceRegistered(int interface_index,
470 Technology::Identifier technology);
471
Thieu Lec8078a62013-01-22 18:01:12 -0800472 // Deregisters the device from this class. All state transition timers
473 // will be removed.
474 void DeregisterDevice(int interface_index);
475
476 // Notifies this object that a device has been initialized.
477 void NotifyDeviceInitialized(int interface_index);
478
Thieu Lece4483e2013-01-23 15:12:03 -0800479 // Notifies this object that a device has started the enable process.
480 void NotifyDeviceEnableStarted(int interface_index);
481
482 // Notifies this object that a device has completed the enable process.
483 void NotifyDeviceEnableFinished(int interface_index);
484
Thieu Lea2519bf2013-01-23 16:51:54 -0800485 // Notifies this object that a device has started the disable process.
486 void NotifyDeviceDisableStarted(int interface_index);
487
488 // Notifies this object that a device has completed the disable process.
489 void NotifyDeviceDisableFinished(int interface_index);
490
Thieu Le18c11072013-01-28 17:21:37 -0800491 // Notifies this object that a device has started the scanning process.
492 void NotifyDeviceScanStarted(int interface_index);
493
494 // Notifies this object that a device has completed the scanning process.
495 void NotifyDeviceScanFinished(int interface_index);
496
Thieu Lecdb5a212013-01-25 11:17:18 -0800497 // Notifies this object that a device has started the connect process.
Thieu Le7cf36b02013-01-30 17:15:56 -0800498 void NotifyDeviceConnectStarted(int interface_index,
499 bool is_auto_connecting);
Thieu Lecdb5a212013-01-25 11:17:18 -0800500
501 // Notifies this object that a device has completed the connect process.
502 void NotifyDeviceConnectFinished(int interface_index);
503
Thieu Le26fc01b2013-01-28 12:08:48 -0800504 // Notifies this object that a cellular device has been dropped by the
505 // network.
Thieu Le6c1e3bb2013-02-06 15:20:35 -0800506 void NotifyCellularDeviceDrop(int interface_index,
507 const std::string &network_technology,
Thieu Le26fc01b2013-01-28 12:08:48 -0800508 uint16 signal_strength);
509
Thieu Leb7aa5f72013-01-31 15:57:48 -0800510 // Notifies this object about a cellular device failure code.
511 void NotifyCellularDeviceFailure(const Error &error);
512
Thieu Le5133b712013-02-19 14:47:21 -0800513 // Notifies this object about a corrupted profile.
514 virtual void NotifyCorruptedProfile();
515
Thieu Le48e6d6d2011-12-06 00:40:27 +0000516 // Sends linear histogram data to UMA.
Thieu Le85e050b2012-03-13 15:04:38 -0700517 virtual bool SendEnumToUMA(const std::string &name, int sample, int max);
Thieu Le48e6d6d2011-12-06 00:40:27 +0000518
Thieu Lea20cbc22012-01-09 22:01:43 +0000519 // Send histogram data to UMA.
Thieu Le85e050b2012-03-13 15:04:38 -0700520 virtual bool SendToUMA(const std::string &name, int sample, int min,
521 int max, int num_buckets);
Thieu Lea20cbc22012-01-09 22:01:43 +0000522
Thieu Le48e6d6d2011-12-06 00:40:27 +0000523 private:
Thieu Le48e6d6d2011-12-06 00:40:27 +0000524 friend class MetricsTest;
Thieu Le6c1e3bb2013-02-06 15:20:35 -0800525 FRIEND_TEST(MetricsTest, CellularDropsPerHour);
Thieu Le48e6d6d2011-12-06 00:40:27 +0000526 FRIEND_TEST(MetricsTest, FrequencyToChannel);
Thieu Leb84ba342012-03-02 15:15:19 -0800527 FRIEND_TEST(MetricsTest, ServiceFailure);
Thieu Lea20cbc22012-01-09 22:01:43 +0000528 FRIEND_TEST(MetricsTest, TimeOnlineTimeToDrop);
Thieu Leb84ba342012-03-02 15:15:19 -0800529 FRIEND_TEST(MetricsTest, TimeToConfig);
530 FRIEND_TEST(MetricsTest, TimeToOnline);
531 FRIEND_TEST(MetricsTest, TimeToPortal);
Thieu Le18c11072013-01-28 17:21:37 -0800532 FRIEND_TEST(MetricsTest, TimeToScanIgnore);
Thieu Leb84ba342012-03-02 15:15:19 -0800533 FRIEND_TEST(MetricsTest, WiFiServiceChannel);
534 FRIEND_TEST(MetricsTest, WiFiServicePostReady);
Gaurav Shah6d2c72d2012-10-16 16:30:44 -0700535 FRIEND_TEST(WiFiMainTest, GetGeolocationObjects);
Thieu Le48e6d6d2011-12-06 00:40:27 +0000536
537 typedef ScopedVector<chromeos_metrics::TimerReporter> TimerReporters;
538 typedef std::list<chromeos_metrics::TimerReporter *> TimerReportersList;
539 typedef std::map<Service::ConnectState, TimerReportersList>
540 TimerReportersByState;
541 struct ServiceMetrics {
542 ServiceMetrics() : service(NULL) {}
543 // The service is registered/deregistered in the Service
544 // constructor/destructor, therefore there is no need to keep a ref count.
545 const Service *service;
546 // All TimerReporter objects are stored in |timers| which owns the objects.
547 // |start_on_state| and |stop_on_state| contain pointers to the
548 // TimerReporter objects and control when to start and stop the timers.
549 TimerReporters timers;
550 TimerReportersByState start_on_state;
551 TimerReportersByState stop_on_state;
552 };
553 typedef std::map<const Service *, std::tr1::shared_ptr<ServiceMetrics> >
554 ServiceMetricsLookupMap;
555
Thieu Lec8078a62013-01-22 18:01:12 -0800556 struct DeviceMetrics {
Thieu Le6c1e3bb2013-02-06 15:20:35 -0800557 DeviceMetrics() : auto_connect_tries(0), num_drops(0) {}
Thieu Le9abd6742013-01-23 23:35:37 -0800558 Technology::Identifier technology;
Thieu Lec8078a62013-01-22 18:01:12 -0800559 scoped_ptr<chromeos_metrics::TimerReporter> initialization_timer;
Thieu Lece4483e2013-01-23 15:12:03 -0800560 scoped_ptr<chromeos_metrics::TimerReporter> enable_timer;
Thieu Lea2519bf2013-01-23 16:51:54 -0800561 scoped_ptr<chromeos_metrics::TimerReporter> disable_timer;
Thieu Le18c11072013-01-28 17:21:37 -0800562 scoped_ptr<chromeos_metrics::TimerReporter> scan_timer;
Thieu Lecdb5a212013-01-25 11:17:18 -0800563 scoped_ptr<chromeos_metrics::TimerReporter> connect_timer;
Thieu Le7cf36b02013-01-30 17:15:56 -0800564 scoped_ptr<chromeos_metrics::TimerReporter> auto_connect_timer;
Thieu Le6c1e3bb2013-02-06 15:20:35 -0800565 int auto_connect_tries;
566 int num_drops;
Thieu Lec8078a62013-01-22 18:01:12 -0800567 };
568 typedef std::map<const int, std::tr1::shared_ptr<DeviceMetrics> >
569 DeviceMetricsLookupMap;
570
Thieu Le48e6d6d2011-12-06 00:40:27 +0000571 static const uint16 kWiFiBandwidth5MHz;
572 static const uint16 kWiFiBandwidth20MHz;
573 static const uint16 kWiFiFrequency2412;
574 static const uint16 kWiFiFrequency2472;
575 static const uint16 kWiFiFrequency2484;
576 static const uint16 kWiFiFrequency5170;
577 static const uint16 kWiFiFrequency5180;
578 static const uint16 kWiFiFrequency5230;
579 static const uint16 kWiFiFrequency5240;
580 static const uint16 kWiFiFrequency5320;
581 static const uint16 kWiFiFrequency5500;
582 static const uint16 kWiFiFrequency5700;
583 static const uint16 kWiFiFrequency5745;
584 static const uint16 kWiFiFrequency5825;
585
Thieu Le6c1e3bb2013-02-06 15:20:35 -0800586 static const int kHourlyTimeoutMilliseconds;
587
Thieu Le48e6d6d2011-12-06 00:40:27 +0000588 void InitializeCommonServiceMetrics(const Service *service);
589 void UpdateServiceStateTransitionMetrics(ServiceMetrics *service_metrics,
590 Service::ConnectState new_state);
591 void SendServiceFailure(const Service *service);
592
Wade Guthrie60a37062013-04-02 11:39:09 -0700593 DeviceMetrics *GetDeviceMetrics(int interface_index) const;
Thieu Le7cf36b02013-01-30 17:15:56 -0800594 void AutoConnectMetricsReset(DeviceMetrics *device_metrics);
Thieu Lece4483e2013-01-23 15:12:03 -0800595
Thieu Le6c1e3bb2013-02-06 15:20:35 -0800596 void HourlyTimeoutHandler();
597
Thieu Le48e6d6d2011-12-06 00:40:27 +0000598 // For unit test purposes.
599 void set_library(MetricsLibraryInterface *library);
Thieu Lea20cbc22012-01-09 22:01:43 +0000600 void set_time_online_timer(chromeos_metrics::Timer *timer) {
601 time_online_timer_.reset(timer); // Passes ownership
602 }
603 void set_time_to_drop_timer(chromeos_metrics::Timer *timer) {
604 time_to_drop_timer_.reset(timer); // Passes ownership
605 }
Thieu Leb84ba342012-03-02 15:15:19 -0800606 void set_time_resume_to_ready_timer(chromeos_metrics::Timer *timer) {
607 time_resume_to_ready_timer_.reset(timer); // Passes ownership
608 }
Arman Ugurayab22c162012-10-08 19:08:38 -0700609 void set_time_termination_actions_timer(
610 chromeos_metrics::Timer *timer) {
611 time_termination_actions_timer.reset(timer); // Passes ownership
612 }
Thieu Le18c11072013-01-28 17:21:37 -0800613 void set_time_to_scan_timer(int interface_index,
614 chromeos_metrics::TimerReporter *timer) {
615 DeviceMetrics *device_metrics = GetDeviceMetrics(interface_index);
616 device_metrics->scan_timer.reset(timer); // Passes ownership
617 }
Thieu Le48e6d6d2011-12-06 00:40:27 +0000618
619 // |library_| points to |metrics_library_| when shill runs normally.
620 // However, in order to allow for unit testing, we point |library_| to a
621 // MetricsLibraryMock object instead.
Thieu Le6c1e3bb2013-02-06 15:20:35 -0800622 EventDispatcher *dispatcher_;
Thieu Le48e6d6d2011-12-06 00:40:27 +0000623 MetricsLibrary metrics_library_;
624 MetricsLibraryInterface *library_;
625 ServiceMetricsLookupMap services_metrics_;
Thieu Lea20cbc22012-01-09 22:01:43 +0000626 Technology::Identifier last_default_technology_;
627 bool was_online_;
628 scoped_ptr<chromeos_metrics::Timer> time_online_timer_;
629 scoped_ptr<chromeos_metrics::Timer> time_to_drop_timer_;
Thieu Leb84ba342012-03-02 15:15:19 -0800630 scoped_ptr<chromeos_metrics::Timer> time_resume_to_ready_timer_;
Arman Ugurayab22c162012-10-08 19:08:38 -0700631 scoped_ptr<chromeos_metrics::Timer> time_termination_actions_timer;
Darin Petkov58f0b6d2012-06-12 12:52:30 +0200632 bool collect_bootstats_;
Thieu Lec8078a62013-01-22 18:01:12 -0800633 DeviceMetricsLookupMap devices_metrics_;
Thieu Le6c1e3bb2013-02-06 15:20:35 -0800634 base::CancelableClosure hourly_timeout_handler_;
Thieu Le48e6d6d2011-12-06 00:40:27 +0000635
636 DISALLOW_COPY_AND_ASSIGN(Metrics);
637};
638
639} // namespace shill
640
Wade Guthrie60a37062013-04-02 11:39:09 -0700641#endif // SHILL_METRICS_H_