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
### "FOG", "Glean", and "Glean SDK" should remain in English.
-fog-brand-name = FOG
-glean-brand-name = Glean
glean-sdk-brand-name = { -glean-brand-name } SDK
glean-debug-ping-viewer-brand-name = { -glean-brand-name } Debug Ping Viewer
about-glean-page-title2 = About { -glean-brand-name }
about-glean-header = About { -glean-brand-name }
about-glean-interface-description =
The <a data-l10n-name="glean-sdk-doc-link">{ glean-sdk-brand-name }</a>
is a data collection library used in { -vendor-short-name } projects.
This interface is designed to be used by developers and testers to manually
<a data-l10n-name="fog-link">test instrumentation</a>.
about-glean-upload-enabled = Data upload is enabled.
about-glean-upload-disabled = Data upload is disabled.
about-glean-upload-enabled-local = Data upload is enabled only for sending to a local server.
about-glean-upload-fake-enabled =
Data upload is disabled,
but we’re lying and telling the { glean-sdk-brand-name } it is enabled
so that data is still recorded locally.
Note: If you set a debug tag, pings will be uploaded to the
<a data-l10n-name="glean-debug-ping-viewer">{ glean-debug-ping-viewer-brand-name }</a> regardless of settings.
# This message is followed by a bulleted list.
about-glean-prefs-and-defines = Relevant <a data-l10n-name="fog-prefs-and-defines-doc-link">preferences and defines</a> include:
# Variables:
# $data-upload-pref-value (String): the value of the datareporting.healthreport.uploadEnabled pref. Typically "true", sometimes "false"
# Do not translate strings between <code> </code> tags.
about-glean-data-upload = <code>datareporting.healthreport.uploadEnabled</code>: { $data-upload-pref-value }
# Variables:
# $local-port-pref-value (Integer): the value of the telemetry.fog.test.localhost_port pref. Typically 0. Can be negative.
# Do not translate strings between <code> </code> tags.
about-glean-local-port = <code>telemetry.fog.test.localhost_port</code>: { $local-port-pref-value }
# Variables:
# $glean-android-define-value (Boolean): the value of the MOZ_GLEAN_ANDROID define. Typically "false", sometimes "true".
# Do not translate strings between <code> </code> tags.
about-glean-glean-android = <code>MOZ_GLEAN_ANDROID</code>: { $glean-android-define-value }
# Variables:
# $moz-official-define-value (Boolean): the value of the MOZILLA_OFFICIAL define.
# Do not translate strings between <code> </code> tags.
about-glean-moz-official =<code>MOZILLA_OFFICIAL</code>: { $moz-official-define-value }
about-glean-about-testing-header = About Testing
# This message is followed by a numbered list.
about-glean-manual-testing =
Full instructions are documented in the
<a data-l10n-name="fog-instrumentation-test-doc-link">{ -fog-brand-name } instrumentation testing docs</a>
and in the <a data-l10n-name="glean-sdk-doc-link">{ glean-sdk-brand-name } documentation</a>,
but, in short, to manually test that your instrumentation works, you should:
# This message is an option in a dropdown filled with untranslated names of pings.
about-glean-no-ping-label = (don’t submit any ping)
# An in-line text input field precedes this string.
about-glean-label-for-tag-pings-with-requirements =
Set a memorable debug tag <span>(20 characters or fewer, alphanumerics and - only)</span> so you can recognize your pings later.
# An in-line drop down list precedes this string.
# Do not translate strings between <code> </code> tags.
about-glean-label-for-ping-names =
Select from the preceding list the ping your instrumentation is in.
If it’s in a <a data-l10n-name="custom-ping-link">custom ping</a>, choose that one.
Otherwise, the default for <code>event</code> metrics is
the <code>events</code> ping
and the default for all other metrics is
the <code>metrics</code> ping.
# An in-line check box precedes this string.
about-glean-label-for-log-pings =
(Optional. Check the preceding box if you want pings to also be logged when they are submitted.
You will additionally need to <a data-l10n-name="enable-logging-link">enable logging</a>.)
# Variables
# $debug-tag (String): The user-set value of the debug tag input on this page. Like "about-glean-kV"
# An in-line button labeled "Apply settings and submit ping" precedes this string.
about-glean-label-for-controls-submit =
Press the preceding button to tag all { -glean-brand-name } pings with your tag and submit the selected ping.
(All pings submitted from then until you restart the application will be tagged with
<code>{ $debug-tag }</code>.)
about-glean-li-for-visit-gdpv =
<a data-l10n-name="gdpv-tagged-pings-link">Visit the { glean-debug-ping-viewer-brand-name } page for pings with your tag</a>.
It shouldn’t take more than a few seconds from pushing the button to your ping arriving.
Sometimes it may take a small handful of minutes.
# Do not translate strings between <code> </code> tags.
about-glean-adhoc-explanation2 =
For more <i>ad hoc</i> testing,
you can also determine the current value of a particular piece of instrumentation
by opening a devtools console here on <code>about:glean</code>
and using the <code>testGetValue()</code> API like
<code>Glean.metricCategory.metricName.testGetValue()</code>
for a metric named <code>metric.category.metric_name</code>.
# Do not translate strings between <code> </code> tags.
about-glean-adhoc-note =
Please note that you are using the Glean JS API by using the devtools console.
This means the metric category and metric name are formatted in
<code>camelCase</code> unlike in the Rust and C++ APIs.
controls-button-label-verbose = Apply settings and submit ping
about-glean-about-data-header = About Data
about-glean-about-data-explanation =
To browse the list of collected data, please consult the
<a data-l10n-name="glean-dictionary-link">{ -glean-brand-name } Dictionary</a>.