File: metrics.yaml

package info (click to toggle)
firefox 144.0-1
  • links: PTS, VCS
  • area: main
  • in suites: sid
  • size: 4,637,504 kB
  • sloc: cpp: 7,576,692; javascript: 6,430,831; ansic: 3,748,119; python: 1,398,978; xml: 628,810; asm: 438,679; java: 186,194; sh: 63,212; makefile: 19,159; objc: 13,086; perl: 12,986; yacc: 4,583; cs: 3,846; pascal: 3,448; lex: 1,720; ruby: 1,003; exp: 762; php: 436; lisp: 258; awk: 247; sql: 66; sed: 53; csh: 10
file content (310 lines) | stat: -rw-r--r-- 9,826 bytes parent folder | download | duplicates (4)
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
# 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 :: Safe Browsing'

application_reputation:
  binary_type:
    type: labeled_counter
    description: >
      Whether or not the file examined by download protection is a binary type
      (or it's not possible to tell because the filename is missing).

      This metric was generated to correspond to the Legacy Telemetry
      categorical histogram APPLICATION_REPUTATION_BINARY_TYPE.
    labels:
      - BinaryFile
      - NonBinaryFile
      - MozNonBinaryFile
      - UnknownFile
      - MissingFilename
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=156404
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=156404
    notification_emails:
      - dlee@mozilla.com
      - safebrowsing-telemetry@mozilla.org
    expires: never
    telemetry_mirror: h#APPLICATION_REPUTATION_BINARY_TYPE

  binary_archive:
    type: labeled_counter
    description: >
      Whether a binary file examined by download protection is one of the common
      archive formats.

      This metric was generated to correspond to the Legacy Telemetry
      categorical histogram APPLICATION_REPUTATION_BINARY_ARCHIVE.
    labels:
      - OtherBinaryFile
      - DmgFile
      - RarFile
      - ZipFile
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1480639
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1531034
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1480639
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1531034
    notification_emails:
      - dlee@mozilla.com
      - safebrowsing-telemetry@mozilla.org
    expires: never
    telemetry_mirror: h#APPLICATION_REPUTATION_BINARY_ARCHIVE

  should_block:
    type: labeled_counter
    description: >
      Overall (local or remote) application reputation verdict
      (shouldBlock=false is OK).

      This metric was generated to correspond to the Legacy Telemetry boolean
      histogram APPLICATION_REPUTATION_SHOULD_BLOCK.
    labels:
      - "false"
      - "true"
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1935420
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1935420
    notification_emails:
      - dlee@mozilla.com
      - safebrowsing-telemetry@mozilla.org
    expires: never
    telemetry_mirror: h#APPLICATION_REPUTATION_SHOULD_BLOCK

  local:
    type: custom_distribution
    description: >
      Application reputation local results (0=ALLOW, 1=BLOCK, 2=NONE)

      This metric was generated to correspond to the Legacy Telemetry enumerated
      histogram APPLICATION_REPUTATION_LOCAL.
    range_min: 0
    range_max: 3
    bucket_count: 4
    histogram_type: linear
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1935420
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1935420
    notification_emails:
      - dlee@mozilla.com
      - safebrowsing-telemetry@mozilla.org
    expires: never
    telemetry_mirror: APPLICATION_REPUTATION_LOCAL

  server:
    type: custom_distribution
    description: >
      Status of the application reputation remote lookup (0=OK, 1=failed,
      2=invalid protobuf response)

      This metric was generated to correspond to the Legacy Telemetry enumerated
      histogram APPLICATION_REPUTATION_SERVER.
    range_min: 0
    range_max: 3
    bucket_count: 4
    histogram_type: linear
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1935420
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1935420
    notification_emails:
      - dlee@mozilla.com
      - safebrowsing-telemetry@mozilla.org
    expires: never
    telemetry_mirror: APPLICATION_REPUTATION_SERVER

  server_2:
    type: labeled_counter
    description: >
      Network status of the application reputation remote lookup

      This metric was generated to correspond to the Legacy Telemetry
      categorical histogram APPLICATION_REPUTATION_SERVER_2.
    labels:
      - ErrOthers
      - ResponseValid
      - FailGetChannel
      - FailGetResponse
      - HTTP1xx
      - HTTP2xx
      - HTTP204
      - HTTP3xx
      - HTTP400
      - HTTP4xx
      - HTTP403
      - HTTP404
      - HTTP408
      - HTTP413
      - HTTP5xx
      - HTTP502_504_511
      - HTTP503
      - HTTP505
      - HTTPOthers
      - ErrAlreadyConnected
      - ErrNotConnected
      - ErrConnectionRefused
      - ErrNetTimeout
      - ErrOffline
      - ErrPortAccess
      - ErrNetReset
      - ErrNetInterrupt
      - ErrProxyConnection
      - ErrNetPartial
      - ErrNetInadequate
      - ErrUnknownHost
      - ErrDNSLookupQueue
      - ErrUnknownProxyHost
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1479901
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1479901
    notification_emails:
      - dlee@mozilla.com
      - safebrowsing-telemetry@mozilla.org
    expires: never
    telemetry_mirror: h#APPLICATION_REPUTATION_SERVER_2

  server_verdict:
    type: custom_distribution
    description: >
      Application reputation remote verdict (0=SAFE, 1=DANGEROUS, 2=UNCOMMON,
      3=POTENTIALLY_UNWANTED, 4=DANGEROUS_HOST, 5=UNKNOWN)

      This metric was generated to correspond to the Legacy Telemetry enumerated
      histogram APPLICATION_REPUTATION_SERVER_VERDICT.
    range_min: 0
    range_max: 8
    bucket_count: 9
    histogram_type: linear
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1272788
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1531034
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1272788
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1531034
    notification_emails:
      - dlee@mozilla.com
      - safebrowsing-telemetry@mozilla.org
    expires: never
    telemetry_mirror: APPLICATION_REPUTATION_SERVER_VERDICT

  server_verdict_2:
    type: dual_labeled_counter
    description: >
      Application reputation remote verdict, keyed by file extension

      This metric was generated to correspond to the Legacy Telemetry
      categorical histogram APPLICATION_REPUTATION_SERVER_VERDICT_2.
    dual_labels:
      key:
        description: File extension.
      category:
        labels:
          - Safe
          - Dangerous
          - Uncommon
          - PotentiallyUnwanted
          - DangerousHost
          - Unknown
        description: Labels of the keyed categorical legacy telemetry histogram
          APPLICATION_REPUTATION_SERVER_VERDICT_2.
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1501974
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1589042
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1501974
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1589042
    notification_emails:
      - dlee@mozilla.com
      - safebrowsing-telemetry@mozilla.org
    expires: never
    telemetry_mirror: APPLICATION_REPUTATION_SERVER_VERDICT_2

  remote_lookup_response_time:
    type: timing_distribution
    description: >
      Server response time to remote lookup request (ms).

      This metric was generated to correspond to the Legacy Telemetry linear
      histogram APPLICATION_REPUTATION_REMOTE_LOOKUP_RESPONSE_TIME.
    time_unit: millisecond
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1479898
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1479898
    notification_emails:
      - dlee@mozilla.com
      - safebrowsing-telemetry@mozilla.org
    expires: never
    telemetry_mirror: APPLICATION_REPUTATION_REMOTE_LOOKUP_RESPONSE_TIME

  remote_lookup_timeout:
    type: labeled_counter
    description: >
      Recorded when application reputation remote lookup is performed, `true` is
      recorded if the lookup times out.

      This metric was generated to correspond to the Legacy Telemetry boolean
      histogram APPLICATION_REPUTATION_REMOTE_LOOKUP_TIMEOUT.
    labels:
      - "false"
      - "true"
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1172689
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1531034
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1172689
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1531034
    notification_emails:
      - dlee@mozilla.com
      - safebrowsing-telemetry@mozilla.org
    expires: never
    telemetry_mirror: h#APPLICATION_REPUTATION_REMOTE_LOOKUP_TIMEOUT

  reason:
    type: labeled_counter
    description: >
      The reason application reputation service blocks or allows the download.

      This metric was generated to correspond to the Legacy Telemetry
      categorical histogram APPLICATION_REPUTATION_REASON.
    labels:
      - NotSet
      - LocalWhitelist
      - LocalBlocklist
      - NonBinaryFile
      - VerdictSafe
      - VerdictUnknown
      - VerdictDangerous
      - VerdictDangerousHost
      - VerdictUnwanted
      - VerdictUncommon
      - VerdictUnrecognized
      - DangerousPrefOff
      - DangerousHostPrefOff
      - UnwantedPrefOff
      - UncommonPrefOff
      - NetworkError
      - RemoteLookupDisabled
      - InternalError
      - DPDisabled
    bugs:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1500360
    data_reviews:
      - https://bugzilla.mozilla.org/show_bug.cgi?id=1500360
    notification_emails:
      - dlee@mozilla.com
      - safebrowsing-telemetry@mozilla.org
    expires: never
    telemetry_mirror: h#APPLICATION_REPUTATION_REASON