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
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
|
# This Source Code Form is subject to the terms of the Mozilla Public
# License, v. 2.0. If a copy of the MPL was not distributed with this
# file, You can obtain one at http://mozilla.org/MPL/2.0/.
# Adding a new metric? We have docs for that!
# https://firefox-source-docs.mozilla.org/toolkit/components/glean/user/new_definitions_file.html
---
$schema: moz://mozilla.org/schemas/glean/metrics/2-0-0
$tags:
- 'Toolkit :: Default Browser Agent'
system:
os_version:
type: string
description: >
The current Windows OS version, usually as a dotted quad ("x.y.z.w") with
Windows Update Build Revision (UBR), but potentially as a dotted triple
("x.y.z") without UBR.
lifetime: application
bugs:
- https://bugzilla.mozilla.org/show_bug.cgi?id=1850149
data_reviews:
- https://bugzilla.mozilla.org/show_bug.cgi?id=1850149
data_sensitivity:
- technical
notification_emails:
- install-update@mozilla.com
expires: never
send_in_pings:
- default-agent
previous_os_version:
type: string
description: >
The Windows OS version before it was changed to the current setting. The
possible values are the same as for `system.os_version`.
The OS does not keep track of the previous OS version, so the agent
records this information itself. That means that it will be inaccurate
until the first time the default is changed after the agent task begins
running. Before then, the value of `previous_os_version` will be the same
as `os_version`.
This value is updated every time the Default Agent runs, so when the
default browser is first changed the values for `os_version` and
`previous_os_version` will be different. But on subsequent executions of
the Default Agent, the two values will be the same.
lifetime: application
bugs:
- https://bugzilla.mozilla.org/show_bug.cgi?id=1850149
data_reviews:
- https://bugzilla.mozilla.org/show_bug.cgi?id=1850149
data_sensitivity:
- technical
notification_emails:
- install-update@mozilla.com
expires: never
send_in_pings:
- default-agent
system_default:
browser:
type: string
description: >
Which browser is currently set as the system default web browser. This is
simply a string with the name of the browser binned to a fixed set of
known browsers.
Possible values currently include the following (from
[DefaultBrowser.cpp](https://searchfox.org/mozilla-central/source/toolkit/mozapps/defaultagent/DefaultBrowser.cpp)):
* "error"
* "" (unknown)
* "firefox"
* "chrome"
* "edge"
* "edge-chrome"
* "ie"
* "opera"
* "brave"
* "yandex"
* "qq-browser"
* "360-browser"
* "sogou"
* "duckduckgo"
lifetime: application
bugs:
- https://bugzilla.mozilla.org/show_bug.cgi?id=1838755
data_reviews:
- https://bugzilla.mozilla.org/show_bug.cgi?id=1621293
data_sensitivity:
- technical
notification_emails:
- install-update@mozilla.com
expires: never
send_in_pings:
- default-agent
previous_browser:
type: string
description: >
Which browser was set as the system default before it was changed to the
current setting. The possible values are the same as for
`system_default.browser`.
The OS does not keep track of previous default settings, so the agent
records this information itself. That means that it will be inaccurate
until the first time the default is changed after the agent task begins
running. Before then, the value of `previous_browser` will be the same
as `browser`.
This value is updated every time the Default Agent runs, so when the
default browser is first changed the values for `browser` and
`previous_browser` will be different. But on subsequent executions of
the Default Agent, the two values will be the same.
lifetime: application
bugs:
- https://bugzilla.mozilla.org/show_bug.cgi?id=1838755
data_reviews:
- https://bugzilla.mozilla.org/show_bug.cgi?id=1621293
data_sensitivity:
- technical
notification_emails:
- install-update@mozilla.com
expires: never
send_in_pings:
- default-agent
pdf_handler:
type: string
description: >
Which pdf handler is currently set as the system default handler. This is
simply a string with the name of the handler binned to a fixed set of
known handlers.
Possible values currently include the following (from
[DefaultPDF.cpp](https://searchfox.org/mozilla-central/source/toolkit/mozapps/defaultagent/DefaultPDF.cpp)):
* "Error"
* "" (unknown)
* "Firefox"
* "Microsoft Edge"
* "Google Chrome"
* "Adobe Acrobat"
* "WPS"
* "Nitro"
* "Foxit"
* "PDF-XChange"
* "Avast"
* "Sumatra"
lifetime: application
bugs:
- https://bugzilla.mozilla.org/show_bug.cgi?id=1756900
data_reviews:
- https://bugzilla.mozilla.org/show_bug.cgi?id=1756900
data_sensitivity:
- technical
notification_emails:
- install-update@mozilla.com
expires: never
send_in_pings:
- default-agent
notification:
show_success:
type: boolean
description: >
Whether a notification was shown or not. Possible value include "shown" and "error".
notification_emails:
- install-update@mozilla.com
bugs:
- https://bugzilla.mozilla.org/show_bug.cgi?id=1838755
data_reviews:
- https://bugzilla.mozilla.org/show_bug.cgi?id=1621293
expires: never
send_in_pings:
- default-agent
action:
type: string
description: >
The action that the user took in response to the notification. Possible
values currently include the following:
* “dismissed-by-timeout”
* “dismissed-to-action-center”
* “dismissed-by-button”
* “dismissed-by-application-hidden”
* “make-firefox-default-button”
* “toast-clicked”
Many of the values correspond to buttons on the notification and should be
pretty self explanatory, but a few are less so.
* “dismissed-to-action-center” will be used if the user clicks the arrow in
the top right corner of the notification to dismiss it to the
action center.
* “dismissed-by-application-hidden” is provided because that is a method of
dismissal that the notification API could give but, in practice, should
never be seen.
* “dismissed-by-timeout” indicates that the user did not interact with the
notification and it timed out.
notification_emails:
- install-update@mozilla.com
bugs:
- https://bugzilla.mozilla.org/show_bug.cgi?id=1838755
data_reviews:
- https://bugzilla.mozilla.org/show_bug.cgi?id=1621293
expires: never
send_in_pings:
- default-agent
|