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
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
|
# 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:
- 'Firefox :: Security'
doh:
evaluate_v2_heuristics:
type: event
description: >
Results of DoH heuristics at startup and after network changes.
This event was generated to correspond to the Legacy Telemetry event
doh.evaluate_v2#heuristics.
bugs:
- https://bugzil.la/1573840
- https://bugzil.la/1631609
- https://bugzil.la/1603779
- https://bugzil.la/1654714
data_reviews:
- https://bugzil.la/1573840
- https://bugzil.la/1631609
- https://bugzil.la/1603779
- https://bugzil.la/1654714
notification_emails:
- nhnt11@mozilla.com
- ddamjanovic@mozilla.com
- seceng-telemetry@mozilla.com
- necko@mozilla.com
expires: never
extra_keys:
value:
description: >
The `value` of the event. Mirrors to the Legacy Telemetry
event's `value` parameter.
type: string
canaries:
description: >
Comma-separated list of canaries that were detected (canary,zscalerCanary)
type: string
filtering:
description: >
Comma-separated list of detected parental controls/content filtering (browserParent,google,youtube)
type: string
enterprise:
description: >
Comma-separated list of detected enterprise config (policy,modifiedRoots,thirdPartyRoots)
type: string
steeredProvider:
description: >
Whether we detected a steering provider
type: string
evaluateReason:
description: >
The reason for running heuristics - startup or netchange
type: string
networkID:
description: >
An ID representing the network on which heuristics were run, unique to this client
type: string
captiveState:
description: >
The Captive Portal Service state - unknown, not_captive, locked, or unlocked
type: string
platform:
description: >
Comma-separated list of platform attributes that would cause split-horizon issues (vpn, proxy, nrpt)
type: string
telemetry_mirror: Doh_EvaluateV2_Heuristics
state_enabled:
type: event
description: >
Results of DoH heuristics at startup and after network changes.
This event was generated to correspond to the Legacy Telemetry event
doh.state#enabled.
bugs: &doh_state_bugs
- https://bugzil.la/1573840
- https://bugzil.la/1631609
- https://bugzil.la/1603779
data_reviews: &doh_state_data_reviews
- https://bugzil.la/1573840
- https://bugzil.la/1631609
- https://bugzil.la/1603779
notification_emails: &doh_state_emails
- nhnt11@mozilla.com
- ddamjanovic@mozilla.com
- seceng-telemetry@mozilla.com
- necko@mozilla.com
expires: never
extra_keys: &doh_state_extra
value:
description: >
The `value` of the event. Mirrors to the Legacy Telemetry
event's `value` parameter.
type: string
telemetry_mirror: Doh_State_Enabled
state_disabled:
type: event
description: >
Results of DoH heuristics at startup and after network changes.
This event was generated to correspond to the Legacy Telemetry event
doh.state#disabled.
bugs: *doh_state_bugs
data_reviews: *doh_state_data_reviews
notification_emails: *doh_state_emails
expires: never
extra_keys: *doh_state_extra
telemetry_mirror: Doh_State_Disabled
state_manually_disabled:
type: event
description: >
Results of DoH heuristics at startup and after network changes.
This event was generated to correspond to the Legacy Telemetry event
doh.state#manuallyDisabled.
bugs: *doh_state_bugs
data_reviews: *doh_state_data_reviews
notification_emails: *doh_state_emails
expires: never
extra_keys: *doh_state_extra
telemetry_mirror: Doh_State_Manuallydisabled
state_policy_disabled:
type: event
description: >
Results of DoH heuristics at startup and after network changes.
This event was generated to correspond to the Legacy Telemetry event
doh.state#policyDisabled.
bugs: *doh_state_bugs
data_reviews: *doh_state_data_reviews
notification_emails: *doh_state_emails
expires: never
extra_keys: *doh_state_extra
telemetry_mirror: Doh_State_Policydisabled
state_uninstalled:
type: event
description: >
Results of DoH heuristics at startup and after network changes.
This event was generated to correspond to the Legacy Telemetry event
doh.state#uninstalled.
bugs: *doh_state_bugs
data_reviews: *doh_state_data_reviews
notification_emails: *doh_state_emails
expires: never
extra_keys: *doh_state_extra
telemetry_mirror: Doh_State_Uninstalled
state_uiok:
type: event
description: >
Results of DoH heuristics at startup and after network changes.
This event was generated to correspond to the Legacy Telemetry event
doh.state#UIOk.
bugs: *doh_state_bugs
data_reviews: *doh_state_data_reviews
notification_emails: *doh_state_emails
expires: never
extra_keys: *doh_state_extra
telemetry_mirror: Doh_State_Uiok
state_uidisabled:
type: event
description: >
Results of DoH heuristics at startup and after network changes.
This event was generated to correspond to the Legacy Telemetry event
doh.state#UIDisabled.
bugs: *doh_state_bugs
data_reviews: *doh_state_data_reviews
notification_emails: *doh_state_emails
expires: never
extra_keys: *doh_state_extra
telemetry_mirror: Doh_State_Uidisabled
state_rollback:
type: event
description: >
Results of DoH heuristics at startup and after network changes.
This event was generated to correspond to the Legacy Telemetry event
doh.state#rollback.
bugs: *doh_state_bugs
data_reviews: *doh_state_data_reviews
notification_emails: *doh_state_emails
expires: never
extra_keys: *doh_state_extra
telemetry_mirror: Doh_State_Rollback
state_shutdown:
type: event
description: >
Results of DoH heuristics at startup and after network changes.
This event was generated to correspond to the Legacy Telemetry event
doh.state#shutdown.
bugs: *doh_state_bugs
data_reviews: *doh_state_data_reviews
notification_emails: *doh_state_emails
expires: never
extra_keys: *doh_state_extra
telemetry_mirror: Doh_State_Shutdown
security.doh.trr_performance:
resolved_record:
type: event
description: >
How long it took to resolve a test domain using TRR.
This event was generated to correspond to the Legacy Telemetry event
security.doh.trrPerformance.resolved#record.
bugs:
- https://bugzil.la/1613790
data_reviews:
- https://bugzil.la/1613790
notification_emails:
- nhnt11@mozilla.com
- ddamjanovic@mozilla.com
- seceng-telemetry@mozilla.com
expires: never
extra_keys:
value:
description: >
The `value` of the event. Mirrors to the Legacy Telemetry
event's `value` parameter.
type: string
domain:
description: >
The resolved domain.
type: string
trr:
description: >
The TRR provider used.
type: string
time:
description: >
The network time for the resolution.
type: string
status:
description: >
The DNS status code.
type: string
retryCount:
description: >
The number of lookup attempts before success.
type: string
networkUnstable:
description: >
Whether there was network fluctuation while gathering the results.
type: string
captivePortal:
description: >
Whether there a captive portal was detected during the run.
type: string
telemetry_mirror: SecurityDohTrrperformance_Resolved_Record
trrselect_dryrunresult:
type: event
description: >
The URL of the DoH provider chosen by the TRR selection dry-run
This event was generated to correspond to the Legacy Telemetry event
security.doh.trrPerformance.trrselect#dryrunresult.
bugs:
- https://bugzil.la/1631822
data_reviews:
- https://bugzil.la/1631822
notification_emails:
- nhnt11@mozilla.com
- ddamjanovic@mozilla.com
- seceng-telemetry@mozilla.com
expires: never
extra_keys:
value:
description: >
The `value` of the event. Mirrors to the Legacy Telemetry
event's `value` parameter.
type: string
telemetry_mirror: SecurityDohTrrperformance_Trrselect_Dryrunresult
networking:
doh_heuristics_attempts:
type: counter
description: >
The number of times we ran DoH heuristics.
This metric was generated to correspond to the Legacy Telemetry
scalar networking.doh_heuristics_attempts.
bugs:
- https://bugzil.la/1784258
data_reviews:
- https://bugzil.la/1784258
notification_emails:
- necko@mozilla.com
- vgosu@mozilla.com
expires: never
telemetry_mirror: NETWORKING_DOH_HEURISTICS_ATTEMPTS
doh_heuristics_pass_count:
type: counter
description: >
The number of times we passed DoH heuristics.
This metric was generated to correspond to the Legacy Telemetry
scalar networking.doh_heuristics_pass_count.
bugs:
- https://bugzil.la/1784258
data_reviews:
- https://bugzil.la/1784258
notification_emails:
- necko@mozilla.com
- vgosu@mozilla.com
expires: never
telemetry_mirror: NETWORKING_DOH_HEURISTICS_PASS_COUNT
doh_heuristics_result:
type: quantity
description: >
The value of this scalar indicates the result of the last heuristic
run. 0: "incomplete" 1: "pass" 2: "opt-out" 3: "manually-disabled"
4: "manually-enabled" 5: "enterprise-disabled" 6: "enterprise-
present" 7: "enterprise-enabled" 8: "vpn" 9: "proxy" 10: "nrpt" 11:
"parental" 12: "modifiedRoots" 13: "thirdPartyRoots" 14: "google"
15: "youtube" 16: "zscaler" 17: "canary" 18: "ignored"
This metric was generated to correspond to the Legacy Telemetry
scalar networking.doh_heuristics_result.
bugs:
- https://bugzil.la/1784258
data_reviews:
- https://bugzil.la/1784258
notification_emails:
- necko@mozilla.com
- vgosu@mozilla.com
expires: never
unit: doh heuristic result
telemetry_mirror: NETWORKING_DOH_HEURISTICS_RESULT
doh_heuristic_ever_tripped:
type: labeled_boolean
description: >
True if this heuristic (key) was ever tripped during the session.
This metric was generated to correspond to the Legacy Telemetry
scalar networking.doh_heuristic_ever_tripped.
bugs:
- https://bugzil.la/1784258
data_reviews:
- https://bugzil.la/1784258
notification_emails:
- necko@mozilla.com
- vgosu@mozilla.com
expires: never
telemetry_mirror: NETWORKING_DOH_HEURISTIC_EVER_TRIPPED
|
