Adding upstream version 115.7.0esr.upstream/115.7.0esr

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

3 files changed, 2377 insertions, 0 deletions

diff --git a/toolkit/components/telemetry/geckoview/streaming/GeckoViewStreamingTelemetry.cpp b/toolkit/components/telemetry/geckoview/streaming/GeckoViewStreamingTelemetry.cpp
new file mode 100644
index 0000000000..6c4b9590c0
--- /dev/null
+++ b/toolkit/components/telemetry/geckoview/streaming/GeckoViewStreamingTelemetry.cpp
@@ -0,0 +1,282 @@
+/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
+/* vim: set ts=8 sts=2 et sw=2 tw=80: */
+/* 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/. */
+
+#include "GeckoViewStreamingTelemetry.h"
+
+#include "mozilla/Assertions.h"
+#include "mozilla/Services.h"
+#include "mozilla/StaticMutex.h"
+#include "mozilla/StaticPtr.h"
+#include "mozilla/StaticPrefs_toolkit.h"
+#include "mozilla/TimeStamp.h"
+#include "nsTHashMap.h"
+#include "nsIObserver.h"
+#include "nsIObserverService.h"
+#include "nsITimer.h"
+#include "nsTArray.h"
+#include "nsThreadUtils.h"
+
+using mozilla::Runnable;
+using mozilla::StaticMutex;
+using mozilla::StaticMutexAutoLock;
+using mozilla::StaticRefPtr;
+using mozilla::TimeStamp;
+
+// Batches and streams Telemetry samples to a JNI delegate which will
+// (presumably) do something with the data. Expected to be used to route data
+// up to the Android Components layer to be translated into Glean metrics.
+namespace GeckoViewStreamingTelemetry {
+
+class LifecycleObserver;
+void SendBatch(const StaticMutexAutoLock& aLock);
+
+// Topic on which we flush the batch.
+static const char* const kApplicationBackgroundTopic = "application-background";
+
+static StaticMutex gMutex MOZ_UNANNOTATED;
+
+// -- The following state is accessed across threads.
+// -- Do not touch these if you do not hold gMutex.
+
+// The time the batch began.
+TimeStamp gBatchBegan;
+// The batch of histograms and samples.
+typedef nsTHashMap<nsCStringHashKey, nsTArray<uint32_t>> HistogramBatch;
+HistogramBatch gBatch;
+HistogramBatch gCategoricalBatch;
+// The batches of Scalars and their values.
+typedef nsTHashMap<nsCStringHashKey, bool> BoolScalarBatch;
+BoolScalarBatch gBoolScalars;
+typedef nsTHashMap<nsCStringHashKey, nsCString> StringScalarBatch;
+StringScalarBatch gStringScalars;
+typedef nsTHashMap<nsCStringHashKey, uint32_t> UintScalarBatch;
+UintScalarBatch gUintScalars;
+// The delegate to receive the samples and values.
+StaticRefPtr<StreamingTelemetryDelegate> gDelegate;
+// Lifecycle observer used to flush the batch when backgrounded.
+StaticRefPtr<LifecycleObserver> gObserver;
+
+// -- End of gMutex-protected thread-unsafe-accessed data
+
+// Timer that ensures data in the batch never gets too stale.
+// This timer may only be manipulated on the Main Thread.
+StaticRefPtr<nsITimer> gJICTimer;
+
+class LifecycleObserver final : public nsIObserver {
+ public:
+  NS_DECL_ISUPPORTS
+  NS_DECL_NSIOBSERVER
+
+  LifecycleObserver() = default;
+
+ protected:
+  ~LifecycleObserver() = default;
+};
+
+NS_IMPL_ISUPPORTS(LifecycleObserver, nsIObserver);
+
+NS_IMETHODIMP
+LifecycleObserver::Observe(nsISupports* aSubject, const char* aTopic,
+                           const char16_t* aData) {
+  if (!strcmp(aTopic, kApplicationBackgroundTopic)) {
+    StaticMutexAutoLock lock(gMutex);
+    SendBatch(lock);
+  }
+  return NS_OK;
+}
+
+void RegisterDelegate(const RefPtr<StreamingTelemetryDelegate>& aDelegate) {
+  StaticMutexAutoLock lock(gMutex);
+  gDelegate = aDelegate;
+}
+
+class SendBatchRunnable : public Runnable {
+ public:
+  explicit SendBatchRunnable(RefPtr<StreamingTelemetryDelegate> aDelegate,
+                             HistogramBatch&& aBatch,
+                             HistogramBatch&& aCategoricalBatch,
+                             BoolScalarBatch&& aBoolScalars,
+                             StringScalarBatch&& aStringScalars,
+                             UintScalarBatch&& aUintScalars)
+      : Runnable("SendBatchRunnable"),
+        mDelegate(std::move(aDelegate)),
+        mBatch(std::move(aBatch)),
+        mCategoricalBatch(std::move(aCategoricalBatch)),
+        mBoolScalars(std::move(aBoolScalars)),
+        mStringScalars(std::move(aStringScalars)),
+        mUintScalars(std::move(aUintScalars)) {}
+
+  NS_IMETHOD Run() override {
+    MOZ_ASSERT(NS_IsMainThread());
+    MOZ_ASSERT(mDelegate);
+
+    if (gJICTimer) {
+      gJICTimer->Cancel();
+    }
+
+    for (const auto& entry : mBatch) {
+      const nsCString& histogramName = PromiseFlatCString(entry.GetKey());
+      const nsTArray<uint32_t>& samples = entry.GetData();
+
+      mDelegate->ReceiveHistogramSamples(histogramName, samples);
+    }
+    mBatch.Clear();
+
+    for (const auto& entry : mCategoricalBatch) {
+      const nsCString& histogramName = PromiseFlatCString(entry.GetKey());
+      const nsTArray<uint32_t>& samples = entry.GetData();
+
+      mDelegate->ReceiveCategoricalHistogramSamples(histogramName, samples);
+    }
+    mCategoricalBatch.Clear();
+
+    for (const auto& entry : mBoolScalars) {
+      const nsCString& scalarName = PromiseFlatCString(entry.GetKey());
+      mDelegate->ReceiveBoolScalarValue(scalarName, entry.GetData());
+    }
+    mBoolScalars.Clear();
+
+    for (const auto& entry : mStringScalars) {
+      const nsCString& scalarName = PromiseFlatCString(entry.GetKey());
+      const nsCString& scalarValue = PromiseFlatCString(entry.GetData());
+      mDelegate->ReceiveStringScalarValue(scalarName, scalarValue);
+    }
+    mStringScalars.Clear();
+
+    for (const auto& entry : mUintScalars) {
+      const nsCString& scalarName = PromiseFlatCString(entry.GetKey());
+      mDelegate->ReceiveUintScalarValue(scalarName, entry.GetData());
+    }
+    mUintScalars.Clear();
+
+    return NS_OK;
+  }
+
+ private:
+  RefPtr<StreamingTelemetryDelegate> mDelegate;
+  HistogramBatch mBatch;
+  HistogramBatch mCategoricalBatch;
+  BoolScalarBatch mBoolScalars;
+  StringScalarBatch mStringScalars;
+  UintScalarBatch mUintScalars;
+};  // class SendBatchRunnable
+
+// Can be called on any thread.
+// NOTE: Pay special attention to what you call in this method as if it
+// accumulates to a gv-streaming-enabled probe we will deadlock the calling
+// thread.
+void SendBatch(const StaticMutexAutoLock& aLock) {
+  if (!gDelegate) {
+    NS_WARNING(
+        "Being asked to send Streaming Telemetry with no registered Streaming "
+        "Telemetry Delegate. Will try again later.");
+    // Give us another full Batch Duration to register a delegate.
+    gBatchBegan = TimeStamp::Now();
+    return;
+  }
+
+  // To make it so accumulations within the delegation don't deadlock us,
+  // move the batches' contents into the Runner.
+  HistogramBatch histogramCopy;
+  gBatch.SwapElements(histogramCopy);
+  HistogramBatch categoricalCopy;
+  gCategoricalBatch.SwapElements(categoricalCopy);
+  BoolScalarBatch boolScalarCopy;
+  gBoolScalars.SwapElements(boolScalarCopy);
+  StringScalarBatch stringScalarCopy;
+  gStringScalars.SwapElements(stringScalarCopy);
+  UintScalarBatch uintScalarCopy;
+  gUintScalars.SwapElements(uintScalarCopy);
+  RefPtr<SendBatchRunnable> runnable = new SendBatchRunnable(
+      gDelegate, std::move(histogramCopy), std::move(categoricalCopy),
+      std::move(boolScalarCopy), std::move(stringScalarCopy),
+      std::move(uintScalarCopy));
+
+  // To make things easier for the delegate, dispatch to the main thread.
+  NS_DispatchToMainThread(runnable);
+}
+
+// Can be called on any thread.
+void BatchCheck(const StaticMutexAutoLock& aLock) {
+  if (!gObserver) {
+    gObserver = new LifecycleObserver();
+    nsCOMPtr<nsIObserverService> os = mozilla::services::GetObserverService();
+    if (os) {
+      os->AddObserver(gObserver, kApplicationBackgroundTopic, false);
+    }
+  }
+  if (gBatchBegan.IsNull()) {
+    // Time to begin a new batch.
+    gBatchBegan = TimeStamp::Now();
+    // Set a just-in-case timer to enforce an upper-bound on batch staleness.
+    NS_DispatchToMainThread(NS_NewRunnableFunction(
+        "GeckoviewStreamingTelemetry::ArmTimer", []() -> void {
+          if (!gJICTimer) {
+            gJICTimer = NS_NewTimer().take();
+          }
+          if (gJICTimer) {
+            gJICTimer->InitWithNamedFuncCallback(
+                [](nsITimer*, void*) -> void {
+                  StaticMutexAutoLock locker(gMutex);
+                  SendBatch(locker);
+                },
+                nullptr,
+                mozilla::StaticPrefs::
+                    toolkit_telemetry_geckoview_maxBatchStalenessMS(),
+                nsITimer::TYPE_ONE_SHOT_LOW_PRIORITY,
+                "GeckoviewStreamingTelemetry::SendBatch");
+          }
+        }));
+  }
+  double batchDurationMs = (TimeStamp::Now() - gBatchBegan).ToMilliseconds();
+  if (batchDurationMs >
+      mozilla::StaticPrefs::toolkit_telemetry_geckoview_batchDurationMS()) {
+    SendBatch(aLock);
+    gBatchBegan = TimeStamp();
+  }
+}
+
+// Can be called on any thread.
+void HistogramAccumulate(const nsCString& aName, bool aIsCategorical,
+                         uint32_t aValue) {
+  StaticMutexAutoLock lock(gMutex);
+
+  if (aIsCategorical) {
+    nsTArray<uint32_t>& samples = gCategoricalBatch.LookupOrInsert(aName);
+    samples.AppendElement(aValue);
+  } else {
+    nsTArray<uint32_t>& samples = gBatch.LookupOrInsert(aName);
+    samples.AppendElement(aValue);
+  }
+
+  BatchCheck(lock);
+}
+
+void BoolScalarSet(const nsCString& aName, bool aValue) {
+  StaticMutexAutoLock lock(gMutex);
+
+  gBoolScalars.InsertOrUpdate(aName, aValue);
+
+  BatchCheck(lock);
+}
+
+void StringScalarSet(const nsCString& aName, const nsCString& aValue) {
+  StaticMutexAutoLock lock(gMutex);
+
+  gStringScalars.InsertOrUpdate(aName, aValue);
+
+  BatchCheck(lock);
+}
+
+void UintScalarSet(const nsCString& aName, uint32_t aValue) {
+  StaticMutexAutoLock lock(gMutex);
+
+  gUintScalars.InsertOrUpdate(aName, aValue);
+
+  BatchCheck(lock);
+}
+
+}  // namespace GeckoViewStreamingTelemetry
diff --git a/toolkit/components/telemetry/geckoview/streaming/GeckoViewStreamingTelemetry.h b/toolkit/components/telemetry/geckoview/streaming/GeckoViewStreamingTelemetry.h
new file mode 100644
index 0000000000..458224a3c2
--- /dev/null
+++ b/toolkit/components/telemetry/geckoview/streaming/GeckoViewStreamingTelemetry.h
@@ -0,0 +1,55 @@
+/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
+/* vim: set ts=8 sts=2 et sw=2 tw=80: */
+/* 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/. */
+
+#ifndef GeckoViewStreamingTelemetry_h__
+#define GeckoViewStreamingTelemetry_h__
+
+#include "mozilla/Assertions.h"
+#include "mozilla/RefPtr.h"
+#include "nsISupports.h"
+#include "nsStringFwd.h"
+#include "nsTArray.h"
+
+#include <cstdint>
+
+namespace GeckoViewStreamingTelemetry {
+
+void HistogramAccumulate(const nsCString& aName, bool aIsCategorical,
+                         uint32_t aValue);
+
+void BoolScalarSet(const nsCString& aName, bool aValue);
+void StringScalarSet(const nsCString& aName, const nsCString& aValue);
+void UintScalarSet(const nsCString& aName, uint32_t aValue);
+
+// Classes wishing to receive Streaming Telemetry must implement this interface
+// and register themselves via RegisterDelegate.
+class StreamingTelemetryDelegate {
+ public:
+  NS_INLINE_DECL_THREADSAFE_REFCOUNTING(StreamingTelemetryDelegate)
+
+  // Receive* methods will be called from time to time on the main thread.
+  virtual void ReceiveHistogramSamples(const nsCString& aName,
+                                       const nsTArray<uint32_t>& aSamples) = 0;
+  virtual void ReceiveCategoricalHistogramSamples(
+      const nsCString& aName, const nsTArray<uint32_t>& aSamples) = 0;
+  virtual void ReceiveBoolScalarValue(const nsCString& aName, bool aValue) = 0;
+  virtual void ReceiveStringScalarValue(const nsCString& aName,
+                                        const nsCString& aValue) = 0;
+  virtual void ReceiveUintScalarValue(const nsCString& aName,
+                                      uint32_t aValue) = 0;
+
+ protected:
+  virtual ~StreamingTelemetryDelegate() = default;
+};
+
+// Registers the provided StreamingTelemetryDelegate to receive Streaming
+// Telemetry, overwriting any previous delegate registration.
+// Call on any thread.
+void RegisterDelegate(const RefPtr<StreamingTelemetryDelegate>& aDelegate);
+
+}  // namespace GeckoViewStreamingTelemetry
+
+#endif  // GeckoViewStreamingTelemetry_h__
diff --git a/toolkit/components/telemetry/geckoview/streaming/metrics.yaml b/toolkit/components/telemetry/geckoview/streaming/metrics.yaml
new file mode 100644
index 0000000000..11e7121edd
--- /dev/null
+++ b/toolkit/components/telemetry/geckoview/streaming/metrics.yaml
@@ -0,0 +1,2040 @@
+# 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/.
+
+# This file defines the metrics that are recorded by the Glean SDK. They are
+# automatically converted to platform-specific code at build time using the
+# `glean_parser` PyPI package.
+
+# Adding a new metric? Please don't!
+# (At least not without the permission of a Telemetry Module Peer)
+
+---
+$schema: moz://mozilla.org/schemas/glean/metrics/2-0-0
+
+geckoview:
+  version:
+    description: >
+      The version of the Gecko engine, example: 74.0a1
+    type: string
+    # Temporary misuse of the user lifetime approved by Glean team
+    # due to limitations in Geckoview streaming telemetry.
+    # DO NOT DUPLICATE unless approved by Glean team.
+    lifetime: user
+    gecko_datapoint: gecko.version
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1611240
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1611240#c2
+    notification_emails:
+      - gfx-telemetry-alerts@mozilla.com
+    expires: never
+
+  build_id:
+    description: >
+      The Buildid of the Gecko engine, example: 20200205124310
+    type: string
+    # Temporary misuse of the user lifetime approved by Glean team
+    # due to limitations in Geckoview streaming telemetry.
+    # DO NOT DUPLICATE unless approved by Glean team.
+    lifetime: user
+    gecko_datapoint: gecko.build_id
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1611240
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1611240#c2
+    notification_emails:
+      - gfx-telemetry-alerts@mozilla.com
+    expires: never
+
+  content_process_lifetime:
+    type: timing_distribution
+    time_unit: millisecond
+    gecko_datapoint: GV_CONTENT_PROCESS_LIFETIME_MS
+    description: >
+      The uptime of content processes in ms
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1625325
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1625325#c2
+    notification_emails:
+      - android-probes@mozilla.com
+    expires: never
+
+  page_load_progress_time:
+    type: timing_distribution
+    time_unit: millisecond
+    gecko_datapoint: GV_PAGE_LOAD_PROGRESS_MS
+    description: >
+      Time between page load progress starts (0) and completion (100).
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1499418
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
+    notification_emails:
+      - android-probes@mozilla.com
+    expires: never
+
+  page_load_time:
+    type: timing_distribution
+    time_unit: millisecond
+    gecko_datapoint: GV_PAGE_LOAD_MS
+    description: >
+      The time taken to load a page. This includes all static contents, no
+      dynamic content.
+      Loading of about: pages is not counted.
+      Back back navigation (sometimes via BFCache) is included which is a
+      source of bimodality due to the <50ms load times.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1499418
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
+    notification_emails:
+      - android-probes@mozilla.com
+    expires: never
+
+  page_reload_time:
+    type: timing_distribution
+    time_unit: millisecond
+    gecko_datapoint: GV_PAGE_RELOAD_MS
+    description: >
+      Time taken to reload a page.
+      This includes all static contents, no dynamic content.
+      Loading of about: pages is not counted.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1549519
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
+    notification_emails:
+      - android-probes@mozilla.com
+      - sefeng@mozilla.com
+      - perf-telemetry-alerts@mozilla.com
+    expires: never
+
+  startup_runtime:
+    type: timing_distribution
+    time_unit: millisecond
+    gecko_datapoint: GV_STARTUP_RUNTIME_MS
+    description: >
+      The time taken to initialize GeckoRuntime.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1499418
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
+    notification_emails:
+      - android-probes@mozilla.com
+    expires: never
+
+  document_site_origins:
+    type: custom_distribution
+    description: >
+      When a document is loaded, report the
+      number of [site origins](https://searchfox.org/
+      mozilla-central/rev/
+      3300072e993ae05d50d5c63d815260367eaf9179/
+      caps/nsIPrincipal.idl#264) of the entire browser
+      if it has been at least 5 minutes since last
+      time we collect this data.
+    range_min: 0
+    range_max: 100
+    bucket_count: 50
+    histogram_type: exponential
+    unit: number of site_origin
+    gecko_datapoint: FX_NUMBER_OF_UNIQUE_SITE_ORIGINS_ALL_TABS
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1589700
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1589700#c5
+    notification_emails:
+      - sefeng@mozilla.com
+      - perf-telemetry-alerts@mozilla.com
+    expires: never
+
+  per_document_site_origins:
+    type: custom_distribution
+    description: >
+      When a document is unloaded, report the highest number of
+      [site origins](https://searchfox.org/
+      mozilla-central/rev/
+      3300072e993ae05d50d5c63d815260367eaf9179/
+      caps/nsIPrincipal.idl#264) loaded simultaneously in that
+      document.
+    range_min: 0
+    range_max: 100
+    bucket_count: 50
+    histogram_type: exponential
+    unit: number of site origins per document
+    gecko_datapoint: FX_NUMBER_OF_UNIQUE_SITE_ORIGINS_PER_DOCUMENT
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1603185
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1603185#c13
+    notification_emails:
+      - barret@mozilla.com
+      - perf-telemetry-alerts@mozilla.com
+    expires: never
+
+gfx:
+  composite_time:
+    type: timing_distribution
+    time_unit: millisecond
+    gecko_datapoint: COMPOSITE_TIME
+    description: >
+      The time taken to composite a frame.
+      On non-webrender this is the time taken in
+      `CompositorBridgeParent::CompositeToTarget()`.
+      On webrender, this is the time taken from the start of
+      `WebRenderBridgeParent::CompositeToTarget()`,
+      until the render thread has rendered the frame (in
+      `RenderThread::HandleFrameOneDoc()`).
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1080160
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1529352
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580129
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580129#c7
+    notification_emails:
+      - gfx-telemetry-alerts@mozilla.com
+      - jnicol@mozilla.com
+    expires: never
+
+  scroll_present_latency:
+    type: timing_distribution
+    time_unit: millisecond
+    description: >
+      Time between receiving a scroll
+      event on the event loop and compositing
+      its result onto the screen (ms).
+    gecko_datapoint: SCROLL_PRESENT_LATENCY
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1604818
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1604818#c4
+    notification_emails:
+      - sefeng@mozilla.com
+      - perf-telemetry-alerts@mozilla.com
+    expires: never
+
+gfx.checkerboard:
+  duration:
+    type: timing_distribution
+    time_unit: millisecond
+    gecko_datapoint: CHECKERBOARD_DURATION
+    description: >
+      The duration of a checkerboard event.
+      Checkerboarding is when painting has not kept up with asynchronous
+      panning and zooming so the compositor has to display a "checkerboard
+      pattern" (or in practice, the background color) rather than the actual
+      page content.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1238040
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1539309
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
+    notification_emails:
+      - gfx-telemetry-alerts@mozilla.com
+      - botond@mozilla.com
+    expires: never
+
+  peak_pixel_count:
+    type: custom_distribution
+    range_max: 66355200
+    bucket_count: 50
+    histogram_type: exponential
+    unit: Pixels
+    gecko_datapoint: CHECKERBOARD_PEAK
+    description: >
+      The peak number of CSS pixels that checkerboarded during a checkerboard
+      event. The minimum value of the largest histogram bucket is the size of
+      a 4k display with maximum APZ zooming.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1238040
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1539309
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
+    notification_emails:
+      - gfx-telemetry-alerts@mozilla.com
+      - botond@mozilla.com
+    expires: never
+
+  potential_duration:
+    type: timing_distribution
+    time_unit: millisecond
+    gecko_datapoint: CHECKERBOARD_POTENTIAL_DURATION
+    description: >
+      The total amount of time that we could reasonably be checkerboarding.
+      This is the union of two possibly-intersecting sets of time periods:
+      The first set is that in which checkerboarding was actually happening,
+      since by definition it could potentially be happening.
+      The second set is that in which the APZC is actively transforming content
+      in the compositor, since it could potentially transform it so as to
+      display checkerboarding to the user. Combined with other information,
+      this allows us to meaningfully say how frequently users actually
+      enncounters checkerboarding.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1238040
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1539309
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
+    notification_emails:
+      - gfx-telemetry-alerts@mozilla.com
+      - botond@mozilla.com
+    expires: never
+
+  severity:
+    type: custom_distribution
+    range_max: 1073741824
+    bucket_count: 50
+    histogram_type: exponential
+    unit: Opaque unit
+    gecko_datapoint: CHECKERBOARD_SEVERITY
+    description: >
+      An opaque measurement of the severity of a checkerboard event.
+      This doesn't have units, it's just useful for comparing two checkerboard
+      events to see which one is worse, for some implementation-specific
+      definition of "worse". The larger the value, the worse the
+      checkerboarding.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1238040
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1539309
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
+    notification_emails:
+      - gfx-telemetry-alerts@mozilla.com
+      - botond@mozilla.com
+    expires: never
+
+gfx.content:
+  paint_time:
+    type: timing_distribution
+    time_unit: millisecond
+    gecko_datapoint: CONTENT_PAINT_TIME
+    description: >
+      Time spent in the main-thread paint pipeline for content.
+      For non-webrender, this includes display list building, layer building,
+      and when OMTP is disabled, rasterization.
+      For webrender, this includes display list building, and webrender display
+      list building.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1309442
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1489524
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
+    notification_emails:
+      - gfx-telemetry-alerts@mozilla.com
+    expires: never
+
+  full_paint_time:
+    type: timing_distribution
+    time_unit: millisecond
+    gecko_datapoint: CONTENT_FULL_PAINT_TIME
+    description: >
+      Time spent in the full paint pipeline for content until it's ready for
+      composition.
+      For non-webrender this includes `paint_time`, plus rasterization if OMTP
+      is enabled.
+      For webrender, this includes `paint_time`, plus scene building time.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1505858
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
+    notification_emails:
+      - gfx-telemetry-alerts@mozilla.com
+      - jmuizelaar@mozilla.com
+    expires: never
+
+gfx.content.frame_time:
+  from_paint:
+    type: custom_distribution
+    range_max: 5000
+    bucket_count: 50
+    histogram_type: exponential
+    unit: Percentage of vsync interval
+    gecko_datapoint: CONTENT_FRAME_TIME
+    description: >
+      The time, in percentage of a vsync interval, spent from beginning a paint
+      in the content process until that frame is presented in the compositor.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1470528
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1509536
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
+    notification_emails:
+      - gfx-telemetry-alerts@mozilla.com
+      - jnicol@mozilla.com
+    expires: never
+
+  from_vsync:
+    type: custom_distribution
+    range_min: 8
+    range_max: 792
+    bucket_count: 100
+    histogram_type: linear
+    unit: Percentage of vsync interval
+    gecko_datapoint: CONTENT_FRAME_TIME_VSYNC
+    description: >
+      The time, in percentage of a vsync interval, spent from the vsync that
+      started a paint in the content process until that frame is presented in
+      the compositor.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1517355
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
+    notification_emails:
+      - gfx-telemetry-alerts@mozilla.com
+    expires: never
+
+  with_svg:
+    type: custom_distribution
+    range_max: 5000
+    bucket_count: 50
+    histogram_type: exponential
+    unit: Percentage of vsync interval
+    gecko_datapoint: CONTENT_FRAME_TIME_WITH_SVG
+    description: >
+      The time, in percentage of a vsync interval, spent from beginning a paint
+      in the content process until that frame is presented in the compositor,
+      for frames that contained an SVG to be drawn by webrender.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1483549
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1509536
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
+    notification_emails:
+      - gfx-telemetry-alerts@mozilla.com
+    expires: never
+
+  without_resource_upload:
+    type: custom_distribution
+    range_max: 5000
+    bucket_count: 50
+    histogram_type: exponential
+    unit: Percentage of vsync interval
+    gecko_datapoint: CONTENT_FRAME_TIME_WITHOUT_RESOURCE_UPLOAD
+    description: >
+      The time, in percentage of a vsync interval, spent from beginning a paint
+      in the content process until that frame is presented in the compositor by
+      webrender, excluding time spent uploading resources.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1503405
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
+    notification_emails:
+      - gfx-telemetry-alerts@mozilla.com
+    expires: never
+
+  without_upload:
+    type: custom_distribution
+    range_max: 5000
+    bucket_count: 50
+    histogram_type: exponential
+    unit: Percentage of vsync interval
+    gecko_datapoint: CONTENT_FRAME_TIME_WITHOUT_UPLOAD
+    description: >
+      The time, in percentage of a vsync interval, spent from beginning a paint
+      in the content process until that frame is presented in the compositor by
+      webrender, excluding time spent uploading any content.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1503405
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
+    notification_emails:
+      - gfx-telemetry-alerts@mozilla.com
+    expires: never
+
+  reason:
+    type: labeled_counter
+    labels:
+      - on_time
+      - no_vsync
+      - missed_composite
+      - slow_composite
+      - missed_composite_mid
+      - missed_composite_long
+      - missed_composite_low
+      - no_vsync_no_id
+    gecko_datapoint: CONTENT_FRAME_TIME_REASON
+    description: >
+      The reason that `gfx.content.frame_time.from_paint` recorded a slow
+      (>200ms) result, if any.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1510853
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
+    notification_emails:
+      - gfx-telemetry-alerts@mozilla.com
+    expires: never
+
+gfx.webrender:
+  scenebuild_time:
+    type: timing_distribution
+    time_unit: millisecond
+    gecko_datapoint: WR_SCENEBUILD_TIME
+    description: >
+      The time taken to build a webrender scene.
+      This occurs each time webrender receives a new display list.
+      This additionally includes blob rasterization time.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1470901
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
+    notification_emails:
+      - gfx-telemetry-alerts@mozilla.com
+      - jmuizelaar@mozilla.com
+    expires: never
+  sceneswap_time:
+    type: timing_distribution
+    time_unit: millisecond
+    gecko_datapoint: WR_SCENESWAP_TIME
+    description: >
+      The time taken to do a webrender scene swap. This is book-keeping that
+      APZ must perform once webrender has built a new scene.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1470901
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
+    notification_emails:
+      - gfx-telemetry-alerts@mozilla.com
+      - jmuizelaar@mozilla.com
+    expires: never
+  framebuild_time:
+    type: timing_distribution
+    time_unit: millisecond
+    gecko_datapoint: WR_FRAMEBUILD_TIME
+    description: >
+      The time taken to build a webrender frame.
+      This involves calculating the visibility of primitives, requesting
+      resources, and building the render passes which will be used to render
+      the frame.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1470901
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1
+    notification_emails:
+      - gfx-telemetry-alerts@mozilla.com
+      - jmuizelaar@mozilla.com
+    expires: never
+
+gfx.display:
+  count:
+    description: >
+      Amount of displays connected to the device
+    type: quantity
+    unit: Display count
+    # Temporary misuse of the user lifetime approved by Glean team
+    # due to limitations in Geckoview streaming telemetry.
+    # DO NOT DUPLICATE unless approved by Glean team.
+    lifetime: user
+    gecko_datapoint: gfx.display.count
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4
+    notification_emails:
+      - gfx-telemetry-alerts@mozilla.com
+    expires: never
+  primary_width:
+    description: >
+      Width of the primary display, takes device rotation into account.
+    type: quantity
+    unit: Pixels
+    # Temporary misuse of the user lifetime approved by Glean team
+    # due to limitations in Geckoview streaming telemetry.
+    # DO NOT DUPLICATE unless approved by Glean team.
+    lifetime: user
+    gecko_datapoint: gfx.display.primary_width
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4
+    notification_emails:
+      - gfx-telemetry-alerts@mozilla.com
+    expires: never
+  primary_height:
+    description: >
+      Height of the primary display, takes device rotation into account.
+    type: quantity
+    unit: Pixels
+    # Temporary misuse of the user lifetime approved by Glean team
+    # due to limitations in Geckoview streaming telemetry.
+    # DO NOT DUPLICATE unless approved by Glean team.
+    lifetime: user
+    gecko_datapoint: gfx.display.primary_height
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4
+    notification_emails:
+      - gfx-telemetry-alerts@mozilla.com
+    expires: never
+gfx.adapter.primary:
+  description:
+    description: >
+      Long form description of the Graphics adapter
+    type: string
+    # Temporary misuse of the user lifetime approved by Glean team
+    # due to limitations in Geckoview streaming telemetry.
+    # DO NOT DUPLICATE unless approved by Glean team.
+    lifetime: user
+    gecko_datapoint: gfx.adapter.description
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4
+    notification_emails:
+      - gfx-telemetry-alerts@mozilla.com
+    expires: never
+  vendor_id:
+    description: >
+      Graphics adapter vendor identification
+    type: string
+    # Temporary misuse of the user lifetime approved by Glean team
+    # due to limitations in Geckoview streaming telemetry.
+    # DO NOT DUPLICATE unless approved by Glean team.
+    lifetime: user
+    gecko_datapoint: gfx.adapter.vendor_id
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4
+    notification_emails:
+      - gfx-telemetry-alerts@mozilla.com
+    expires: never
+  device_id:
+    description: >
+      Graphics adapter device identification
+    type: string
+    # Temporary misuse of the user lifetime approved by Glean team
+    # due to limitations in Geckoview streaming telemetry.
+    # DO NOT DUPLICATE unless approved by Glean team.
+    lifetime: user
+    gecko_datapoint: gfx.adapter.device_id
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4
+    notification_emails:
+      - gfx-telemetry-alerts@mozilla.com
+    expires: never
+  subsystem_id:
+    description: >
+      Graphics adapter subsystem identification
+    type: string
+    # Temporary misuse of the user lifetime approved by Glean team
+    # due to limitations in Geckoview streaming telemetry.
+    # DO NOT DUPLICATE unless approved by Glean team.
+    lifetime: user
+    gecko_datapoint: gfx.adapter.subsystem_id
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4
+    notification_emails:
+      - gfx-telemetry-alerts@mozilla.com
+    expires: never
+  ram:
+    description: >
+      Graphics adapter dedicated memory
+    type: quantity
+    unit: Megabytes
+    # Temporary misuse of the user lifetime approved by Glean team
+    # due to limitations in Geckoview streaming telemetry.
+    # DO NOT DUPLICATE unless approved by Glean team.
+    lifetime: user
+    gecko_datapoint: gfx.adapter.ram
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4
+    notification_emails:
+      - gfx-telemetry-alerts@mozilla.com
+    expires: never
+  driver_files:
+    description: >
+      List of graphics adapter driver files
+    type: string
+    # Temporary misuse of the user lifetime approved by Glean team
+    # due to limitations in Geckoview streaming telemetry.
+    # DO NOT DUPLICATE unless approved by Glean team.
+    lifetime: user
+    gecko_datapoint: gfx.adapter.driver_files
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4
+    notification_emails:
+      - gfx-telemetry-alerts@mozilla.com
+    expires: never
+  driver_vendor:
+    description: >
+      Graphics adapter driver vendor identification
+    type: string
+    # Temporary misuse of the user lifetime approved by Glean team
+    # due to limitations in Geckoview streaming telemetry.
+    # DO NOT DUPLICATE unless approved by Glean team.
+    lifetime: user
+    gecko_datapoint: gfx.adapter.driver_vendor
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4
+    notification_emails:
+      - gfx-telemetry-alerts@mozilla.com
+    expires: never
+  driver_version:
+    description: >
+      Graphics adapter driver version
+    type: string
+    # Temporary misuse of the user lifetime approved by Glean team
+    # due to limitations in Geckoview streaming telemetry.
+    # DO NOT DUPLICATE unless approved by Glean team.
+    lifetime: user
+    gecko_datapoint: gfx.adapter.driver_version
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4
+    notification_emails:
+      - gfx-telemetry-alerts@mozilla.com
+    expires: never
+  driver_date:
+    description: >
+      Graphics adapter driver date
+    type: string
+    # Temporary misuse of the user lifetime approved by Glean team
+    # due to limitations in Geckoview streaming telemetry.
+    # DO NOT DUPLICATE unless approved by Glean team.
+    lifetime: user
+    gecko_datapoint: gfx.adapter.driver_date
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4
+    notification_emails:
+      - gfx-telemetry-alerts@mozilla.com
+    expires: never
+
+gfx.status:
+  compositor:
+    description: >
+      Name of the graphics compositor in use.
+      Possible values are "opengl, d3d11, client, webrender or basic"
+    type: string
+    # Temporary misuse of the user lifetime approved by Glean team
+    # due to limitations in Geckoview streaming telemetry.
+    # DO NOT DUPLICATE unless approved by Glean team.
+    lifetime: user
+    gecko_datapoint: gfx.compositor
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4
+    notification_emails:
+      - gfx-telemetry-alerts@mozilla.com
+    expires: never
+  last_compositor_gecko_version:
+    description: >
+      The gecko version at the last time a compositor was initialized, and
+      therefore when gfx_status_compositor was last updated. Due to
+      gfx_status_compositor's user lifetime we see lots of unexpected values for
+      the current gecko version. We believe this is because the user has not
+      opened a tab since they were updated to a version where webrender should
+      be enabled on their device. This can be used to verify that theory.
+    type: string
+    # Temporary misuse of the user lifetime approved by Glean team
+    # in order to match gfx_status_compositor's lifetime.
+    # DO NOT DUPLICATE unless approved by Glean team.
+    lifetime: user
+    gecko_datapoint: gfx.last_compositor_gecko_version
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1704842
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1704842#c8
+    notification_emails:
+      - jnicol@mozilla.com
+      - gfx-telemetry-alerts@mozilla.com
+    expires: never
+  headless:
+    description: >
+      Boolean indicated whether graphics is running in
+      headless (no display) mode
+    type: boolean
+    # Temporary misuse of the user lifetime approved by Glean team
+    # due to limitations in Geckoview streaming telemetry.
+    # DO NOT DUPLICATE unless approved by Glean team.
+    lifetime: user
+    gecko_datapoint: gfx.headless
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1687219
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4
+    notification_emails:
+      - gfx-telemetry-alerts@mozilla.com
+    expires: never
+
+gfx.feature:
+  webrender:
+    type: string
+    description: Whether webrender is enabled or disabled, and why.
+    lifetime: application
+    gecko_datapoint: gfx.feature.webrender
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1687312
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1687312#c5
+    notification_emails:
+      - gfx-telemetry-alerts@mozilla.com
+      - jnicol@mozilla.com
+    expires: never
+
+avif:
+  decode_result:
+    type: labeled_counter
+    labels:
+      - success
+      - parse_error
+      - no_primary_item
+      - decode_error
+      - size_overflow
+      - out_of_memory
+      - pipe_init_error
+      - write_buffer_error
+      - alpha_y_sz_mismatch
+      - alpha_y_bpc_mismatch
+      - ispe_mismatch
+      - render_size_mismatch
+      - frame_size_changed
+      - invalid_cicp
+      - invalid_parse_status
+      - missing_brand
+      - ftyp_not_first
+      - no_image
+      - multiple_moov
+      - no_moov
+      - lsel_no_essential
+      - a1op_no_essential
+      - a1lx_essential
+      - txform_no_essential
+      - image_item_type
+      - item_type_missing
+      - construction_method
+      - item_loc_not_found
+      - no_item_data_box
+    gecko_datapoint: AVIF_DECODE_RESULT
+    description: >
+      Decode result of AVIF image.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1670827
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1670827#c9
+    notification_emails:
+      - media-alerts@mozilla.com
+    expires: never
+
+  decoder:
+    type: labeled_counter
+    labels:
+      - dav1d
+      - aom
+    gecko_datapoint: AVIF_DECODER
+    description: >
+      Decoder of AVIF image.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1670827
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1670827#c9
+    notification_emails:
+      - media-alerts@mozilla.com
+    expires: never
+
+  aom_decode_error:
+    type: labeled_counter
+    labels:
+      - error
+      - mem_error
+      - abi_mismatch
+      - incapable
+      - unsup_bitstream
+      - unsup_feature
+      - corrupt_frame
+      - invalid_param
+    gecko_datapoint: AVIF_AOM_DECODE_ERROR
+    description: >
+      Image-decode Error from AOM decoder
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1690406
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1690406#c3
+    notification_emails:
+      - media-alerts@mozilla.com
+    expires: never
+
+  # dav1d_decode_error is replaced by avif.dav1d_get_picture in Events.yaml
+  # Unfortunately, events are not currently supported for geckoview
+
+  yuv_color_space:
+    type: labeled_counter
+    labels:
+      - bt601
+      - bt709
+      - bt2020
+      - identity
+      - unknown
+    gecko_datapoint: AVIF_YUV_COLOR_SPACE
+    description: >
+      YUV color space of AVIF image.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1670827
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1670827#c9
+    notification_emails:
+      - media-alerts@mozilla.com
+    expires: never
+
+  bit_depth:
+    type: labeled_counter
+    labels:
+      - color_8
+      - color_10
+      - color_12
+      - color_16
+      - unknown
+    gecko_datapoint: AVIF_BIT_DEPTH
+    description: >
+      Bits per pixel of AVIF image.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1670827
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1670827#c9
+    notification_emails:
+      - media-alerts@mozilla.com
+    expires: never
+
+  alpha:
+    type: labeled_counter
+    labels:
+      - absent
+      - present
+    gecko_datapoint: AVIF_ALPHA
+    description: >
+      AVIF alpha plane.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1696045
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1696045#c5
+    notification_emails:
+      - media-alerts@mozilla.com
+    expires: never
+
+  colr:
+    type: labeled_counter
+    labels:
+      - nclx
+      - icc
+      - absent
+      - both
+    gecko_datapoint: AVIF_COLR
+    description: >
+      AVIF colour information type.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1696045
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1729071
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1696045#c5
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1729071#c15
+    notification_emails:
+      - media-alerts@mozilla.com
+    expires: never
+
+  cicp_cp:
+    type: labeled_counter
+    labels:
+      - reserved
+      - bt709
+      - unspecified
+      - reserved_3
+      - bt470m
+      - bt470bg
+      - bt601
+      - smpte240
+      - generic_film
+      - bt2020
+      - xyz
+      - smpte431
+      - smpte432
+      - reserved_13
+      - reserved_14
+      - reserved_15
+      - reserved_16
+      - reserved_17
+      - reserved_18
+      - reserved_19
+      - reserved_20
+      - reserved_21
+      - ebu3213
+      - reserved_rest
+    gecko_datapoint: AVIF_CICP_CP
+    description: >
+      AVIF CICP colour primaries.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1696045
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1696045#c5
+    notification_emails:
+      - media-alerts@mozilla.com
+    expires: never
+
+  cicp_tc:
+    type: labeled_counter
+    labels:
+      - reserved
+      - bt709
+      - unspecified
+      - reserved_3
+      - bt470m
+      - bt470bg
+      - bt601
+      - smpte240
+      - linear
+      - log_100
+      - log_100_sqrt10
+      - iec61966
+      - bt_1361
+      - srgb
+      - bt2020_10bit
+      - bt2020_12bit
+      - smpte2084
+      - smpte428
+      - hlg
+      - reserved_rest
+    gecko_datapoint: AVIF_CICP_TC
+    description: >
+      AVIF CICP transfer characteristics.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1696045
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1696045#c5
+    notification_emails:
+      - media-alerts@mozilla.com
+    expires: never
+
+  cicp_mc:
+    type: labeled_counter
+    labels:
+      - identity
+      - bt709
+      - unspecified
+      - reserved
+      - fcc
+      - bt470bg
+      - bt601
+      - smpte240
+      - ycgco
+      - bt2020_ncl
+      - bt2020_cl
+      - smpte2085
+      - chromat_ncl
+      - chromat_cl
+      - ictcp
+      - reserved_rest
+    gecko_datapoint: AVIF_CICP_MC
+    description: >
+      AVIF CICP transfer characteristics.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1696045
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1696045#c5
+    notification_emails:
+      - media-alerts@mozilla.com
+    expires: never
+
+  ispe:
+    type: labeled_counter
+    labels:
+      - valid
+      - absent
+      - bitstream_mismatch
+    gecko_datapoint: AVIF_ISPE
+    description: >
+      AVIF spatial extents (image size).
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1696045
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1696045#c5
+    notification_emails:
+      - media-alerts@mozilla.com
+    expires: never
+
+  pixi:
+    type: labeled_counter
+    labels:
+      - valid
+      - absent
+      - bitstream_mismatch
+    gecko_datapoint: AVIF_PIXI
+    description: >
+      AVIF pixel information (bits per channel).
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1696045
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1696045#c5
+    notification_emails:
+      - media-alerts@mozilla.com
+    expires: never
+
+  pasp:
+    type: labeled_counter
+    labels:
+      - absent
+      - square
+      - nonsquare
+      - invalid
+    gecko_datapoint: AVIF_PASP
+    description: >
+      AVIF pixel aspect ratio.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1745608
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1745608#c2
+    notification_emails:
+      - media-alerts@mozilla.com
+    expires: never
+
+  major_brand:
+    type: labeled_counter
+    labels:
+      - avif
+      - avis
+      - other
+    description: >
+      AVIF major brand.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1745608
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1745608#c2
+    notification_emails:
+      - media-alerts@mozilla.com
+    expires: never
+
+  sequence:
+    type: labeled_counter
+    labels:
+      - present
+      - absent
+    description: >
+      AVIF image sequence.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1745608
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1745608#c2
+    notification_emails:
+      - media-alerts@mozilla.com
+    expires: never
+
+  a1lx:
+    type: labeled_counter
+    labels:
+      - present
+      - absent
+    gecko_datapoint: AVIF_A1LX
+    description: >
+      AV1LayeredImageIndexingProperty (a1lx).
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1745608
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1745608#c2
+    notification_emails:
+      - media-alerts@mozilla.com
+    expires: never
+
+  a1op:
+    type: labeled_counter
+    labels:
+      - present
+      - absent
+    gecko_datapoint: AVIF_A1OP
+    description: >
+      AVIF OperatingPointSelectorProperty (a1op).
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1745608
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1745608#c2
+    notification_emails:
+      - media-alerts@mozilla.com
+    expires: never
+
+  clap:
+    type: labeled_counter
+    labels:
+      - present
+      - absent
+    gecko_datapoint: AVIF_CLAP
+    description: >
+      AVIF CleanApertureBox (clap).
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1745608
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1745608#c2
+    notification_emails:
+      - media-alerts@mozilla.com
+    expires: never
+
+  grid:
+    type: labeled_counter
+    labels:
+      - present
+      - absent
+    gecko_datapoint: AVIF_GRID
+    description: >
+      AVIF AVIF grid-based image.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1745608
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1745608#c2
+    notification_emails:
+      - media-alerts@mozilla.com
+    expires: never
+
+  ipro:
+    type: labeled_counter
+    labels:
+      - present
+      - absent
+    gecko_datapoint: AVIF_IPRO
+    description: >
+      AVIF ItemProtectionBox (ipro).
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1745608
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1745608#c2
+    notification_emails:
+      - media-alerts@mozilla.com
+    expires: never
+
+  lsel:
+    type: labeled_counter
+    labels:
+      - present
+      - absent
+    gecko_datapoint: AVIF_LSEL
+    description: >
+      AVIF LayerSelectorProperty (lsel).
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1745608
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1745608#c2
+    notification_emails:
+      - media-alerts@mozilla.com
+    expires: never
+
+network:
+  cache_hit_time:
+    type: timing_distribution
+    time_unit: millisecond
+    gecko_datapoint: NETWORK_CACHE_V2_HIT_TIME_MS
+    description: >
+      Time to open existing cache entry file.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1489524
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
+    notification_emails:
+      - necko@mozilla.com
+    expires: never
+
+  tls_handshake:
+    type: timing_distribution
+    time_unit: millisecond
+    gecko_datapoint: HTTP_PAGE_TLS_HANDSHAKE
+    description: >
+      In the HTTP page channel, time from after the TCP SYN packet is
+      received to the secure connection is established and ready for HTTP.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=772589
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
+    notification_emails:
+      - necko@mozilla.com
+      - ddamjanovic@mozilla.com
+    expires: never
+
+  tcp_connection:
+    type: timing_distribution
+    time_unit: millisecond
+    gecko_datapoint: HTTP_PAGE_TCP_CONNECTION_2
+    description: >
+      In the HTTP page channel, time from the TCP SYN packet is received to
+      the connection is established and ready for HTTP.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=772589
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
+    notification_emails:
+      - necko@mozilla.com
+      - ddamjanovic@mozilla.com
+    expires: never
+
+  dns_start:
+    type: timing_distribution
+    time_unit: millisecond
+    gecko_datapoint: HTTP_PAGE_DNS_ISSUE_TIME
+    description: >
+      In the HTTP page channel, time from connection open to the DNS request
+      being issued.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
+    notification_emails:
+      - necko@mozilla.com
+      - vogosu@mozilla.com
+    expires: never
+
+  dns_end:
+    type: timing_distribution
+    time_unit: millisecond
+    gecko_datapoint: HTTP_PAGE_DNS_LOOKUP_TIME
+    description: >
+      In the HTTP page channel, time from the DNS request being issued to
+      the response.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
+    notification_emails:
+      - necko@mozilla.com
+      - vogosu@mozilla.com
+    expires: never
+
+  font_download_end:
+    type: timing_distribution
+    time_unit: millisecond
+    gecko_datapoint: WEBFONT_DOWNLOAD_TIME_AFTER_START
+    description: >
+      Time after navigationStart that all webfont downloads are completed.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
+    notification_emails:
+      - perf-telemetry-alerts@mozilla.com
+      - necko@mozilla.com
+      - bdekoz@mozilla.com
+    expires: never
+
+  first_from_cache:
+    type: timing_distribution
+    time_unit: millisecond
+    gecko_datapoint: HTTP_PAGE_OPEN_TO_FIRST_FROM_CACHE_V2
+    description: >
+      In the HTTP page channel, time from connection open to cache read start.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
+    notification_emails:
+      - necko@mozilla.com
+    expires: never
+
+performance.pageload:
+  load_time:
+    type: timing_distribution
+    time_unit: millisecond
+    gecko_datapoint: PERF_PAGE_LOAD_TIME_MS
+    description: >
+      Time in milliseconds from navigationStart to loadEventStart
+      for the foreground http or https root content document.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729#c7
+    notification_emails:
+      - dpalmeiro@mozilla.com
+      - perf-telemetry-alerts@mozilla.com
+    expires: never
+
+  load_time_responsestart:
+    type: timing_distribution
+    time_unit: millisecond
+    gecko_datapoint: PERF_PAGE_LOAD_TIME_FROM_RESPONSESTART_MS
+    description: >
+      Time in milliseconds from responseStart to loadEventStart
+      for the foreground http or https root content document.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729#c7
+    notification_emails:
+      - dpalmeiro@mozilla.com
+      - perf-telemetry-alerts@mozilla.com
+    expires: never
+
+  dcl:
+    type: timing_distribution
+    time_unit: millisecond
+    gecko_datapoint: PERF_DOM_CONTENT_LOADED_MS
+    description: >
+      Time in milliseconds from navigationStart to domContentLoaded
+      for the foreground http or https root content document.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729#c7
+    notification_emails:
+      - dpalmeiro@mozilla.com
+      - perf-telemetry-alerts@mozilla.com
+    expires: never
+
+  dcl_responsestart:
+    type: timing_distribution
+    time_unit: millisecond
+    gecko_datapoint: PERF_DOM_CONTENT_LOADED_FROM_RESPONSESTART_MS
+    description: >
+      Time in milliseconds from responseStart to domContentLoaded
+      for the foreground http or https root content document.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729#c7
+    notification_emails:
+      - dpalmeiro@mozilla.com
+      - perf-telemetry-alerts@mozilla.com
+    expires: never
+
+  fcp:
+    type: timing_distribution
+    time_unit: millisecond
+    gecko_datapoint: PERF_FIRST_CONTENTFUL_PAINT_MS
+    description: >
+      The time between navigationStart and the first contentful paint
+      of a foreground http or https root content document, in
+      milliseconds. The contentful paint timestamp is taken during
+      display list building and does not include rasterization or
+      compositing of that paint.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729#c7
+    notification_emails:
+      - dpalmeiro@mozilla.com
+      - perf-telemetry-alerts@mozilla.com
+    expires: never
+
+  fcp_responsestart:
+    type: timing_distribution
+    time_unit: millisecond
+    gecko_datapoint: PERF_FIRST_CONTENTFUL_PAINT_FROM_RESPONSESTART_MS
+    description: >
+      The time between responseStart and the first contentful paint
+      of a foreground http or https root content document, in
+      milliseconds. The contentful paint timestamp is taken during
+      display list building and does not include rasterization or
+      compositing of that paint.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729#c7
+    notification_emails:
+      - dpalmeiro@mozilla.com
+      - perf-telemetry-alerts@mozilla.com
+    expires: never
+
+  req_anim_frame_callback:
+    type: timing_distribution
+    time_unit: millisecond
+    gecko_datapoint: PERF_REQUEST_ANIMATION_CALLBACK_PAGELOAD_MS
+    description: >
+      Time spent in milliseconds calling all request animation frame callbacks
+      for a document before it has reached readystate complete.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729#c7
+    notification_emails:
+      - dpalmeiro@mozilla.com
+      - perf-telemetry-alerts@mozilla.com
+    expires: never
+
+performance.responsiveness:
+  req_anim_frame_callback:
+    type: timing_distribution
+    time_unit: millisecond
+    gecko_datapoint: PERF_REQUEST_ANIMATION_CALLBACK_NON_PAGELOAD_MS
+    description: >
+      Time spent in milliseconds calling all request animation frame callbacks
+      for a document after it has reached readystate complete.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671729#c7
+    notification_emails:
+      - dpalmeiro@mozilla.com
+      - perf-telemetry-alerts@mozilla.com
+    expires: never
+
+
+performance.time:
+  response_start:
+    type: timing_distribution
+    time_unit: millisecond
+    gecko_datapoint: TIME_TO_RESPONSE_START_MS
+    description: >
+      Time from navigationStart to responseStart as per the W3C
+      Performance Timing API.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1344893
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1489524
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
+    notification_emails:
+      - vchin@mozilla.com
+      - perf-telemetry-alerts@mozilla.com
+    expires: never
+
+  dom_interactive:
+    type: timing_distribution
+    time_unit: millisecond
+    gecko_datapoint: TIME_TO_DOM_INTERACTIVE_MS
+    description: >
+      Time from navigationStart to domInteractive as per the W3C
+      Performance Timing API.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?1344893
+      - https://bugzilla.mozilla.org/show_bug.cgi?1489524
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
+    notification_emails:
+      - vgosu@mozilla.com
+      - perf-telemetry-alerts@mozilla.com
+    expires: never
+
+  dom_content_loaded_start:
+    type: timing_distribution
+    time_unit: millisecond
+    gecko_datapoint: TIME_TO_DOM_CONTENT_LOADED_START_MS
+    description: >
+      Time from navigationStart to domContentLoadedEventStart as per
+      the W3C Performance Timing API.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1344893
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
+    notification_emails:
+      - perf-telemetry-alerts@mozilla.com
+      - bdekoz@mozilla.com
+    expires: never
+
+  dom_content_loaded_end:
+    type: timing_distribution
+    time_unit: millisecond
+    gecko_datapoint: TIME_TO_DOM_CONTENT_LOADED_END_MS
+    description: >
+      Time from navigationStart to domContentLoadedEventEnd as per
+      the W3C Performance Timing API.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1344893
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1489524
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
+    notification_emails:
+      - vchin@mozilla.com
+      - perf-telemetry-alerts@mozilla.com
+    expires: never
+
+  dom_complete:
+    type: timing_distribution
+    time_unit: millisecond
+    gecko_datapoint: TIME_TO_DOM_COMPLETE_MS
+    description: >
+      Time from navigationStart to domComplete as per the W3C Performance
+      Timing API.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1344893
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1489524
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
+    notification_emails:
+      - vgosu@mozilla.com
+      - perf-telemetry-alerts@mozilla.com
+    expires: never
+
+  load_event_start:
+    type: timing_distribution
+    time_unit: millisecond
+    gecko_datapoint: TIME_TO_LOAD_EVENT_START_MS
+    description: >
+      Time from navigationStart to loadEventStart as per the W3C Performance
+      Timing API.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1344893
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
+    notification_emails:
+      - perf-telemetry-alerts@mozilla.com
+      - bdekoz@mozilla.com
+    expires: never
+
+  load_event_end:
+    type: timing_distribution
+    time_unit: millisecond
+    gecko_datapoint: TIME_TO_LOAD_EVENT_END_MS
+    description: >
+      Time from navigationStart to loadEventEnd as per the W3C Performance
+      Timing API.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1344893
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1489524
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
+    notification_emails:
+      - vchin@mozilla.com
+      - perf-telemetry-alerts@mozilla.com
+    expires: never
+
+performance.page:
+  non_blank_paint:
+    type: timing_distribution
+    time_unit: millisecond
+    gecko_datapoint: TIME_TO_NON_BLANK_PAINT_MS
+    description: >
+      The time between navigationStart and the first non-blank paint of a
+      foreground root content document, in milliseconds. This only records
+      documents that were in an active docshell throughout the whole time
+      between navigation start and non-blank paint. The non-blank paint
+      timestamp is taken during display list building and does not include
+      rasterization or compositing of that paint.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1307242
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1489524
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
+    notification_emails:
+      - vchin@mozilla.com
+      - perf-telemetry-alerts@mozilla.com
+    expires: never
+
+  total_content_page_load:
+    type: timing_distribution
+    time_unit: millisecond
+    gecko_datapoint: TOTAL_CONTENT_PAGE_LOAD_TIME
+    description: >
+      Time to load all of a page's resources and render.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
+    notification_emails:
+      - perf-telemetry-alerts@mozilla.com
+      - bdekoz@mozilla.com
+    expires: never
+
+performance.interaction:
+  keypress_present_latency:
+    type: timing_distribution
+    time_unit: millisecond
+    gecko_datapoint: KEYPRESS_PRESENT_LATENCY
+    description: >
+      Time between receiving a keypress event in the event loop and compositing
+      its result onto the screen.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1506537
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
+    notification_emails:
+      - perf-telemetry-alerts@mozilla.com
+      - vchin@mozilla.com
+    expires: never
+
+  mouseup_click_present_latency:
+    type: timing_distribution
+    time_unit: millisecond
+    gecko_datapoint: MOUSEUP_FOLLOWED_BY_CLICK_PRESENT_LATENCY
+    description: >
+      Time between receiving a mouseup which follow by a mouseclick
+      on the event loop and compositing its result onto the screen.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1698643
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1698643#c3
+    notification_emails:
+      - perf-telemetry-alerts@mozilla.com
+      - sefeng@mozilla.com
+    expires: never
+
+  tab_switch_composite:
+    type: timing_distribution
+    time_unit: millisecond
+    gecko_datapoint: FX_TAB_SWITCH_COMPOSITE_E10S_MS
+    description: >
+      Time between tab selection and first composite of the tab content onto the
+      screen.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1481704
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1529352
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10
+    notification_emails:
+      - mconley@mozilla.com
+      - perf-telemetry-alerts@mozilla.com
+    expires: never
+
+javascript.pageload:
+  execution_time:
+    type: timing_distribution
+    time_unit: millisecond
+    gecko_datapoint: JS_PAGELOAD_EXECUTION_MS
+    description: >
+      Time spent during page load executing Javascript in ms.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1709139
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1709139#c4
+    notification_emails:
+      - dpalmeiro@mozilla.com
+      - perf-telemetry-alerts@mozilla.com
+    expires: never
+  delazification_time:
+    type: timing_distribution
+    time_unit: millisecond
+    gecko_datapoint: JS_PAGELOAD_DELAZIFICATION_MS
+    description: >
+      Time spent during page load delazifying Javascript in ms.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1709139
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1709139#c4
+    notification_emails:
+      - dpalmeiro@mozilla.com
+      - perf-telemetry-alerts@mozilla.com
+    expires: never
+  xdr_encode_time:
+    type: timing_distribution
+    time_unit: millisecond
+    gecko_datapoint: JS_PAGELOAD_XDR_ENCODING_MS
+    description: >
+      Time spent during page load XDR encoding Javascript in ms.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1709139
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1709139#c4
+    notification_emails:
+      - dpalmeiro@mozilla.com
+      - perf-telemetry-alerts@mozilla.com
+    expires: never
+  baseline_compile_time:
+    type: timing_distribution
+    time_unit: millisecond
+    gecko_datapoint: JS_PAGELOAD_BASELINE_COMPILE_MS
+    description: >
+      Time spent during page load baseline compiling Javascript in ms.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1709139
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1709139#c4
+    notification_emails:
+      - dpalmeiro@mozilla.com
+      - perf-telemetry-alerts@mozilla.com
+    expires: never
+  gc_time:
+    type: timing_distribution
+    time_unit: millisecond
+    gecko_datapoint: JS_PAGELOAD_GC_MS
+    description: >
+      Time spent during page load in the GC in ms.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1709139
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1709139#c4
+    notification_emails:
+      - dpalmeiro@mozilla.com
+      - perf-telemetry-alerts@mozilla.com
+    expires: never
+  parse_time:
+    type: timing_distribution
+    time_unit: millisecond
+    gecko_datapoint: JS_PAGELOAD_PARSE_MS
+    description: >
+      Time spent during page load syntax parsing JS scripts on
+      the main thread in ms.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1709139
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1709139#c4
+    notification_emails:
+      - dpalmeiro@mozilla.com
+      - perf-telemetry-alerts@mozilla.com
+    expires: never
+  protect_time:
+    type: timing_distribution
+    time_unit: millisecond
+    gecko_datapoint: JS_PAGELOAD_PROTECT_MS
+    description: >
+      Time spent during page load protecting JIT executable memory.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1709139
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1709139#c4
+    notification_emails:
+      - dpalmeiro@mozilla.com
+      - perf-telemetry-alerts@mozilla.com
+    expires: never
+
+javascript.gc:
+  total_time:
+    type: timing_distribution
+    time_unit: millisecond
+    gecko_datapoint: GC_MS
+    description: >
+      The total time taken by a major collection.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1636419
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1636419#c8
+    notification_emails:
+      - dev-telemetry-gc-alerts@mozilla.org
+      - jcoppeard@mozilla.com
+    expires: never
+
+  minor_time:
+    type: timing_distribution
+    time_unit: microsecond
+    gecko_datapoint: GC_MINOR_US
+    description: >
+      The time taked by a minor (nursery) collection.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1636419
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1636419#c17
+    notification_emails:
+      - dev-telemetry-gc-alerts@mozilla.org
+      - jcoppeard@mozilla.com
+    expires: never
+
+  prepare_time:
+    type: timing_distribution
+    time_unit: millisecond
+    gecko_datapoint: GC_PREPARE_MS
+    description: >
+      The time spent in the preparation phase.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1636419
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1636419#c17
+    notification_emails:
+      - dev-telemetry-gc-alerts@mozilla.org
+      - jcoppeard@mozilla.com
+    expires: never
+
+  mark_roots_time:
+    type: timing_distribution
+    time_unit: microsecond
+    gecko_datapoint: GC_MARK_ROOTS_US
+    description: >
+      The time spent marking GC roots.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1636419
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1636419#c17
+    notification_emails:
+      - dev-telemetry-gc-alerts@mozilla.org
+      - jcoppeard@mozilla.com
+    expires: never
+
+  mark_time:
+    type: timing_distribution
+    time_unit: millisecond
+    gecko_datapoint: GC_MARK_MS
+    description: >
+      The time spent in the mark phase.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1636419
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1636419#c17
+    notification_emails:
+      - dev-telemetry-gc-alerts@mozilla.org
+      - jcoppeard@mozilla.com
+    expires: never
+
+  sweep_time:
+    type: timing_distribution
+    time_unit: millisecond
+    gecko_datapoint: GC_SWEEP_MS
+    description: >
+      The time spent in the sweep phase.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1636419
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1636419#c17
+    notification_emails:
+      - dev-telemetry-gc-alerts@mozilla.org
+      - jcoppeard@mozilla.com
+    expires: never
+
+  compact_time:
+    type: timing_distribution
+    time_unit: millisecond
+    gecko_datapoint: GC_COMPACT_MS
+    description: >
+      The time spent in the compact phase.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1636419
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1636419#c17
+    notification_emails:
+      - dev-telemetry-gc-alerts@mozilla.org
+      - jcoppeard@mozilla.com
+    expires: never
+
+  slice_time:
+    type: timing_distribution
+    time_unit: millisecond
+    gecko_datapoint: GC_SLICE_MS
+    description: >
+      The time spent running a GC slice.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1636419
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1636419#c17
+    notification_emails:
+      - dev-telemetry-gc-alerts@mozilla.org
+      - jcoppeard@mozilla.com
+    expires: never
+
+performance.clone.deserialize:
+  size:
+    description: >
+      Size of deserialized data, in bytes
+    type: memory_distribution
+    memory_unit: byte
+    gecko_datapoint: DESERIALIZE_BYTES
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1717631
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1717631#c4
+    notification_emails:
+      - sfink@mozilla.com
+    expires: never
+
+  items:
+    description: >
+      Size of deserialized data, in items
+    type: custom_distribution
+    unit: Serialized items
+    histogram_type: exponential
+    range_max: 2147483646
+    bucket_count: 50
+    gecko_datapoint: DESERIALIZE_ITEMS
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1717631
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1717631#c4
+    notification_emails:
+      - sfink@mozilla.com
+    expires: never
+
+  time:
+    description: >
+      Time spent deserializing structured data
+    type: timing_distribution
+    time_unit: microsecond
+    gecko_datapoint: DESERIALIZE_US
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1717631
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1717631#c4
+    notification_emails:
+      - sfink@mozilla.com
+    expires: never
+
+media.audio:
+  init_failure:
+    type: labeled_counter
+    labels:
+      - first
+      - other
+    gecko_datapoint: MEDIA_AUDIO_INIT_FAILURE
+    description: >
+      Failure occurs when initializing the audio stream.
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671714
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671714#c10
+    notification_emails:
+      - media-alerts@mozilla.com
+    expires: never
+
+  backend:
+    type: labeled_counter
+    labels:
+      - unknown
+      - audiounit
+      - audiounit_rust
+      - aaudio
+      - opensl
+      - wasapi
+      - winmm
+      - alsa
+      - jack
+      - oss
+      - pulse
+      - pulse_rust
+      - sndio
+      - sun
+    gecko_datapoint: MEDIA_AUDIO_BACKEND
+    description: >
+      The operating system audio backend
+    bugs:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671714
+    data_reviews:
+      - https://bugzilla.mozilla.org/show_bug.cgi?id=1671714#c10
+    notification_emails:
+      - media-alerts@mozilla.com
+    expires: never