toolkit/profile/metrics.yaml

   1 # This Source Code Form is subject to the terms of the Mozilla Public
   2 # License, v. 2.0. If a copy of the MPL was not distributed with this
   3 # file, You can obtain one at http://mozilla.org/MPL/2.0/.
   4
   5 # Adding a new metric? We have docs for that!
   6 # https://firefox-source-docs.mozilla.org/toolkit/components/glean/user/new_definitions_file.html
   7
   8 ---
   9 $schema: moz://mozilla.org/schemas/glean/metrics/2-0-0
  10 $tags:
  11   - 'Toolkit :: Startup and Profile System'
  12
  13 startup:
  14   profile_selection_reason:
  15     type: string
  16     description: >
  17       How the profile was selected during startup. One of the following reasons:
  18         unknown:
  19           Generally should not happen, set as a default in case no other reason
  20           occured.
  21         profile-manager:
  22           The profile was selected by the profile manager.
  23         profile-selector:
  24           The profile was selected by the profile selector window.
  25         profile-reset:
  26           The profile was selected for reset, normally this would mean a restart.
  27         restart:
  28           The user restarted the application, the same profile as previous will
  29           be used.
  30         argument-profile:
  31           The profile was selected by the --profile command line argument.
  32         argument-p:
  33           The profile was selected by the -p command line argument.
  34         firstrun-claimed-default:
  35           A first run of a dedicated profiles build chose the old default
  36           profile to be the default for this install.
  37         firstrun-skipped-default:
  38           A first run of a dedicated profiles build skipped over the old default
  39           profile and created a new profile.
  40         restart-claimed-default:
  41           A first run of a dedicated profiles build after a restart chose the
  42           old default profile to be the default for this install.
  43         restart-skipped-default:
  44           A first run of a dedicated profiles build after a restart skipped over
  45           the old default profile and created a new profile.
  46         firstrun-created-default:
  47           A first run of the application created a new profile to use.
  48         default:
  49           The default profile was selected as normal.
  50       This metric was generated to correspond to the Legacy Telemetry
  51       scalar startup.profile_selection_reason.
  52     bugs:
  53       - https://bugzil.la/1522934
  54       - https://bugzil.la/1570652
  55       - https://bugzil.la/1623406
  56       - https://bugzil.la/1749887
  57       - https://bugzil.la/1893667
  58     data_reviews:
  59       - https://bugzil.la/1522934
  60       - https://bugzil.la/1570652
  61       - https://bugzil.la/1623406
  62       - https://bugzil.la/1749887
  63       - https://bugzil.la/1893667
  64     notification_emails:
  65       - dtownsend@mozilla.com
  66       - rtestard@mozilla.com
  67       - gkaberere@mozilla.com
  68       - jhollek@mozilla.com
  69       - echo@mozilla.com
  70       - shong@mozilla.com
  71       - jhirsch@mozilla.com
  72     expires: never
  73     telemetry_mirror: STARTUP_PROFILE_SELECTION_REASON
  74
  75   profile_database_version:
  76     type: string
  77     description: >
  78       The version of the profiles.ini database loaded during startup. A
  79       value of "0" is used to indicate that no file was present during
  80       startup.
  81       This metric was generated to correspond to the Legacy Telemetry
  82       scalar startup.profile_database_version.
  83     bugs:
  84       - https://bugzil.la/1878339
  85       - https://bugzil.la/1916867
  86     data_reviews:
  87       - https://bugzil.la/1878339
  88       - https://bugzil.la/1916867
  89     notification_emails:
  90       - dtownsend@mozilla.com
  91       - kbryant@mozilla.com
  92     expires: 140
  93     telemetry_mirror: STARTUP_PROFILE_DATABASE_VERSION
  94
  95   profile_count:
  96     type: quantity
  97     description: >
  98       This records the number of known profiles after startup completes.
  99       This includes any profiles that were created during startup.
 100       This metric was generated to correspond to the Legacy Telemetry
 101       scalar startup.profile_count.
 102     bugs:
 103       - https://bugzil.la/1878339
 104       - https://bugzil.la/1916867
 105     data_reviews:
 106       - https://bugzil.la/1878339
 107       - https://bugzil.la/1916867
 108     notification_emails:
 109       - dtownsend@mozilla.com
 110       - kbryant@mozilla.com
 111     expires: 140
 112     unit: profiles
 113     telemetry_mirror: STARTUP_PROFILE_COUNT