Source code
Revision control
Copy as Markdown
Other Tools
# 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
# Adding a new metric? We have docs for that!
---
$tags:
- 'Toolkit :: Startup and Profile System'
startup:
profile_selection_reason:
type: string
description: >
How the profile was selected during startup. One of the following reasons:
unknown:
Generally should not happen, set as a default in case no other reason
occured.
profile-manager:
The profile was selected by the profile manager.
profile-selector:
The profile was selected by the profile selector window.
profile-reset:
The profile was selected for reset, normally this would mean a restart.
restart:
The user restarted the application, the same profile as previous will
be used.
argument-profile:
The profile was selected by the --profile command line argument.
argument-p:
The profile was selected by the -p command line argument.
firstrun-claimed-default:
A first run of a dedicated profiles build chose the old default
profile to be the default for this install.
firstrun-skipped-default:
A first run of a dedicated profiles build skipped over the old default
profile and created a new profile.
restart-claimed-default:
A first run of a dedicated profiles build after a restart chose the
old default profile to be the default for this install.
restart-skipped-default:
A first run of a dedicated profiles build after a restart skipped over
the old default profile and created a new profile.
firstrun-created-default:
A first run of the application created a new profile to use.
default:
The default profile was selected as normal.
This metric was generated to correspond to the Legacy Telemetry
scalar startup.profile_selection_reason.
bugs:
data_reviews:
notification_emails:
- dtownsend@mozilla.com
- rtestard@mozilla.com
- gkaberere@mozilla.com
- jhollek@mozilla.com
- echo@mozilla.com
- shong@mozilla.com
- jhirsch@mozilla.com
expires: never
telemetry_mirror: STARTUP_PROFILE_SELECTION_REASON
send_in_pings:
- metrics
- baseline
no_lint:
- BASELINE_PING
profile_database_version:
type: string
description: >
The version of the profiles.ini database loaded during startup. A
value of "0" is used to indicate that no file was present during
startup.
This metric was generated to correspond to the Legacy Telemetry
scalar startup.profile_database_version.
bugs:
data_reviews:
notification_emails:
- dtownsend@mozilla.com
- kbryant@mozilla.com
expires: 147
telemetry_mirror: STARTUP_PROFILE_DATABASE_VERSION
profile_count:
type: quantity
description: >
This records the number of known profiles after startup completes.
This includes any profiles that were created during startup.
This metric was generated to correspond to the Legacy Telemetry
scalar startup.profile_count.
bugs:
data_reviews:
notification_emails:
- dtownsend@mozilla.com
- kbryant@mozilla.com
expires: 147
unit: profiles
telemetry_mirror: STARTUP_PROFILE_COUNT
profiles:
creation_date:
type: quantity
unit: days since Jan 1 1970
lifetime: application
description: |
The day the profile was created,
as determined by checking various file metadata in the profile directory.
Not considered to be particularly reliable in practice.
Prefer `client_info.first_run_date` in most cases.
e.g. 16446
bugs:
data_reviews:
data_sensitivity:
- technical
notification_emails:
- dtownsend@mozilla.com
expires: never
send_in_pings:
- metrics
- heartbeat
- update
reset_date:
type: quantity
unit: days since Jan 1 1970
lifetime: application
description: |
Optional.
The day the profile was most recently reset,
persisted in `times.json`.
e.g. 16446
bugs:
data_reviews:
data_sensitivity:
- technical
notification_emails:
- dtownsend@mozilla.com
expires: never
send_in_pings:
- metrics
- update
first_use_date:
type: quantity
unit: days since Jan 1 1970
lifetime: application
description: |
Optional.
The day the profile was first used,
as determined by noticing that `times.json` wasn't present.
Prefer `client_info.first_run_date` in most cases.
e.g. 16446
bugs:
data_reviews:
data_sensitivity:
- technical
notification_emails:
- dtownsend@mozilla.com
expires: never
send_in_pings:
- metrics
- heartbeat
- update
recovered_from_backup:
type: quantity
unit: days since Jan 1 1970
lifetime: application
description: |
Optional.
The day the profile was recovered from backup,
persisted in `times.json`.
e.g. 16446
bugs:
data_reviews:
data_sensitivity:
- technical
notification_emails:
- mconley@mozilla.com
- dtownsend@mozilla.com
expires: never
send_in_pings:
- metrics
- update