metrics/histograms/histograms_xml/notifications/histograms.xml

<!--
Copyright 2020 The Chromium Authors. All rights reserved.
Use of this source code is governed by a BSD-style license that can be
found in the LICENSE file.
-->

<!--
This file is used to generate a comprehensive list of Notifications histograms
along with a detailed description for each histogram.

For best practices on writing histogram descriptions, see
https://chromium.googlesource.com/chromium/src.git/+/HEAD/tools/metrics/histograms/README.md

Please send CLs to chromium-metrics-reviews@google.com rather than to specific
individuals. These CLs will be automatically reassigned to a reviewer within
about 5 minutes. This approach helps the metrics team to load-balance incoming
reviews. Googlers can read more about this at go/gwsq-gerrit.
-->

<histogram-configuration>

<histograms>

<histogram name="Notifications.Actions" enum="NotificationActionType"
    expires_after="M85">
  <owner>dewittj@chromium.org</owner>
  <summary>
    The actions taken on notifications, recorded every time they happen. This
    histogram will record every single event that happens separately.
  </summary>
</histogram>

<histogram name="Notifications.Android.Build" enum="BooleanSuccess"
    expires_after="M96">
  <owner>peter@chromium.org</owner>
  <owner>knollr@chromium.org</owner>
  <summary>
    Records whether we could successfully build a notification using Android's
    Notification Builder. If unsuccessful, we will silently drop the
    notification display request. Note that delivering the notification may
    still fail which is logged in Mobile.SystemNotification.NotifyFailure.
    Logged when we try to build a notification using an instance of
    NotificationWrapperBuilder.
  </summary>
</histogram>

<histogram name="Notifications.Android.JobStartDelay" units="ms"
    expires_after="M96">
  <owner>peter@chromium.org</owner>
  <owner>knollr@chromium.org</owner>
  <summary>
    Records the delay between scheduling a job with the JobScheduler (with a
    desired latency of 0ms, in response to a notification click) and receiving
    the onStartJob callback. Only measured on Android N and above.
  </summary>
</histogram>

<histogram name="Notifications.Android.SitesChannel" enum="BooleanUsage"
    expires_after="2021-08-22">
  <owner>peter@chromium.org</owner>
  <summary>
    Recorded when the Sites channel (which we hope to deprecate) is used as a
    fallback, when a site-specific notification channel is expected to exist but
    does not. Note, we only log when the sites channel is *used*, not when it is
    not used.
  </summary>
</histogram>

<histogram name="Notifications.Announcement.Events"
    enum="AnnouncementNotificationEvent" expires_after="2020-10-30">
  <obsolete>
    Deprecated as of 10/2020
  </obsolete>
  <owner>dtrainor@chromium.org</owner>
  <owner>xingliu@chromium.org</owner>
  <summary>
    Records the events when the announcement notification is shown, clicked, or
    closed.
  </summary>
</histogram>

<histogram name="Notifications.AppNotificationStatus"
    enum="NotificationAppStatus" expires_after="never">
<!-- expires-never: Indicates whether Chrome has notification permission. -->

  <owner>peter@chromium.org</owner>
  <summary>
    Records whether notifications are enabled for Chrome, as the Android app,
    for each Web Notification that is being shown to the user.
  </summary>
</histogram>

<histogram name="Notifications.AuthorDataSize" units="bytes"
    expires_after="2018-08-30">
  <owner>peter@chromium.org</owner>
  <summary>
    The size, in bytes, of the author-provided data associated with a Web
    Notification. Recorded when a persistent Web Notification is being shown by
    the developer.
  </summary>
</histogram>

<histogram name="Notifications.Blocker.ScreenCapture.Action.{Action}"
    units="notifications" expires_after="M93">
  <owner>knollr@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    Records the number of times the 'Notifications muted' notification got shown
    before the user took an action. Clicking on 'Show' can only be recorded once
    per session while 'Body' and 'Close' may be recorded multiple times. Logged
    each time the user interacts with the notification. {Action}
  </summary>
  <token key="Action">
    <variant name="Body"/>
    <variant name="Close"/>
    <variant name="Show"/>
  </token>
</histogram>

<histogram name="Notifications.Blocker.ScreenCapture.ActionTiming.{Action}"
    units="ms" expires_after="M93">
  <owner>knollr@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    Records the time between showing the 'Notifications muted' notification and
    the user taking an action on it. Logged each time the user interacts with
    the notification. {Action}
  </summary>
  <token key="Action">
    <variant name="Body"/>
    <variant name="Close"/>
    <variant name="Show"/>
  </token>
</histogram>

<histogram name="Notifications.Blocker.ScreenCapture.ClosedCount"
    units="notifications" expires_after="2021-09-19">
  <owner>knollr@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    The number of muted notifications that got closed programmatically (e.g. by
    the developer via JS) during a screen capture session before they were shown
    to the user. Logged once after each screen capture session ends.
  </summary>
</histogram>

<histogram name="Notifications.Blocker.ScreenCapture.MutedCount"
    units="notifications" expires_after="2021-09-19">
  <owner>knollr@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    The number of notifications that got muted during a screen capture session
    instead of being shown to the user. This number might be higher than the
    actual number of queued notifications at the end of a session as some
    notifications might have been closed programmatically before that. Logged
    once after each screen capture session ends.
  </summary>
</histogram>

<histogram name="Notifications.Blocker.ScreenCapture.ReplacedCount"
    units="notifications" expires_after="2021-09-19">
  <owner>knollr@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    The number of muted notifications that got replaced during a screen capture
    session. The user will only see the final state of the notification without
    the previous versions. Logged once after each screen capture session ends.
  </summary>
</histogram>

<histogram name="Notifications.Blocker.ScreenCapture.RevealDuration" units="ms"
    expires_after="2021-09-19">
  <owner>knollr@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    Records the time from the start of a screen capture session until the user
    decided to reveal notification content again. Only logged if and when the
    user takes that action.
  </summary>
</histogram>

<histogram name="Notifications.Blocker.ScreenCapture.SessionDuration"
    units="ms" expires_after="2021-09-19">
  <owner>knollr@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    Records the length of a screen capture session. Notifications will be muted
    initially but the user may reveal them during a session. This metric will be
    logged after the screen capture session ends.
  </summary>
</histogram>

<histogram name="Notifications.Chime.Android.Events" enum="ChimeEvent"
    expires_after="never">
  <owner>hesen@chromium.org</owner>
  <owner>xingliu@chromium.org</owner>
<!-- expires-never: Monitors Chime notification stability. -->

  <summary>
    Various events when Chrome interacts with Chime notification platform.
    Recorded when Chrome registers to Chime service, receives notifications, and
    the user interacts with the notification.
  </summary>
</histogram>

<histogram name="Notifications.Chime.Android.Registration"
    enum="BooleanSuccess" expires_after="never">
  <owner>hesen@chromium.org</owner>
  <owner>xingliu@chromium.org</owner>
<!-- expires-never: Monitors Chime notification stability. -->

  <summary>
    Records the result of Chime notification platform registration. Each device
    may have multiple accounts registered. The registration happens right after
    opening Chrome.
  </summary>
</histogram>

<histogram name="Notifications.Cros.Actions" enum="NotificationTypeDetailed"
    expires_after="2021-12-31">
  <owner>tbarzic@chromium.org</owner>
  <owner>tengs@chromium.org</owner>
  <owner>gzadina@google.com</owner>
  <summary>
    Records the notification type when a notification interaction occurs. See
    suffixes for all event types. ChromeOS only.
  </summary>
</histogram>

<histogram name="Notifications.Database.DeleteAllForOriginsResult"
    enum="NotificationDatabaseStatus" expires_after="M94">
  <owner>knollr@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    Records the result status codes of deleting all notification data for given
    origins. This happens when notification permissions are revoked for a site.
  </summary>
</histogram>

<histogram name="Notifications.Database.DeleteBeforeWriteResult"
    enum="NotificationDatabaseStatus" expires_after="M94">
  <owner>knollr@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    Records the result status codes of deleting notification data from the Web
    Notification database that share their tag (replacement identifier) with a
    notification that's about to be shown.
  </summary>
</histogram>

<histogram name="Notifications.Database.DeleteResult"
    enum="NotificationDatabaseStatus" expires_after="M94">
  <owner>knollr@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    Records the result status codes of deleting notification data from the Web
    Notification database.
  </summary>
</histogram>

<histogram name="Notifications.Database.DeleteServiceWorkerRegistrationResult"
    enum="NotificationDatabaseStatus" expires_after="M94">
  <owner>knollr@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    Records the result status codes of deleting all notification data associated
    with a Service Worker registration ID.
  </summary>
</histogram>

<histogram name="Notifications.Database.DestroyResult"
    enum="NotificationDatabaseStatus" expires_after="M94">
  <owner>knollr@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    Records the result status codes of destroying the Web Notification database
    altogether.
  </summary>
</histogram>

<histogram name="Notifications.Database.ExpiredNotificationCount"
    units="notifications" expires_after="M94">
  <owner>knollr@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    Records the number of expired notifications that were stored in the database
    and therefore got removed and closed on the system. Logged once at startup
    and every time we synchronize notifications after that (e.g. to schedule the
    next notification trigger event).
  </summary>
</histogram>

<histogram name="Notifications.Database.OldestNotificationTimeInMinutes"
    units="minutes" expires_after="2021-08-22">
  <owner>knollr@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <owner>adelm@google.com</owner>
  <summary>
    Records the age of the oldest notification for an origin. Logged after
    handling a push event for that origin.
  </summary>
</histogram>

<histogram name="Notifications.Database.OpenAfterCorruptionResult"
    enum="NotificationDatabaseStatus" expires_after="M94">
  <owner>knollr@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    Records the result status codes of opening the Web Notification database
    after it has been destroyed in response to data corruption.
  </summary>
</histogram>

<histogram name="Notifications.Database.OpenResult"
    enum="NotificationDatabaseStatus" expires_after="never">
<!-- expires-never: core storage metric; consumed in separate dashboard (go/chrome-storage-dashboard) -->

  <owner>knollr@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    Records the result status codes of opening the Web Notification database.
  </summary>
</histogram>

<histogram name="Notifications.Database.ReadForServiceWorkerResult"
    enum="NotificationDatabaseStatus" expires_after="M94">
  <owner>knollr@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    Records the result status codes of reading data of all notifications
    associated with a Service Worker from the Web Notification database.
  </summary>
</histogram>

<histogram name="Notifications.Database.ReadResourcesForTriggeredResult"
    enum="NotificationDatabaseStatus" expires_after="M94">
  <owner>knollr@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    Records the result status codes of reading resources for a notification from
    the Web Notification database. This happens when a previously scheduled
    notification has triggered.
  </summary>
</histogram>

<histogram name="Notifications.Database.ReadResourcesResult"
    enum="NotificationDatabaseStatus" expires_after="M94">
  <owner>knollr@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    Records the result status codes of reading resources for a notification from
    the Web Notification database. This happens when a scheduled notification is
    read from the database.
  </summary>
</histogram>

<histogram name="Notifications.Database.ReadResult"
    enum="NotificationDatabaseStatus" expires_after="2021-08-22">
  <owner>knollr@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    Records the result status codes of reading data of a single notification
    from the Web Notification database.
  </summary>
</histogram>

<histogram name="Notifications.Database.WriteResult"
    enum="NotificationDatabaseStatus" expires_after="2021-08-22">
  <owner>knollr@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    Records the result status codes of writing data for a notification to the
    Web Notification database.
  </summary>
</histogram>

<histogram name="Notifications.Database.WriteTriggeredResult"
    enum="NotificationDatabaseStatus" expires_after="M94">
  <owner>knollr@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    Records the result status codes of updating the triggered flag for a
    notification in the Web Notification database. This happens after fetching
    data and resources for a triggered notification, just before displaying it.
  </summary>
</histogram>

<histogram base="true" name="Notifications.Freedesktop.Capabilities"
    enum="BooleanSupported" expires_after="M90">
<!-- Name completed by histogram_suffixes name="FreedesktopNotificationCapabilitiesId" -->

  <owner>thomasanderson@chromium.org</owner>
  <summary>
    Whether the notification server supports the capability in question. (Linux
    only) Logged when the proxy to /org/Freedesktop/Notifications is set up
    successfully, which happens at most once on startup.
  </summary>
</histogram>

<histogram name="Notifications.Linux.BridgeInitializationStatus"
    enum="LinuxNotificationBridgeStatusCode" expires_after="M77">
  <owner>thomasanderson@chromium.org</owner>
  <summary>
    The status code for initializing NotificationPlatformBridgeLinux. (Linux
    only) Logged on each start up.
  </summary>
</histogram>

<histogram name="Notifications.LoadProfileResult" enum="BooleanSuccess"
    expires_after="M96">
  <owner>knollr@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    Records the result of loading the profile when forwarding a notification
    event. Logged on each notification action (click, close, settings, disable)
    on platforms that use system notifications (not on Chrome OS or when we're
    using Chrome's notifications).
  </summary>
</histogram>

<histogram name="Notifications.macOS.ActionReceived.{Style}"
    enum="BooleanValid" expires_after="M96">
  <owner>knollr@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    Whether the received notification action data is valid or not. If it is, we
    will continue to pass along the event. Logged on every action received by
    the system (click or close) on any {Style} style notification.
  </summary>
  <token key="Style">
    <variant name="Alert"/>
    <variant name="Banner"/>
  </token>
</histogram>

<histogram name="Notifications.macOS.Delivered.{Style}" enum="BooleanSuccess"
    expires_after="M96">
  <owner>knollr@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    Whether delivering a notification to the system was successful or not.
    Logged every time we pass a notification with {Style} style to the system.
  </summary>
  <token key="Style">
    <variant name="Alert"/>
    <variant name="Banner"/>
  </token>
</histogram>

<histogram name="Notifications.macOS.ServiceProcessKilled" units="ms"
    expires_after="M96">
  <owner>knollr@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    The runtime of the macOS notification service process to display alerts
    before it got killed unexpectedly. Logged when the service process dies.
  </summary>
</histogram>

<histogram name="Notifications.macOS.ServiceProcessRuntime" units="ms"
    expires_after="M96">
  <owner>knollr@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    The runtime of the macOS notification service process to display alerts.
    Logged when we close the connection to the service process either on purpose
    or after it got killed unexpectedly.
  </summary>
</histogram>

<histogram name="Notifications.NotificationHelper.ComServerModuleStatus"
    enum="NotificationHelperComServerModuleStatus" expires_after="M87">
  <owner>finnur@chromium.org</owner>
  <summary>
    The execute status of a ComServerModule class instance. Logged whenever a
    notification_helper process is launched by Windows.
  </summary>
</histogram>

<histogram
    name="Notifications.NotificationHelper.NotificationActivatorPrimaryStatus"
    enum="NotificationHelperNotificationActivatorPrimaryStatus"
    expires_after="M85">
  <owner>chengx@chromium.org</owner>
  <owner>finnur@chromium.org</owner>
  <summary>
    The primary execute status of NotificationActivator::Activate. Logged
    whenever a notification_helper process is launched by Windows.
  </summary>
</histogram>

<histogram
    name="Notifications.NotificationHelper.NotificationActivatorSecondaryStatus"
    enum="NotificationHelperNotificationActivatorSecondaryStatus"
    expires_after="M85">
  <owner>chengx@chromium.org</owner>
  <owner>finnur@chromium.org</owner>
  <summary>
    The secondary execute status of NotificationActivator::Activate. Logged
    whenever a notification_helper process is launched by Windows.
  </summary>
</histogram>

<histogram name="Notifications.NotificationHelper.ServerRuntime" units="ms"
    expires_after="M87">
  <owner>finnur@chromium.org</owner>
  <summary>
    The runtime of the notification_helper server process. This process is
    created when a notification is activated from the Windows Action Center.
    Once created, this process does some COM class registration work, so that
    Windows can call certain APIs to handle the notification activation. Upon
    finishing the API calls, Windows signals this process to exit.
  </summary>
</histogram>

<histogram name="Notifications.NotifierType" enum="NotifierType"
    expires_after="2021-12-31">
  <owner>tbarzic@chromium.org</owner>
  <owner>tengs@chromium.org</owner>
  <owner>gzadina@google.com</owner>
  <summary>
    The number of times a notification was added for the various types of
    sources.
  </summary>
</histogram>

<histogram name="Notifications.Permissions.RevokeDeleteCount" units="units"
    expires_after="2021-08-22">
  <owner>knollr@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    The number of notifications that got deleted from the NotificationDatabase
    after the notification permissions got revoked.
  </summary>
</histogram>

<histogram
    name="Notifications.Permissions.UNNotification.Banners.PermissionStatus"
    enum="UNNotificationPermissionStatus" expires_after="2021-08-22">
  <owner>adelm@google.com</owner>
  <owner>knollr@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    The permission status for sending out UNNotifications through the
    Notification Platform Bridge Mac UNNotification. This is recorded while
    instantiating the bridge.
  </summary>
</histogram>

<histogram name="Notifications.Permissions.UNNotification.Banners.Style"
    enum="UNNotificationStyle" expires_after="M94">
  <owner>adelm@google.com</owner>
  <owner>knollr@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    The style of notifications being used for sending out UNNotifications
    through the Notification Platform Bridge Mac UNNotification. This is
    recorded while instantiating the bridge.
  </summary>
</histogram>

<histogram name="Notifications.PerNotificationActions"
    enum="NotificationActionType" expires_after="M85">
  <owner>dewittj@chromium.org</owner>
  <summary>
    The actions taken on notifications, recorded once per notification, when it
    is closed. This differs from the Notifications.Actions histogram in that
    multiple events of the same type on a single notification will only record a
    single UMA event.
  </summary>
</histogram>

<histogram name="Notifications.PersistentNotificationActionCount"
    units="buttons" expires_after="2021-08-22">
  <owner>peter@chromium.org</owner>
  <summary>
    The number of action buttons the developer provided for a persistent Web
    Notification. Logged whenever showNotification is called.
  </summary>
</histogram>

<histogram name="Notifications.PersistentNotificationDisplayResult"
    enum="PersistentNotificationDisplayResult" expires_after="2021-08-22">
  <owner>knollr@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    The result of the promise returned by showNotification. Logged whenever
    showNotification is called.
  </summary>
</histogram>

<histogram name="Notifications.PersistentWebNotificationClickEventResult"
    enum="ServiceWorkerStatusCode" expires_after="2021-08-22">
  <owner>peter@chromium.org</owner>
  <owner>knollr@chromium.org</owner>
  <summary>
    Recorded delivery status for persistent notification clicks to a Service
    Worker when handling a click on a persistent WebNotification has finished.
  </summary>
</histogram>

<histogram name="Notifications.PersistentWebNotificationClickResult"
    enum="PlatformNotificationStatus" expires_after="2021-08-22">
  <owner>peter@chromium.org</owner>
  <owner>deepak.m1@samsung.com</owner>
  <summary>
    Recorded delivery status for persistent notification clicks to a Service
    Worker when handling a click on a persistent WebNotification has finished.
  </summary>
</histogram>

<histogram name="Notifications.PersistentWebNotificationCloseEventResult"
    enum="ServiceWorkerStatusCode" expires_after="2021-08-22">
  <owner>peter@chromium.org</owner>
  <owner>knollr@chromium.org</owner>
  <summary>
    Records delivery status for persistent notification close events sent to a
    Service Worker when the event has been handled.
  </summary>
</histogram>

<histogram name="Notifications.PersistentWebNotificationCloseResult"
    enum="PlatformNotificationStatus" expires_after="2021-08-22">
  <owner>peter@chromium.org</owner>
  <owner>knollr@chromium.org</owner>
  <summary>
    Records delivery status for persistent notification close events sent to a
    Service Worker when the event has been handled.
  </summary>
</histogram>

<histogram name="Notifications.Scheduler.BackgroundTask.Event"
    enum="NotificationSchedulerBackgroundTaskEvent" expires_after="2021-07-01">
  <owner>xingliu@chromium.org</owner>
  <owner>hesen@chromium.org</owner>
  <summary>
    Records the various events when running the background task in notification
    scheduling system.
  </summary>
</histogram>

<histogram name="Notifications.Scheduler.BackgroundTask.NotificationShown"
    units="notifications" expires_after="2021-07-01">
  <owner>xingliu@chromium.org</owner>
  <owner>hesen@chromium.org</owner>
  <summary>
    Records the number of notifications shown in each background task run.
  </summary>
</histogram>

<histogram name="Notifications.Scheduler.BackgroundTask.Start" units="hours"
    expires_after="2021-09-05">
  <owner>xingliu@chromium.org</owner>
  <owner>hesen@chromium.org</owner>
  <summary>
    Records the hour (0-23) when the notification scheduler background task
    starts.
  </summary>
</histogram>

<histogram name="Notifications.Scheduler.IconDb.InitResult"
    enum="BooleanSuccess" expires_after="2021-09-05">
  <owner>xingliu@chromium.org</owner>
  <owner>hesen@chromium.org</owner>
  <summary>
    Records the initialization result of icon database for the notification
    scheduling system.
  </summary>
</histogram>

<histogram name="Notifications.Scheduler.IconDb.OperationResult"
    enum="BooleanSuccess" expires_after="2021-07-01">
  <owner>xingliu@chromium.org</owner>
  <owner>hesen@chromium.org</owner>
  <summary>
    Records the database operation result (except initialization) of icon
    database for the notification scheduling system.
  </summary>
</histogram>

<histogram name="Notifications.Scheduler.IconDb.RecordCount" units="records"
    expires_after="2021-07-01">
  <owner>xingliu@chromium.org</owner>
  <owner>hesen@chromium.org</owner>
  <summary>
    Records the number of records of icon database for the notification
    scheduling system when the icon database is initialized.
  </summary>
</histogram>

<histogram name="Notifications.Scheduler.IhnrActionButtonEvent"
    enum="NotificationSchedulerActionButtonEvent" expires_after="2021-07-01">
<!-- Name completed by histogram_suffixes name="NotificationSchedulerClientType" -->

  <owner>xingliu@chromium.org</owner>
  <owner>hesen@chromium.org</owner>
  <summary>
    Records events for inline helpful/unhelpful action buttons on the
    notification when the buttons are shown or clicked.
  </summary>
</histogram>

<histogram name="Notifications.Scheduler.Impression.Count" units="records"
    expires_after="2021-09-05">
<!-- Name completed by histogram_suffixes name="NotificationSchedulerClientType" -->

  <owner>xingliu@chromium.org</owner>
  <owner>hesen@chromium.org</owner>
  <summary>
    Records the number of impression records in impression db right after the
    impression database is initialized.
  </summary>
</histogram>

<histogram name="Notifications.Scheduler.Impression.Event"
    enum="NotificationSchedulerImpressionEvent" expires_after="2021-07-01">
  <owner>xingliu@chromium.org</owner>
  <owner>hesen@chromium.org</owner>
  <summary>
    Records various events in impression history tracker in notification
    scheduling system when the user interacts with the notification.
  </summary>
</histogram>

<histogram name="Notifications.Scheduler.ImpressionDb.InitResult"
    enum="BooleanSuccess" expires_after="2021-07-01">
  <owner>xingliu@chromium.org</owner>
  <owner>hesen@chromium.org</owner>
  <summary>
    Records the initialization result of impression database for the
    notification scheduling system.
  </summary>
</histogram>

<histogram name="Notifications.Scheduler.ImpressionDb.OperationResult"
    enum="BooleanSuccess" expires_after="2021-07-01">
  <owner>xingliu@chromium.org</owner>
  <owner>hesen@chromium.org</owner>
  <summary>
    Records the database operation result (except initialization) of impression
    database for the notification scheduling system.
  </summary>
</histogram>

<histogram name="Notifications.Scheduler.ImpressionDb.RecordCount"
    units="records" expires_after="2021-07-01">
  <owner>xingliu@chromium.org</owner>
  <owner>hesen@chromium.org</owner>
  <summary>
    Records the number of records of impression database for the notification
    scheduling system when the impression database is initialized.
  </summary>
</histogram>

<histogram name="Notifications.Scheduler.NotificationDb.InitResult"
    enum="BooleanSuccess" expires_after="2021-09-05">
  <owner>xingliu@chromium.org</owner>
  <owner>hesen@chromium.org</owner>
  <summary>
    Records the initialization result of notification database for the
    notification scheduling system.
  </summary>
</histogram>

<histogram name="Notifications.Scheduler.NotificationDb.OperationResult"
    enum="BooleanSuccess" expires_after="2021-07-01">
  <owner>xingliu@chromium.org</owner>
  <owner>hesen@chromium.org</owner>
  <summary>
    Records the database operation result (except initialization) of
    notification database for the notification scheduling system.
  </summary>
</histogram>

<histogram name="Notifications.Scheduler.NotificationDb.RecordCount"
    units="records" expires_after="2021-07-01">
  <owner>xingliu@chromium.org</owner>
  <owner>hesen@chromium.org</owner>
  <summary>
    Records the number of records of notification database for the notification
    scheduling system when the notification database is initialized.
  </summary>
</histogram>

<histogram name="Notifications.Scheduler.NotificationLifeCycleEvent"
    enum="NotificationSchedulerNotificationLifeCycleEvent"
    expires_after="2021-09-05">
<!-- Name completed by histogram_suffixes name="NotificationSchedulerClientType" -->

  <owner>xingliu@chromium.org</owner>
  <owner>hesen@chromium.org</owner>
  <summary>
    Records life cycle events for a scheduled notification, when notification is
    scheduled, shown or encountering any error.
  </summary>
</histogram>

<histogram name="Notifications.Scheduler.PngIconConverter.DecodeResult"
    enum="BooleanSuccess" expires_after="2021-07-01">
  <owner>xingliu@chromium.org</owner>
  <owner>hesen@chromium.org</owner>
  <summary>
    Records the result of png icon converter decoding process in icon store for
    the notification scheduling system. It will be logged typically when
    scheduling system trying to display the notification to the client - the
    icon store will load entries, and decode icons to PNG format for delivery.
  </summary>
</histogram>

<histogram name="Notifications.Scheduler.PngIconConverter.EncodeResult"
    enum="BooleanSuccess" expires_after="2021-07-01">
  <owner>xingliu@chromium.org</owner>
  <owner>hesen@chromium.org</owner>
  <summary>
    Records the result of png icon converter encoding process in icon store for
    the notification scheduling system. It will be logged typically when the
    client scheduled notification with icons - the icon store will then encode
    icons to string and store them in protodb.
  </summary>
</histogram>

<histogram name="Notifications.Scheduler.UserAction"
    enum="NotificationSchedulerUserActionType" expires_after="2021-09-05">
<!-- Name completed by histogram_suffixes name="NotificationSchedulerClientType" -->

  <owner>xingliu@chromium.org</owner>
  <owner>dtrainor@chromium.org</owner>
  <summary>
    Records the type of user action when the user interacts with notification
    sent from notification scheduler system.
  </summary>
</histogram>

<histogram name="Notifications.Triggers.DisplayDelay" units="ms"
    expires_after="M91">
  <owner>knollr@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    Delay between the expected and actual display time of a notification.
    Recorded just before displaying a notification with a show trigger.
  </summary>
</histogram>

<histogram name="Notifications.Triggers.HasShowTrigger" enum="Boolean"
    expires_after="2021-08-22">
  <owner>knollr@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    Indicates if the notificaiton has a show trigger. This is recorded before a
    notification is written to the database if the notification triggers feature
    is enabled.
  </summary>
</histogram>

<histogram name="Notifications.Triggers.ShowTriggerDelay" units="days"
    expires_after="2021-06-27">
  <owner>knollr@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    The specified delay until the notification is displayed. This is recorded
    before writing a notification with a valid show trigger to the database.
  </summary>
</histogram>

<histogram name="Notifications.UsingNativeNotificationCenter"
    enum="BooleanNativeNotifications" expires_after="never">
  <obsolete>
    Replaced by Notifications.UsingSystemNotificationCenter in October 2020.
  </obsolete>
<!-- expires-never: core to the notification user experience. -->

  <owner>peter@chromium.org</owner>
  <owner>knollr@chromium.org</owner>
  <owner>thomasanderson@chromium.org</owner>
  <summary>
    Indicates if Chrome is using system notifications or the Chrome notification
    center. Logged on each start up.
  </summary>
</histogram>

<histogram name="Notifications.UsingSystemNotificationCenter"
    enum="BooleanSystemNotifications" expires_after="never">
<!-- expires-never: core to the notification user experience. -->

  <owner>peter@chromium.org</owner>
  <owner>knollr@chromium.org</owner>
  <owner>thomasanderson@chromium.org</owner>
  <summary>
    Indicates if Chrome is using system notifications or the Chrome notification
    center. Logged on each start up.
  </summary>
</histogram>

<histogram name="Notifications.WebPlatform.{Action}.TimeToActivity" units="ms"
    expires_after="M96">
  <obsolete>
    From 2021-03 use Notifications.WebPlatform2 instead.
  </obsolete>
  <owner>peconn@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    Records the delay between the user clicking on the {Action} of a web
    platform notification, and an Activity being launched. Only records if the
    duration is less than 5 seconds.
  </summary>
  <token key="Action">
    <variant name="ActionButton" summary="action button"/>
    <variant name="Body" summary="body"/>
  </token>
</histogram>

<histogram name="Notifications.WebPlatform.{Action}.TimeToClose" units="ms"
    expires_after="M96">
  <obsolete>
    From 2021-03 use Notifications.WebPlatform2 instead.
  </obsolete>
  <owner>peconn@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    Records the delay between the user clicking on the {Action} of a web
    platform notification, and the notification being closed. Only records if
    the duration is less than 5 seconds.
  </summary>
  <token key="Action">
    <variant name="ActionButton" summary="action button"/>
    <variant name="Body" summary="body"/>
  </token>
</histogram>

<histogram name="Notifications.WebPlatformV2.{Action}.TimeToActivity"
    units="ms" expires_after="M96">
  <owner>peconn@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    Records the delay between the user clicking on the {Action} of a web
    platform notification, and an Activity being launched. Only records if the
    duration is less than 10 seconds.
  </summary>
  <token key="Action">
    <variant name="ActionButton" summary="action button"/>
    <variant name="Body" summary="body"/>
  </token>
</histogram>

<histogram name="Notifications.WebPlatformV2.{Action}.TimeToClose" units="ms"
    expires_after="M96">
  <owner>peconn@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    Records the delay between the user clicking on the {Action} of a web
    platform notification, and the notification being closed. Only records if
    the duration is less than 10 seconds.
  </summary>
  <token key="Action">
    <variant name="ActionButton" summary="action button"/>
    <variant name="Body" summary="body"/>
  </token>
</histogram>

<histogram name="Notifications.Windows.ActivationStatus"
    enum="WindowsNotificationActivationStatus" expires_after="M94">
  <owner>finnur@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <owner>chengx@chromium.org</owner>
  <summary>
    The status of Activation requests in NotificationPlatformBridgeWin (Windows
    only). Logged whenever an activation from a notification occurs.
  </summary>
</histogram>

<histogram name="Notifications.Windows.CloseStatus"
    enum="WindowsNotificationCloseStatus" expires_after="M94">
  <owner>finnur@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    The status of Close requests in NotificationPlatformBridgeWin (Windows
    only). Logged whenever a notification is closed.
  </summary>
</histogram>

<histogram name="Notifications.Windows.CreateToastManagerErrorCode"
    enum="Hresult" expires_after="M94">
  <owner>finnur@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    The HRESULT returned by the Windows Action Center, when trying to create a
    toast manager fails. This provides a more detailed error in the cases the
    histogram Notifications.Windows.DisplayStatus reported
    CREATE_TOAST_NOTIFIER_WITH_ID_FAILED.
  </summary>
</histogram>

<histogram name="Notifications.Windows.DisplayFailure" enum="Hresult"
    expires_after="M94">
  <owner>finnur@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    The HRESULT returned by the Windows Action Center, when showing a
    notification fails.
  </summary>
</histogram>

<histogram name="Notifications.Windows.DisplayStatus"
    enum="WindowsNotificationDisplayStatus" expires_after="M94">
  <owner>finnur@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    The status of Display requests in NotificationPlatformBridgeWin (Windows
    only). Logged whenever a notification is displayed. For a more detailed
    error about CREATE_TOAST_NOTIFIER_WITH_ID_FAILED and SHOWING_TOAST_FAILED,
    see Notification.Windows histograms CreateToastManagerErrorCode and
    ShowFailedErrorCode (respectively).
  </summary>
</histogram>

<histogram name="Notifications.Windows.GetDisplayedLaunchIdStatus"
    enum="WindowsNotificationGetDisplayedLaunchIdStatus" expires_after="M94">
  <owner>finnur@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    The status of decoding launch ids while processing a GetDisplayed requests
    in NotificationPlatformBridgeWin (Windows only). Logged whenever a request
    to retrieve all displayed notifications comes in.
  </summary>
</histogram>

<histogram name="Notifications.Windows.GetDisplayedStatus"
    enum="WindowsNotificationGetDisplayedStatus" expires_after="M94">
  <owner>finnur@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    The status of GetDisplayedStatus requests in NotificationPlatformBridgeWin
    (Windows only). Logged whenever a request to retrieve all displayed
    notifications comes in.
  </summary>
</histogram>

<histogram name="Notifications.Windows.GetNotificationLaunchIdStatus"
    enum="WindowsNotificationGetNotificationLaunchIdStatus" expires_after="M94">
  <owner>finnur@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    The status of GetNotificationLaunchId requests in
    NotificationPlatformBridgeWin (Windows only). Logged whenever a request to
    decode the GetNotificationLaunchId comes in.
  </summary>
</histogram>

<histogram name="Notifications.Windows.GetSettingPolicy"
    enum="WindowsNotificationGetSettingPolicy" expires_after="M94">
  <owner>finnur@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    The policy value provided by get_Setting in NotificationPlatformBridgeWin
    (Windows only). Logged whenever a request to show a notification comes in.
  </summary>
</histogram>

<histogram name="Notifications.Windows.GetSettingPolicyStartup"
    enum="WindowsNotificationGetSettingPolicy" expires_after="M94">
  <owner>finnur@chromium.org</owner>
  <owner>knollr@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    The policy value provided by get_Setting in NotificationPlatformBridgeWin
    (Windows only). Logged only once at startup on a task runner.
  </summary>
</histogram>

<histogram name="Notifications.Windows.GetSettingStatus"
    enum="WindowsNotificationGetSettingStatus" expires_after="M94">
  <owner>finnur@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    The return value of get_Setting calls in NotificationPlatformBridgeWin
    (Windows only). Logged whenever a request to show a notification comes in.
  </summary>
</histogram>

<histogram name="Notifications.Windows.GetSettingStatusStartup"
    enum="WindowsNotificationGetSettingStatus" expires_after="M94">
  <owner>finnur@chromium.org</owner>
  <owner>knollr@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    The return value of get_Setting calls in NotificationPlatformBridgeWin
    (Windows only). Logged only once at startup on a task runner.
  </summary>
</histogram>

<histogram name="Notifications.Windows.HandleEventStatus"
    enum="WindowsNotificationHandleEventStatus" expires_after="M94">
  <owner>finnur@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    The status of HandleEvent requests in NotificationPlatformBridgeWin (Windows
    only). Logged whenever a notification event is being handled.
  </summary>
</histogram>

<histogram name="Notifications.Windows.HistoryStatus"
    enum="WindowsNotificationHistoryStatus" expires_after="M94">
  <owner>finnur@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    The status of History requests in NotificationPlatformBridgeWin (Windows
    only). Logged whenever history is requested for notifications.
  </summary>
</histogram>

<histogram name="Notifications.Windows.LaunchIdDecodeStatus"
    enum="WindowsNotificationLaunchIdDecodeStatus" expires_after="M87">
  <owner>chengx@chromium.org</owner>
  <owner>finnur@chromium.org</owner>
  <summary>
    Used to indicate the status of decoding an input launch id string (Windows
    only). Logged whenever a notification event is being handled.
  </summary>
</histogram>

<histogram name="Notifications.Windows.OnFailedStatus"
    enum="WindowsNotificationOnFailedStatus" expires_after="M94">
  <owner>chengx@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    The status of OnFailed requests in NotificationPlatformBridgeWin (Windows
    only). Logged whenever a failed event is handled.
  </summary>
</histogram>

<histogram name="Notifications.Windows.SetReadyCallbackStatus2"
    enum="WindowsNotificationSetReadyCallbackStatus2" expires_after="M94">
  <owner>chengx@chromium.org</owner>
  <owner>finnur@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    The status of SetReadyCallback requests in NotificationPlatformBridgeWin
    (Windows only). Logged once at startup.
  </summary>
</histogram>

<histogram name="Notifications.Windows.ShowFailedErrorCode" enum="Hresult"
    expires_after="M94">
  <owner>finnur@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    The HRESULT returned by the Windows Action Center, when trying to create a
    toast manager fails. This provides a more detailed error in the cases the
    histogram Notifications.Windows.DisplayStatus reported SHOWING_TOAST_FAILED.
  </summary>
</histogram>

<histogram name="Notifications.Windows.StartMenuShortcutStatus"
    enum="WindowsNotificationStartMenuShortcutStatus" expires_after="M94">
  <owner>chengx@chromium.org</owner>
  <owner>finnur@chromium.org</owner>
  <owner>peter@chromium.org</owner>
  <summary>
    Used to indicate the status of start menu shortcut (Windows only). Logged
    whenever a notification display attempt is made.
  </summary>
</histogram>

<histogram name="Notifications.XPCConnectionEvent" enum="XPCConnectionEvent"
    expires_after="M94">
  <owner>peter@chromium.org</owner>
  <owner>rsesek@chromium.org</owner>
  <summary>
    Mac only. Records the different events of a Notification XPC connection.
    These are recorded by monitoring the different error callbacks provided by
    the XPC connection object.
  </summary>
</histogram>

</histograms>

</histogram-configuration>