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
|
// Copyright 2022 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef CHROME_BROWSER_METRICS_USAGE_SCENARIO_USAGE_SCENARIO_H_
#define CHROME_BROWSER_METRICS_USAGE_SCENARIO_USAGE_SCENARIO_H_
#include <optional>
#include "chrome/browser/metrics/usage_scenario/usage_scenario_data_store.h"
// Describes the different usaage scenarios in Chrome.
enum class Scenario {
kAllTabsHiddenAudio = 1,
kAllTabsHiddenNoVideoCaptureOrAudio = 2,
kAllTabsHiddenNoVideoCaptureOrAudioRecent = 3, // Short scenario only.
kAllTabsHiddenVideoCapture = 4,
kAudio = 5,
kEmbeddedVideoNoNavigation = 6,
kEmbeddedVideoWithNavigation = 7,
kFullscreenVideo = 8,
kInteraction = 9,
kNavigation = 10,
kPassive = 11,
kVideoCapture = 12,
kZeroWindow = 13,
kZeroWindowRecent = 14, // Short scenario only.
kMaxValue = kZeroWindowRecent
};
// Contains data to determine when and how to generate histograms and trace
// events for a usage scenario.
struct ScenarioParams {
Scenario scenario;
const char* histogram_suffix;
// CPU usage threshold to emit a "high CPU" trace event.
double short_interval_cpu_threshold;
const char* trace_event_title;
};
// Returns the scenario params associated with `interval_data`.
ScenarioParams GetLongIntervalScenario(
const UsageScenarioDataStore::IntervalData& interval_data);
#if BUILDFLAG(IS_MAC)
// Returns params to use for histograms and trace events related to a short
// interval described by `short_interval_data`. `pre_interval_data` describes
// a long interval ending simultaneously with the short interval.
//
// `pre_interval_data` is required to decide whether "_Recent" is appended to
// the ".ZeroWindow" or ".AllTabsHidden_NoVideoCaptureOrAudio" suffixes.
// Appending "_Recent" is useful to isolate cases where the scenario changed
// recently (e.g. CPU usage in a short interval with zero window might be
// affected by cleanup tasks from recently closed tabs).
const ScenarioParams& GetShortIntervalScenarioParams(
const UsageScenarioDataStore::IntervalData& short_interval_data,
const UsageScenarioDataStore::IntervalData& pre_interval_data);
#endif // BUILDFLAG(IS_MAC)
#endif // CHROME_BROWSER_METRICS_USAGE_SCENARIO_USAGE_SCENARIO_H_
|
