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:
- "Firefox :: Nimbus Desktop Client"
nimbus_events:
enrollment:
type: event
description: >
Recorded when a user has met the conditions and is first bucketed into an
experiment (i.e. targeting matched and they were randomized into a bucket
and branch of the experiment). Expected a maximum of once per experiment
per user.
extra_keys:
experiment:
type: string
description: The slug/unique identifier of the experiment
branch:
type: string
description: The branch slug/identifier that was randomly chosen
experiment_type:
type: string
description: Indicates whether this is an experiemnt or rollout
bugs:
data_reviews:
data_sensitivity:
- technical
notification_emails:
- tlong@mozilla.com
- nimbus-team@mozilla.com
expires: never
send_in_pings:
- background-update
- events
enroll_failed:
type: event
description: >
Recorded when an enrollment fails, including the reason for the failure.
extra_keys:
experiment:
type: string
description: The slug/unique identifier of the experiment
reason:
type: string
description: The reason for the enrollment failure
branch:
type: string
description: If reason == "invalid-branch", this is the invalid branch.
bugs:
data_reviews:
data_sensitivity:
- technical
notification_emails:
- tlong@mozilla.com
- nimbus-team@mozilla.com
expires: never
send_in_pings:
- background-update
- events
unenrollment:
type: event
description: >
Recorded when either telemetry is disabled, or the experiment has run
for its designed duration (i.e. it is no longer present in the Nimbus
Remote Settings collection)
extra_keys:
experiment:
type: string
description: The slug/unique identifier of the experiment
branch:
type: string
description: The branch slug/identifier that was randomly chosen
reason:
type: string
description: The reason for the unenrollment
changed_pref:
type: string
description: >
If reason == "changed-pref", then this contains the name of the pref
that changed that caused the unenrollment.
conflicting_slug:
type: string
description: >
If reason == "prefFlips-conflict", the slug of the conflicting
experiment that caused the unenrollment.
pref_name:
type: string
description: >
If reason == "prefFlips-failed", the name of the pref that failed to set.
pref_type:
type: string
description: >
If reason == "prefFlips-failed", The type of the existing pref value
(one of "bool", "string", "int", or "invalid").
bugs:
data_reviews:
data_sensitivity:
- technical
notification_emails:
- tlong@mozilla.com
- nimbus-team@mozilla.com
expires: never
send_in_pings:
- background-update
- events
unenroll_failed:
type: event
description: >
Recorded when an unenrollment fails, including the reason for the failure.
extra_keys:
experiment:
type: string
description: The slug/unique identifier of the experiment
reason:
type: string
description: The reason for the unenrollment failure
bugs:
data_reviews:
data_sensitivity:
- technical
notification_emails:
- tlong@mozilla.com
- nimbus-team@mozilla.com
expires: never
send_in_pings:
- background-update
- events
exposure:
type: event
description: >
Recorded when a user actually observes an experimental treatment, or
would have observed an experimental treatment if they had been in a
branch that would have shown one.
extra_keys:
experiment:
type: string
description: The slug/unique identifier of the experiment
branch:
type: string
description: The branch slug/identifier that was randomly chosen
feature_id:
type: string
description: A unique identifier for the feature that was exposed
bugs:
data_reviews:
data_sensitivity:
- technical
notification_emails:
- tlong@mozilla.com
- nimbus-team@mozilla.com
expires: never
send_in_pings:
- background-update
- events
validation_failed:
type: event
description: >
This records when validation of a recipe fails.
extra_keys:
experiment:
type: string
description: The slug/unique identifier of the experiment
reason:
type: string
description: >
Why validation failed (one of "invalid-recipe", "invalid-branch",
"invalid-reason", "missing-locale", or "missing-l10n-entry").
branch:
type: string
description: >
If reason == invalid-branch, the branch that failed validation.
feature:
type: string
description: If reason == invalid-feature, the invalid feature ID.
locale:
type: string
description: >
If reason == missing-locale, the locale that was missing from the
localization table.
If reason == missing-l10n-entry, the locale that was missing the
localization entries.
l10n_ids:
type: string
description: >
If reason == missing-l10n-entry, a comma-sparated list of missing
localization entries.
bugs:
data_reviews:
data_sensitivity:
- technical
notification_emails:
- beth@mozilla.com
expires: never
send_in_pings:
- background-update
- events
is_ready:
type: event
description: >
An event sent when Nimbus is ready — sent upon completion of each update of the recipes.
bugs:
data_reviews:
data_sensitivity:
- technical
notification_emails:
- chumphreys@mozilla.com
- project-nimbus@mozilla.com
expires: 180
enrollment_status:
type: event
description: >
Recorded for each enrollment status each time the SDK completes application of pending experiments.
extra_keys:
slug:
type: string
description: The slug/unique identifier of the experiment
status:
type: string
description: The status of this enrollment
reason:
type: string
description: The reason the client is in the noted status
branch:
type: string
description: The branch slug/identifier that was randomly chosen (if the client is enrolled)
error_string:
type: string
description: If the enrollment resulted in an error, the associated error string
conflict_slug:
type: string
description: If the enrollment hit a feature conflict, the slug of the conflicting experiment/rollout
bugs:
data_reviews:
data_sensitivity:
- technical
notification_emails:
- chumphreys@mozilla.com
- project-nimbus@mozilla.com
expires: never
disabled: true
normandy:
expose_nimbus_experiment:
type: event
description: >
This records an event at the moment the user is exposed to an
experiment treatment. The event is triggered either by the code
checking that a certain experiment feature is enabled or when that
feature value is used. This is different from enrollment or
experiment activation because it registers when a user actually gets
exposed to the experiment feature.
This event was generated to correspond to the Legacy Telemetry event
normandy.expose#nimbus_experiment.
bugs:
data_reviews:
notification_emails:
- ujet@mozilla.com
expires: never
extra_keys:
value:
description: >
The `value` of the event. Mirrors to the Legacy Telemetry
event's `value` parameter.
The experiment slug.
type: string
branchSlug:
description: >
The slug for the branch the user is enrolled in.
type: string
featureId:
description: >
The type of experiment variant the user was enrolled into.
type: string
telemetry_mirror: Normandy_Expose_NimbusExperiment