<!--
Copyright 2020 The Chromium Authors
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 Bookmarks 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 follow the instructions in the OWNERS file in this directory to find a
reviewer. If no OWNERS file exists, please consider signing up at
go/reviewing-metrics (Googlers only), as all subdirectories are expected to
have an OWNERS file. As a last resort you can send the CL to
chromium-metrics-reviews@google.com.
-->

<histogram-configuration>

<histograms>

<histogram name="BookmarkManager.CommandExecuted" enum="BookmarkManagerCommand"
    expires_after="never">
<!-- expires-never: part of top-line metric (internal: go/chrome-browser-nsm) -->

  <owner>johntlee@chromium.org</owner>
  <owner>chrome-analysis-team@google.com</owner>
  <summary>
    Logs when a user action triggers a command in the bookmark manager. Commands
    can be triggered by keyboard shortcuts, menu items or other buttons in the
    UI.

    Revised in M-76 when the &quot;Open (double click/enter)&quot; bucket was
    split into two separate buckets, one for bookmarks and one for folders.

    This histogram is of special interest to the chrome-analysis-team@. Do not
    change its semantics or retire it without talking to them first.
  </summary>
</histogram>

<histogram name="BookmarkManager.NumDragged" units="bookmarks"
    expires_after="M85">
  <owner>johntlee@chromium.org</owner>
  <summary>
    Logs the number of bookmarks that were dragged simultaneously by a user.
  </summary>
</histogram>

<histogram name="BookmarkManager.ResultsRenderedTime" units="ms"
    expires_after="2024-02-20">
  <owner>johntlee@chromium.org</owner>
  <owner>dbeam@chromium.org</owner>
  <summary>
    Records the time taken to load the bookmarks Web UI and render. This is
    roughly equivalent to 'time to first meaningful paint' for the bookmark
    manager.
  </summary>
</histogram>

<histogram name="Bookmarks.AddedPerProfileType" enum="BrowserProfileType"
    expires_after="2024-03-17">
  <owner>rhalavati@chromium.org</owner>
  <owner>chrome-privacy-core@google.com</owner>
  <component>UI&gt;Browser&gt;Bookmarks</component>
  <summary>
    This histogram records when a bookmark is added sliced on profile type.

    This was not recorded for Android before M90. Reading list and partner
    bookmarks aren't reported by it.
  </summary>
</histogram>

<histogram
    name="Bookmarks.AttachedBar.CurrentTab.TimeToFirstVisuallyNonEmptyPaint"
    units="ms" expires_after="2024-01-31">
  <owner>tluk@chromium.org</owner>
  <owner>chrome-cros@google.com</owner>
  <component>UI&gt;Browser&gt;Bookmarks</component>
  <summary>
    Tracks the time between when the user first launches a bookmark from the
    attached bookmark bar into the current tab to when we receive the first
    visually non-empty paint. Emitted after the WebContents in the browser has
    been notified of the non-empty paint.
  </summary>
</histogram>

<histogram name="Bookmarks.AverageNodeSize" units="Bytes"
    expires_after="2024-02-11">
  <owner>wylieb@chromium.org</owner>
  <owner>chrome-collections@google.com</owner>
  <component>UI&gt;Browser&gt;Bookmarks</component>
  <summary>
    Records the average size of bookmark nodes on disk. Approximated by dividing
    the total size on disk by the number of non-folder nodes. Recorded at
    startup when the bookmark model is loaded from disk.
  </summary>
</histogram>

<histogram name="Bookmarks.BookmarkAllTabsWithTabsCount.Incognito" units="tabs"
    expires_after="2023-01-01">
  <owner>roagarwal@chromium.org</owner>
  <owner>sideyilmaz@chromium.org</owner>
  <owner>chrome-incognito@google.com</owner>
  <component>UI&gt;Browser&gt;Bookmarks</component>
  <summary>
    This histogram records the count of tabs when a user bookmarks all open
    tabs, in incognito mode.
  </summary>
</histogram>

<histogram name="Bookmarks.BookmarkAllTabsWithTabsCount.Regular" units="tabs"
    expires_after="2023-03-19">
  <owner>roagarwal@chromium.org</owner>
  <owner>sideyilmaz@chromium.org</owner>
  <owner>chrome-incognito@google.com</owner>
  <component>UI&gt;Browser&gt;Bookmarks</component>
  <summary>
    This histogram records the count of tabs when a user bookmarks all open
    tabs, in regular mode.
  </summary>
</histogram>

<histogram name="Bookmarks.BookmarksBar.DragDropType"
    enum="BookmarkBarDragDropType" expires_after="2024-02-11">
  <owner>dfried@chromium.org</owner>
  <owner>chrome-desktop-ui-sea@google.com</owner>
  <summary>
    Records whether a bookmarks bar drag-drop is from a URL (e.g. from the
    location bar) or from the bookmarks bar itself (which is effectively a
    move).
  </summary>
</histogram>

<histogram name="Bookmarks.BookmarksBarStatus.OnReadingListOpened"
    enum="BookmarkBarPrefAndState" expires_after="2022-08-28">
  <owner>corising@chromium.org</owner>
  <owner>chrome-desktop-ui-sea@google.com</owner>
  <component>UI&gt;Browser&gt;Bookmarks</component>
  <summary>
    This records the Boomarks bar pref state and status when the reading list is
    opened. This will help determine how often the reading list is accessed from
    the NTP where the bookmarks bar is always visible and the bookmark bar pref
    state for those from the NTP. (Desktop only).
  </summary>
</histogram>

<histogram name="Bookmarks.BookmarksInFolder" units="bookmarks"
    expires_after="M85">
  <owner>johntlee@chromium.org</owner>
  <component>UI&gt;Browser&gt;Bookmarks</component>
  <summary>
    Logs the number of bookmark items inside a folder every time a folder is
    opened inside the bookmark manager.
  </summary>
</histogram>

<histogram name="Bookmarks.Clone.NumCloned" units="bookmarks"
    expires_after="2024-01-20">
  <owner>wylieb@chromium.org</owner>
  <owner>chrome-collections@google.com</owner>
  <component>UI&gt;Browser&gt;Bookmarks</component>
  <summary>
    Records the number of bookmarks that were selected when a clone operation
    starts. It doesn't include the children included in folder copies.
  </summary>
</histogram>

<histogram name="Bookmarks.Count.OnProfileLoad" units="bookmarks"
    expires_after="2024-03-16">
  <obsolete>
    Logged on profile open, including for profiles that do not support
    bookmarks. (We did not investigate thoroughly; we don't know what value
    typically was logged. Presumably 0.) Replaced in M-107 with the histogram
    Bookmarks.Count.OnProfileLoad3, which is similar but only emitted on
    profiles that may support bookmarks.
  </obsolete>
  <owner>supertri@chromium.org</owner>
  <owner>isherman@chromium.org</owner>
  <owner>aidanday@google.com</owner>
  <owner>mamir@chromium.org</owner>
  <component>UI&gt;Browser&gt;Bookmarks</component>
  <summary>
    The total number of bookmarks a user has saved, excluding folders. Recorded
    when a profile is opened - precisely, when bookmarks are loaded into storage
    from disk. The count includes all bookmarks both in the &quot;Bookmarks
    Bar&quot; and also under &quot;Other Bookmarks&quot;.
  </summary>
</histogram>

<histogram name="Bookmarks.Count.OnProfileLoad3" units="bookmarks"
    expires_after="2024-03-17">
  <owner>supertri@chromium.org</owner>
  <owner>isherman@chromium.org</owner>
  <owner>aidanday@google.com</owner>
  <owner>mamir@chromium.org</owner>
  <component>UI&gt;Browser&gt;Bookmarks</component>
  <summary>
    The total number of bookmarks a user has saved, excluding folders. Recorded
    when a profile is opened - precisely, when bookmarks are loaded into storage
    from disk. The count includes all bookmarks both in the &quot;Bookmarks
    Bar&quot; and also under &quot;Other Bookmarks&quot;.

    Opening a guest session (guest profile) also causes an emit to this
    histogram even though guest sessions don't typically allow bookmarks. (The
    value emitted is typically zero.) Under certain enterpise configuration,
    guest sessions can have bookmarks.
  </summary>
</histogram>

<histogram name="Bookmarks.EditLocation" enum="BookmarkLaunchLocation"
    expires_after="2024-02-11">
  <owner>dfried@chromium.org</owner>
  <owner>mickeyburks@chromium.org</owner>
  <component>UI&gt;Browser&gt;Bookmarks</component>
  <summary>
    Logs a UI location from which a bookmark is edited, after the user opts to
    edit or rename a bookmark or folder via a context menu, and immediately
    before displaying the edit dialog.
  </summary>
</histogram>

<histogram name="Bookmarks.EditTitleSource" enum="BookmarkEditSource"
    expires_after="2024-03-24">
  <owner>wylieb@chromium.org</owner>
  <owner>chrome-collections@google.com</owner>
  <component>UI&gt;Browser&gt;Bookmarks</component>
  <summary>Records the edit action users take on their bookmarks.</summary>
</histogram>

<histogram name="Bookmarks.EditURLSource" enum="BookmarkEditSource"
    expires_after="2024-01-20">
  <owner>wylieb@chromium.org</owner>
  <owner>chrome-collections@google.com</owner>
  <component>UI&gt;Browser&gt;Bookmarks</component>
  <summary>Records the edit action users take on their bookmarks.</summary>
</histogram>

<histogram name="Bookmarks.EntryPoint" enum="BookmarksEntryPoint"
    expires_after="2024-02-25">
  <owner>ianwen@chromium.org</owner>
  <component>UI&gt;Browser&gt;Bookmarks</component>
  <summary>How users add a new bookmark.</summary>
</histogram>

<histogram name="Bookmarks.LaunchLocation" enum="BookmarkLaunchLocation"
    expires_after="2024-03-17">
  <owner>ianwen@chromium.org</owner>
  <component>UI&gt;Browser&gt;Bookmarks</component>
  <summary>Logs a UI location from which a bookmark is launched.</summary>
</histogram>

<histogram name="Bookmarks.MobileBookmarkManager.DisplayOptionUsed"
    enum="MobileBookmarkManagerBookmarkRowDisplayPref"
    expires_after="2024-01-14">
  <owner>wylieb@chromium.org</owner>
  <owner>chrome-collections@google.com</owner>
  <component>UI&gt;Browser&gt;Bookmarks</component>
  <summary>
    Records when a user interacts with the display options in the mobile
    bookmarks manager.
  </summary>
</histogram>

<histogram name="Bookmarks.MobileBookmarkManager.FilterUsed"
    enum="MobileBookmarkManagerFilter" expires_after="2024-01-14">
  <owner>wylieb@chromium.org</owner>
  <owner>chrome-collections@google.com</owner>
  <component>UI&gt;Browser&gt;Bookmarks</component>
  <summary>
    Records when a user interacts with the filter options in the mobile
    bookmarks manager.
  </summary>
</histogram>

<histogram name="Bookmarks.MobileBookmarkManager.SortOptionUsed"
    enum="MobileBookmarkManagerBookmarkRowSortOrder" expires_after="2024-01-14">
  <owner>wylieb@chromium.org</owner>
  <owner>chrome-collections@google.com</owner>
  <component>UI&gt;Browser&gt;Bookmarks</component>
  <summary>
    Records when a user interacts with the sort options in the mobile bookmarks
    manager.
  </summary>
</histogram>

<histogram
    name="Bookmarks.MultipleOpened.OpenBookmarkTimeInterval2.{BookmarkType}"
    units="ms" expires_after="2024-01-20">
  <owner>wylieb@chromium.org</owner>
  <owner>chrome-collections@google.com</owner>
  <component>UI&gt;Browser&gt;Bookmarks</component>
  <summary>
    Records the time interval between the time the bookmark was added/opened.

    Recorded when multi-selection is opened from the bookmark manager. Possible
    that the selection is only 1 bookmark.
  </summary>
  <token key="BookmarkType">
    <variant name="Normal" summary="a normal bookmark."/>
    <variant name="Partner" summary="a partner bookmark."/>
    <variant name="ReadingList" summary="a reading list article."/>
  </token>
</histogram>

<histogram name="Bookmarks.MultipleOpened.OpenBookmarkType" enum="BookmarkType"
    expires_after="2024-01-20">
  <owner>wylieb@chromium.org</owner>
  <owner>chrome-collections@google.com</owner>
  <component>UI&gt;Browser&gt;Bookmarks</component>
  <summary>
    Logs whether the bookmark entry is a user bookmark or a partner bookmark
    when it is opened.

    Recorded when multi-selection is opened from the bookmark manager. Possible
    that the selection is only 1 bookmark.
  </summary>
</histogram>

<histogram name="Bookmarks.OpenBookmarkManager.PerProfileType"
    enum="BrowserProfileType" expires_after="2024-02-11">
  <owner>roagarwal@chromium.org</owner>
  <owner>chrome-incognito@google.com</owner>
  <component>UI&gt;Browser&gt;Bookmarks</component>
  <summary>
    This records the number of times the bookmark manager is opened from regular
    or Incognito tab. This histogram only records the count from
    ChromeTabbedActivity where we actually have the Bookmark manager UI.
    Recorded when the bookmark menu item is clicked in Android.
  </summary>
</histogram>

<histogram name="Bookmarks.OpenBookmarkTimeInterval2.{BookmarkType}" units="ms"
    expires_after="2024-03-24">
  <owner>wylieb@chromium.org</owner>
  <owner>chrome-collections@google.com</owner>
  <component>UI&gt;Browser&gt;Bookmarks</component>
  <summary>
    A new version of Bookmarks.OpenBookmarkTimeInterval.{BookmarkType}, to rule
    out corrupted data introduced by a timestamp bug.
  </summary>
  <token key="BookmarkType">
    <variant name="Normal" summary="a normal bookmark."/>
    <variant name="Partner" summary="a partner bookmark."/>
    <variant name="ReadingList" summary="a reading list article."/>
  </token>
</histogram>

<histogram name="Bookmarks.OpenBookmarkType" enum="BookmarkType"
    expires_after="2024-03-24">
  <owner>wylieb@chromium.org</owner>
  <owner>chrome-collections@google.com</owner>
  <component>UI&gt;Browser&gt;Bookmarks</component>
  <summary>
    Logs whether the bookmark entry is a user bookmark or a partner bookmark
    when it is opened.
  </summary>
</histogram>

<histogram name="Bookmarks.Opened.TimeSinceAdded" units="days"
    expires_after="2024-03-24">
  <owner>wylieb@chromium.org</owner>
  <owner>chrome-collections@google.com</owner>
  <component>UI&gt;Browser&gt;Bookmarks</component>
  <summary>
    This histogram records when a bookmark is added sliced by when it was added.

    Prior to M111 this histogram was overcounting events, and the data shouldn't
    be used.
  </summary>
</histogram>

<histogram name="Bookmarks.Opened.TimeSinceLastUsed" units="days"
    expires_after="2024-03-24">
  <owner>wylieb@chromium.org</owner>
  <owner>chrome-collections@google.com</owner>
  <component>UI&gt;Browser&gt;Bookmarks</component>
  <summary>
    This histogram records when a bookmark is added sliced by when it was last
    used.

    Prior to M111 this histogram was overcounting events, and the data shouldn't
    be used.
  </summary>
</histogram>

<histogram name="Bookmarks.ParentFolderType" enum="BookmarkFolderType"
    expires_after="2024-03-03">
  <owner>emshack@chromium.org</owner>
  <owner>chrome-desktop-ui-sea@google.com</owner>
  <component>UI&gt;Browser&gt;Bookmarks</component>
  <summary>
    This histogram records the parent folder added to whenever a bookmark is
    created or moved.
  </summary>
</histogram>

<histogram name="Bookmarks.ReadingList.NumberOfItems" units="items"
    expires_after="2024-03-24">
  <owner>wylieb@chromium.org</owner>
  <component>UI&gt;Browser&gt;Bookmarks</component>
  <component>UI&gt;Browser&gt;Mobile&gt;ReadingList</component>
  <summary>
    Logs the total number of reading list items shown in the reading list on the
    Android Bookmarks page when it is opened.
  </summary>
</histogram>

<histogram name="Bookmarks.ReadingList.NumberOfReadItems" units="items"
    expires_after="2024-01-20">
  <owner>wylieb@chromium.org</owner>
  <component>UI&gt;Browser&gt;Bookmarks</component>
  <component>UI&gt;Browser&gt;Mobile&gt;ReadingList</component>
  <summary>
    Logs the number of read items shown in the reading list on the Android
    Bookmarks page when it is opened.
  </summary>
</histogram>

<histogram name="Bookmarks.ReadingList.NumberOfUnreadItems" units="items"
    expires_after="2024-01-20">
  <owner>wylieb@chromium.org</owner>
  <component>UI&gt;Browser&gt;Bookmarks</component>
  <component>UI&gt;Browser&gt;Mobile&gt;ReadingList</component>
  <summary>
    Logs the number of unread items shown in the reading list on the Android
    Bookmarks page when it is opened.
  </summary>
</histogram>

<histogram name="Bookmarks.RemovedLocation" enum="BookmarkLaunchLocation"
    expires_after="2024-02-11">
  <owner>dfried@chromium.org</owner>
  <owner>mickeyburks@chromium.org</owner>
  <component>UI&gt;Browser&gt;Bookmarks</component>
  <summary>
    Logs a UI location from which one or more bookmarks are removed, after the
    user requests them to be removed via a menu and immediately before they are
    actually removed.
  </summary>
</histogram>

<histogram name="Bookmarks.RemovedSource" enum="BookmarkEditSource"
    expires_after="2024-03-24">
  <owner>wylieb@chromium.org</owner>
  <owner>chrome-collections@google.com</owner>
  <component>UI&gt;Browser&gt;Bookmarks</component>
  <summary>Records the source when a bookmark is removed.</summary>
</histogram>

<histogram name="Bookmarks.StarEntryPoint.ClickedAction"
    enum="StarEntryPointAction" expires_after="2022-08-28">
  <owner>corising@chromium.org</owner>
  <owner>chrome-desktop-ui-sea@google.com</owner>
  <component>UI&gt;Browser&gt;Bookmarks</component>
  <summary>
    Recorded when an action in the Bookmark icon menu is clicked.
  </summary>
</histogram>

<histogram name="Bookmarks.Storage.FileSizeAtStartup" units="KB"
    expires_after="2023-04-21">
  <obsolete>
    Logged on profile open, including for profiles that do not support
    bookmarks. (We did not investigate thoroughly; we don't know what value
    typically was logged. Presumably 0.) Replaced in M-107 with
    Bookmarks.Storage.FileSizeAtStartup2, which is similar but only emitted on
    profiles that may support bookmarks.
  </obsolete>
  <owner>wylieb@chromium.org</owner>
  <owner>chrome-collections@google.com</owner>
  <component>UI&gt;Browser&gt;Bookmarks</component>
  <summary>
    Size of the bookmarks file, recorded when the bookmarks model is loaded.
  </summary>
</histogram>

<histogram name="Bookmarks.Storage.FileSizeAtStartup2" units="KB"
    expires_after="2024-03-24">
  <owner>wylieb@chromium.org</owner>
  <owner>chrome-collections@google.com</owner>
  <component>UI&gt;Browser&gt;Bookmarks</component>
  <summary>
    Size of the bookmarks file, recorded when the bookmarks model is loaded.

    Opening a guest session (guest profile) also causes an emit to this
    histogram even though guest sessions don't typically allow bookmarks. (The
    value emitted is typically zero.) Under certain enterpise configuration,
    guest sessions can have bookmarks.
  </summary>
</histogram>

<histogram name="Bookmarks.Storage.TimeSinceLastScheduledSave" units="ms"
    expires_after="2024-03-24">
  <owner>wylieb@chromium.org</owner>
  <owner>chrome-collections@google.com</owner>
  <component>UI&gt;Browser&gt;Bookmarks</component>
  <summary>
    Time delta between bookmark file saves, recorded when a save occurs.
    Recorded on the first save as the time since startup.
  </summary>
</histogram>

<histogram name="Bookmarks.Storage.TimeToLoadAtStartup" units="ms"
    expires_after="2024-01-20">
  <obsolete>
    Logged on profile open, including for profiles that do not support
    bookmarks. (We did not investigate thoroughly; we don't know what value
    typically was logged. Presumably something small.) Replaced in M-107 with
    Bookmarks.Storage.TimeToLoadAtStartup2, which is similar but only emitted on
    profiles that may support bookmarks.
  </obsolete>
  <owner>wylieb@chromium.org</owner>
  <owner>chrome-collections@google.com</owner>
  <component>UI&gt;Browser&gt;Bookmarks</component>
  <summary>
    Duration of loading the bookmarks file, recorded when the bookmark model is
    loaded.
  </summary>
</histogram>

<histogram name="Bookmarks.Storage.TimeToLoadAtStartup2{StorageState}"
    units="ms" expires_after="2024-03-24">
  <owner>wylieb@chromium.org</owner>
  <owner>chrome-collections@google.com</owner>
  <component>UI&gt;Browser&gt;Bookmarks</component>
  <summary>
    Duration of loading the bookmarks file, recorded when the bookmark model is
    loaded {StorageState}.

    Opening a guest session (guest profile) also causes an emit to this
    histogram even though guest sessions don't typically allow bookmarks. (The
    value emitted is typically zero.) Under certain enterpise configuration,
    guest sessions can have bookmarks.
  </summary>
  <token key="StorageState">
    <variant name="" summary="irrespective of storage state"/>
    <variant name=".AccountStorage" summary="with account storage"/>
    <variant name=".LocalStorage" summary="with local storage not syncing"/>
    <variant name=".LocalStorageSyncing" summary="with local storage syncing"/>
  </token>
</histogram>

<histogram name="Bookmarks.Times.OnProfileLoad.MostRecentlyAddedFolderInDays"
    units="days" expires_after="2024-01-20">
  <owner>wylieb@chromium.org</owner>
  <owner>chrome-collections@google.com</owner>
  <component>UI&gt;Browser&gt;Bookmarks</component>
  <summary>
    Records how long ago (in days) the most recently added folder was added.
    Only emitted if the user has a folder with at least one child. Days are
    computed by comparing the current time to the added time for the folder,
    this value is truncated (std::trunc behavior). Only emitted if there's a
    valid value which replaces the default SIZE_MAX value. The default SIZE_MAX
    won't overlap with values coming from real bookmarks.

    Since bookmarks are synced, this histogram is emitted to regardless of the
    platform the bookmark originated from.

    Opening a guest session (guest profile) also causes an emit to this
    histogram under certain enterpise configurations where guest sessions can
    have bookmarks.
  </summary>
</histogram>

<histogram name="Bookmarks.Times.OnProfileLoad.MostRecentlySavedBookmarkInDays"
    units="days" expires_after="2024-03-24">
  <owner>wylieb@chromium.org</owner>
  <owner>chrome-collections@google.com</owner>
  <component>UI&gt;Browser&gt;Bookmarks</component>
  <summary>
    Records how long ago (in days) the most recently saved bookmark was saved.
    Only emitted if the user has a bookmark. Days are computed by comparing the
    current time to the added time for the bookmark, this value is truncated
    (std::trunc behavior). Only emitted if there's a valid value which replaces
    the default SIZE_MAX value. The default SIZE_MAX won't overlap with values
    coming from real bookmarks.

    Since bookmarks are synced, this histogram is emitted to regardless of the
    platform the bookmark originated from.

    Opening a guest session (guest profile) also causes an emit to this
    histogram under certain enterpise configurations where guest sessions can
    have bookmarks.
  </summary>
</histogram>

<histogram name="Bookmarks.Times.OnProfileLoad.MostRecentlyUsedBookmarkInDays"
    units="days" expires_after="2024-03-24">
  <owner>wylieb@chromium.org</owner>
  <owner>chrome-collections@google.com</owner>
  <component>UI&gt;Browser&gt;Bookmarks</component>
  <summary>
    Records how long ago (in days) the most recently saved bookmark was used.
    Only emitted if the user has a bookmark which has been opened. Days are
    computed by comparing the current time to the used time for the bookmark,
    this value is truncated (std::trunc behavior). Only emitted if there's a
    valid value which replaces the default SIZE_MAX value. The default SIZE_MAX
    won't overlap with values coming from real bookmarks.

    Since bookmarks are synced, this histogram is emitted to regardless of the
    platform the bookmark originated from.

    Opening a guest session (guest profile) also causes an emit to this
    histogram under certain enterpise configurations where guest sessions can
    have bookmarks.
  </summary>
</histogram>

<histogram name="Bookmarks.Times.OnProfileLoad.TimeSinceAdded" units="days"
    expires_after="2024-01-20">
  <obsolete>
    Logged on profile open, including for profiles that do not support
    bookmarks. (We did not investigate thoroughly; we don't know what value
    typically was logged. Presumably 0.) Replaced in M-107 with
    Bookmarks.Times.OnProfileLoad.TimeSinceAdded3, which is similar but only
    emitted on profiles that may support bookmarks.
  </obsolete>
  <owner>wylieb@chromium.org</owner>
  <owner>chrome-collections@google.com</owner>
  <component>UI&gt;Browser&gt;Bookmarks</component>
  <summary>
    Records the average number of days since each bookmark was added. Recorded
    on profile load.
  </summary>
</histogram>

<histogram name="Bookmarks.Times.OnProfileLoad.TimeSinceAdded3" units="days"
    expires_after="2024-03-24">
  <owner>wylieb@chromium.org</owner>
  <owner>chrome-collections@google.com</owner>
  <component>UI&gt;Browser&gt;Bookmarks</component>
  <summary>
    Records the average number of days since each bookmark was added. Recorded
    on profile load. Records zero for profiles with no bookmarks.

    Opening a guest session (guest profile) also causes an emit to this
    histogram even though guest sessions don't typically allow bookmarks. (The
    value emitted is typically zero.) Under certain enterpise configuration,
    guest sessions can have bookmarks.
  </summary>
</histogram>

<histogram name="Bookmarks.UsageCountPerProfileType" enum="BrowserProfileType"
    expires_after="2024-03-24">
  <owner>rhalavati@chromium.org</owner>
  <owner>chrome-privacy-core@google.com</owner>
  <component>UI&gt;Browser&gt;Bookmarks</component>
  <summary>
    The number of times bookmarks are used in each profile type. Recorded when a
    bookmark is clicked.
  </summary>
</histogram>

<histogram name="Bookmarks.Utilization.OnProfileLoad.PercentageUsed"
    units="Percentage (0-100)" expires_after="2024-03-24">
  <owner>wylieb@chromium.org</owner>
  <owner>chrome-collections@google.com</owner>
  <component>UI&gt;Browser&gt;Bookmarks</component>
  <summary>
    The percentage of bookmarks which have been used expressed as 0-100.
    Recorded on profile load.
  </summary>
</histogram>

<histogram name="Bookmarks.Utilization.OnProfileLoad.TotalUnused"
    units="Bookmarks" expires_after="2024-03-24">
  <owner>wylieb@chromium.org</owner>
  <owner>chrome-collections@google.com</owner>
  <component>UI&gt;Browser&gt;Bookmarks</component>
  <summary>
    The total number of bookmarks that haven't been opened. Recorded on profile
    load.
  </summary>
</histogram>

<histogram name="Bookmarks.Utilization.OnProfileLoad.TotalUsed"
    units="Bookmarks" expires_after="2024-03-24">
  <owner>wylieb@chromium.org</owner>
  <owner>chrome-collections@google.com</owner>
  <component>UI&gt;Browser&gt;Bookmarks</component>
  <summary>
    The total number of bookmarks that have been opened. Recorded on profile
    load.
  </summary>
</histogram>

<histogram name="Bookmarks.UtilizationPerBookmark.OnProfileLoad.DaysSinceUsed"
    units="Days" expires_after="2024-03-24">
  <owner>emshack@chromium.org</owner>
  <owner>chrome-collections@google.com</owner>
  <component>UI&gt;Browser&gt;Bookmarks</component>
  <summary>
    For each bookmark, the number of days since the bookmark was last used.
    Recorded on profile load.
  </summary>
</histogram>

<histogram name="PowerBookmarks.BookmarkManager.PriceTrackingEnabled"
    enum="PriceTrackingState" expires_after="2024-01-20">
  <owner>wylieb@chromium.org</owner>
  <owner>chrome-collections@google.com</owner>
  <summary>
    Tracks the interactions with the price-tracking toggle present when viewing
    previously saved products.
  </summary>
</histogram>

<histogram name="PowerBookmarks.BookmarkSaveFlow.PriceTrackingEnabled"
    enum="PriceTrackingState" expires_after="2024-01-20">
  <owner>wylieb@chromium.org</owner>
  <owner>chrome-collections@google.com</owner>
  <summary>
    Tracks the interactions with the price-tracking toggle present when
    initially saving products.
  </summary>
</histogram>

<histogram name="PowerBookmarks.SidePanel.Search.CTR"
    enum="BookmarksSidePanelSearchCTREvent" expires_after="2024-01-28">
  <owner>emshack@chromium.org</owner>
  <owner>chrome-desktop-sea@google.com</owner>
  <component>UI&gt;Browser&gt;PowerBookmarks</component>
  <summary>
    Logs when the power bookmarks side panel is shown, as well as when the
    search bar is defocused as a proxy for performing a search. The CTR can be
    calculated by computing &quot;Searched&quot; / &quot;Shown&quot;.
  </summary>
</histogram>

<histogram name="PowerBookmarks.SidePanel.SortTypeShown"
    enum="BookmarksSidePanelSortType" expires_after="2024-01-28">
  <owner>emshack@chromium.org</owner>
  <owner>chrome-desktop-sea@google.com</owner>
  <component>UI&gt;Browser&gt;PowerBookmarks</component>
  <summary>
    Records the sort type when the side panel is shown or when the sort type
    changes.
  </summary>
</histogram>

<histogram name="PowerBookmarks.SidePanel.ViewTypeShown"
    enum="BookmarksSidePanelViewType" expires_after="2024-01-28">
  <owner>emshack@chromium.org</owner>
  <owner>chrome-desktop-sea@google.com</owner>
  <component>UI&gt;Browser&gt;PowerBookmarks</component>
  <summary>
    Records the view type when the side panel is shown or when the view type
    changes.
  </summary>
</histogram>

<histogram name="PowerBookmarks.Storage.DatabaseDirSizeAtStartup" units="KB"
    expires_after="2024-01-20">
  <owner>wylieb@chromium.org</owner>
  <owner>chrome-collections@google.com</owner>
  <summary>
    Size of the power bookmarks database directory, recorded when the database
    is loaded.
  </summary>
</histogram>

<histogram name="PowerBookmarks.Storage.DatabaseError" enum="SqliteErrorCode"
    expires_after="2024-01-20">
  <owner>wylieb@chromium.org</owner>
  <owner>chrome-collections@google.com</owner>
  <summary>
    Errors that occur in Power Bookmarks database. Recorded by
    SharedStorageDatabase::DatabaseErrorCallback() just before the SQLite
    database determines whether the error is catastrophic and handles it
    accordingly.
  </summary>
</histogram>

<histogram name="PowerBookmarks.{Function}.PowerType" enum="PowerBookmarkType"
    expires_after="2024-01-20">
  <owner>wylieb@chromium.org</owner>
  <owner>chrome-collections@google.com</owner>
  <summary>
    Tracks the PowerType of a successful power bookmark api call.
  </summary>
  <token key="Function">
    <variant name="PowerCreated"/>
    <variant name="PowersDeletedForURL"/>
    <variant name="PowerUpdated"/>
  </token>
</histogram>

<histogram name="PowerBookmarks.{Function}.Success" enum="BooleanSuccess"
    expires_after="2024-01-20">
  <owner>wylieb@chromium.org</owner>
  <owner>chrome-collections@google.com</owner>
  <summary>Tracks the success of a power bookmark api call.</summary>
  <token key="Function">
    <variant name="PowerCreated"/>
    <variant name="PowerDeleted"/>
    <variant name="PowersDeletedForURL"/>
    <variant name="PowerUpdated"/>
  </token>
</histogram>

</histograms>

</histogram-configuration>
