<!--
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 Image 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>

<variants name="ImageAnnotationServiceAnnotationType">
  <variant name="DescCaption"
      summary="Caption annotations from the description engine"/>
  <variant name="DescLabel"
      summary="Label annotations from the description engine"/>
  <variant name="DescOcr"
      summary="OCR (text extraction) annotations from the description engine"/>
  <variant name="DescUnknown"
      summary="Annotations of an unknown type from the description engine"/>
  <variant name="Ocr"
      summary="OCR (text extraction) annotations from the specialized OCR
               engine"/>
</variants>

<variants name="ImageFetcherCacheStrategy">
  <variant name=".BestEffort" summary="LRU cache strategy."/>
  <variant name=".HoldUntilExpired"
      summary="Hold the cache file until expired."/>
</variants>

<variants name="ImageFetcherClients">
  <variant name=".AlmanacIcons"
      summary="Downloads app icons for clients of the Almanac Server to
               display."/>
  <variant name=".AnswerSuggestions"
      summary="Showing cache patterns only for AnswerSuggestions (valid until
               M117)."/>
  <variant name=".AssistantDetails"
      summary="Showing cache patterns only for AssistantDetails."/>
  <variant name=".AutofillCardArt"
      summary="Show customized card-art image for credit card suggestions on
               Android (Used up to M137, will log as 'AutofillImageFetcher'
               from M138)."/>
  <variant name=".AutofillImageFetcher"
      summary="Downloads various Autofill related images."/>
  <variant name=".AutofillPasswordFavicon"
      summary="Requesting favicons associated with credentials directly from
               websites."/>
  <variant name=".ContextualSuggestions"
      summary="Showing cache patterns only for ContextualSuggestions."/>
  <variant name=".Cryptids" summary="Asset fetcher for cryptid rendering."/>
  <variant name=".DataSharing"
      summary="Avatar image fetcher for data sharing flows."/>
  <variant name=".DataSharingAvatarImageFetcher"
      summary="Downloads people profile images to show on Chrome UI."/>
  <variant name=".EduAccountLoginProfileImageFetcher"
      summary="Profile image fetcher for EDU account login flow"/>
  <variant name=".EntitySuggestions"
      summary="Showing cache patterns only for EntitySuggestions (valid until
               M117)."/>
  <variant name=".FedCMAccountChooser"
      summary="Profile image fetcher for FedCM Account chooser."/>
  <variant name=".Feed" summary="Showing cache patterns only for Feed."/>
  <variant name=".HomeCustomization"
      summary="Background image fetcher for the Home Customization feature on
               iOS."/>
  <variant name=".Internal"
      summary="Showing cache patterns only for Internal."/>
  <variant name=".NewTabPageAnimatedLogo"
      summary="Showing cache patterns only for NewTabPageAnimatedLogo."/>
  <variant name=".NtpBackground"
      summary="Background image fetcher for the New Tab Page on iOS."/>
  <variant name=".OfflinePages"
      summary="Showing cache patterns only for OfflinePages."/>
  <variant name=".Omnibox"
      summary="Showing cache patterns only for Omnibox (valid since M117)."/>
  <variant name=".PasswordBottomSheet"
      summary="Profile image fetcher for Password Manager sign-in bottom
               sheet."/>
  <variant name=".PasswordSharing"
      summary="Profile image fetcher of potential password recipients in the
               Password Sharing flow."/>
  <variant name=".PriceChangeModule"
      summary="Images fetched and used to render price change module on NTP
               or StartSurface."/>
  <variant name=".PriceDropNotification"
      summary="Images fetched for the icon of price drop notification."/>
  <variant name=".QueryTiles" summary="Showing Query tiles images."/>
  <variant name=".SharePreview" summary="Images fetched for Share previews."/>
  <variant name=".TabResumptionModule"
      summary="Images fetched and used to render tab resumption module on NTP
               or StartSurface."/>
  <variant name=".VideoTutorialsIPH"
      summary="Showing thumbnails for video tutorials IPH."/>
  <variant name=".VideoTutorialsList"
      summary="Showing thumbnails for video tutorials list view."/>
  <variant name=".WebNotes"
      summary="Images fetched and used to render Web Notes templates."/>
</variants>

<histogram name="ImageAnnotationService.AccessibilityV1.CacheHit"
    enum="BooleanCacheHit" expires_after="2026-12-20">
  <owner>dtseng@chromium.org</owner>
  <owner>amoylan@chromium.org</owner>
  <owner>mschillaci@google.com</owner>
  <owner>chrome-a11y-core@google.com</owner>
  <summary>
    For each image processed by the image annotation service, records whether or
    not results for the image already existed in the client-side cache. A hit
    means that image data was not transmitted to the image annotation server.

    Warning: This histogram was expired from 2022-04-24 to 2023-06-23; data may
    be missing. Use data from M117+ only.
  </summary>
</histogram>

<histogram name="ImageAnnotationService.AccessibilityV1.ClientResult"
    enum="ImageAnnotationServiceClientResult" expires_after="2027-02-07">
  <owner>dtseng@chromium.org</owner>
  <owner>amoylan@chromium.org</owner>
  <owner>mschillaci@google.com</owner>
  <owner>chrome-a11y-core@google.com</owner>
  <summary>
    For each request made by a client feature to the image annotation service,
    reports the final status of the service response.

    Warning: This histogram was expired from 2022-10-30 to 2023-06-23; data may
    be missing. Use data from M117+ only.
  </summary>
</histogram>

<histogram name="ImageAnnotationService.AccessibilityV1.DescFailure"
    enum="DescFailureReason" expires_after="2027-03-01">
  <owner>dtseng@chromium.org</owner>
  <owner>amoylan@chromium.org</owner>
  <owner>mschillaci@google.com</owner>
  <owner>chrome-a11y-core@google.com</owner>
  <summary>
    For each failed request made by a client feature to the image annotation
    service, reports the reason for the failure.
  </summary>
</histogram>

<histogram name="ImageAnnotationService.AccessibilityV1.DescType"
    enum="ImageAnnotationServiceDescType" expires_after="2027-03-01">
  <owner>dtseng@chromium.org</owner>
  <owner>amoylan@chromium.org</owner>
  <owner>mschillaci@google.com</owner>
  <owner>chrome-a11y-core@google.com</owner>
  <summary>
    For each annotation backend run by the image annotation server, records the
    gRPC status reported.

    Warning: This histogram was expired from 2022-04-24 to 2023-06-23; data may
    be missing. Use data from M117+ only.
  </summary>
</histogram>

<histogram name="ImageAnnotationService.AccessibilityV1.EncodedJpegSizeKB"
    units="KB" expires_after="2027-03-01">
  <owner>dtseng@chromium.org</owner>
  <owner>amoylan@chromium.org</owner>
  <owner>mschillaci@google.com</owner>
  <owner>chrome-a11y-core@google.com</owner>
  <summary>
    For each image sent from a client feature to the image annotation service,
    reports the image's final size (in kilobytes) after resizing and reencoding.

    Warning: This histogram was expired from 2022-04-24 to 2023-06-23; data may
    be missing. Use data from M117+ only.
  </summary>
</histogram>

<histogram name="ImageAnnotationService.AccessibilityV1.EngineKnown"
    enum="BooleanKnown" expires_after="2027-06-20">
  <owner>dtseng@chromium.org</owner>
  <owner>amoylan@chromium.org</owner>
  <owner>mschillaci@google.com</owner>
  <owner>chrome-a11y-core@google.com</owner>
  <summary>
    For each annotation backend run by the image annotation server, records
    whether or not the backend is recognised by this version of Chrome.

    Warning: This histogram was expired from 2022-04-24 to 2023-06-23; data may
    be missing. Use data from M117+ only.
  </summary>
</histogram>

<histogram
    name="ImageAnnotationService.AccessibilityV1.ImageRequestIncludesDesc"
    enum="BooleanIncluded" expires_after="2027-06-20">
  <owner>dtseng@chromium.org</owner>
  <owner>amoylan@chromium.org</owner>
  <owner>mschillaci@google.com</owner>
  <owner>chrome-a11y-core@google.com</owner>
  <summary>
    For each image request sent to the image annotation server, records whether
    or not the description backend is included among the requested backends.

    The description backend will not be included when the image is known to
    violate the description model policy (i.e. be too small or have too-high an
    aspect ratio).

    Warning: This histogram was expired from M105 to M117; data may be missing.
    Use data from M117+ only.
  </summary>
</histogram>

<histogram
    name="ImageAnnotationService.AccessibilityV1.ImageRequestIncludesIcon"
    enum="BooleanIncluded" expires_after="2027-06-20">
  <owner>dtseng@chromium.org</owner>
  <owner>amoylan@chromium.org</owner>
  <owner>mschillaci@google.com</owner>
  <owner>chrome-a11y-core@google.com</owner>
  <summary>
    For each image request sent to the image annotation server, records whether
    or not the icon backend is included among the requested backends.

    The icon backend will not be included when the image is known to violate the
    icon model policy (i.e. be too large or have too-high an aspect ratio).

    Warning: This histogram was expired from M105 to M117; data may be missing.
    Use data from M117+ only.
  </summary>
</histogram>

<histogram name="ImageAnnotationService.AccessibilityV1.JsonParseSuccess"
    enum="BooleanSuccess" expires_after="2027-06-20">
  <owner>dtseng@chromium.org</owner>
  <owner>amoylan@chromium.org</owner>
  <owner>mschillaci@google.com</owner>
  <owner>chrome-a11y-core@google.com</owner>
  <summary>
    For each non-empty response sent from the image annotation server, records
    whether or not JSON data were successfully parsed from the response body.

    Warning: This histogram was expired from 2022-10-31 to 2023-06-23; data may
    be missing. Use data from M117+ only.
  </summary>
</histogram>

<histogram name="ImageAnnotationService.AccessibilityV1.PixelFetchSuccess"
    enum="BooleanSuccess" expires_after="2027-06-20">
  <owner>dtseng@chromium.org</owner>
  <owner>amoylan@chromium.org</owner>
  <owner>mschillaci@google.com</owner>
  <owner>chrome-a11y-core@google.com</owner>
  <summary>
    For each pixel fetch request sent from the image annotation service to a
    client feature, records whether or not encoded pixel data were successfully
    returned to the service.

    Warning: This histogram was expired from 2022-04-24 to 2023-06-23; data may
    be missing. Use data from M117+ only.
  </summary>
</histogram>

<histogram name="ImageAnnotationService.AccessibilityV1.ServerHttpResponseCode"
    enum="HttpResponseCode" expires_after="2027-02-07">
  <owner>dtseng@chromium.org</owner>
  <owner>amoylan@chromium.org</owner>
  <owner>mschillaci@google.com</owner>
  <owner>chrome-a11y-core@google.com</owner>
  <summary>
    For each HTTP response from the image annotation server, reports the
    associated HTTP code.

    Warning: This histogram was expired from 2022-04-24 to 2023-06-23; data may
    be missing. Use data from M117+ only.
  </summary>
</histogram>

<histogram name="ImageAnnotationService.AccessibilityV1.ServerLatencyMs"
    units="ms" expires_after="2027-06-20">
  <owner>dtseng@chromium.org</owner>
  <owner>amoylan@chromium.org</owner>
  <owner>mschillaci@google.com</owner>
  <owner>chrome-a11y-core@google.com</owner>
  <summary>
    For each HTTP response from the image annotation server, reports the time
    elapsed (in milliseconds) since the corresponding request was sent.

    Warning: This histogram was expired from 2022-04-24 to 2023-06-23; data may
    be missing. Use data from M117+ only.
  </summary>
</histogram>

<histogram name="ImageAnnotationService.AccessibilityV1.ServerNetError"
    enum="NetErrorCodes" expires_after="2027-06-20">
  <owner>dtseng@chromium.org</owner>
  <owner>amoylan@chromium.org</owner>
  <owner>mschillaci@google.com</owner>
  <owner>chrome-a11y-core@google.com</owner>
  <summary>
    For each HTTP request sent to the image annotation server, reports the net
    error (or OK status) of the request.

    Warning: This histogram was expired from 2022-04-24 to 2023-06-23; data may
    be missing. Use data from M117+ only.
  </summary>
</histogram>

<histogram name="ImageAnnotationService.AccessibilityV1.ServerRequestSizeKB"
    units="KB" expires_after="2026-11-01">
  <owner>dtseng@chromium.org</owner>
  <owner>amoylan@chromium.org</owner>
  <owner>mschillaci@google.com</owner>
  <owner>chrome-a11y-core@google.com</owner>
  <summary>
    For each HTTP request sent to the image annotation server, reports the size
    of the request. Measured in kilobytes, since a request can contain the pixel
    data of multiple images.

    Warning: This histogram was expired from 2022-04-24 to 2023-06-23; data may
    be missing. Use data from M117+ only.
  </summary>
</histogram>

<histogram
    name="ImageAnnotationService.AccessibilityV1.ServerResponseSizeBytes"
    units="bytes" expires_after="2027-06-20">
  <owner>dtseng@chromium.org</owner>
  <owner>amoylan@chromium.org</owner>
  <owner>mschillaci@google.com</owner>
  <owner>chrome-a11y-core@google.com</owner>
  <summary>
    For each HTTP response from the image annotation server, reports the
    response size in bytes.

    Warning: This histogram was expired from 2022-04-24 to 2023-06-23; data may
    be missing. Use data from M117+ only.
  </summary>
</histogram>

<histogram name="ImageAnnotationService.AccessibilityV1.SourcePixelCount"
    units="pixels" expires_after="2027-06-20">
  <owner>dtseng@chromium.org</owner>
  <owner>amoylan@chromium.org</owner>
  <owner>mschillaci@google.com</owner>
  <owner>chrome-a11y-core@google.com</owner>
  <summary>
    For each image sent from a client feature to the image annotation service,
    reports the image's original (i.e. pre-scaling) area in pixels. Images with
    pixel count above a certain threshold will be resized prior to transmission.

    Warning: This histogram was expired from 2022-04-24 to 2023-06-23; data may
    be missing. Use data from M117+ only.
  </summary>
</histogram>

<histogram
    name="ImageAnnotationService.{ImageAnnotationServiceAnnotationType}.AccessibilityV1.Confidence"
    units="%" expires_after="2027-06-20">
  <owner>dtseng@chromium.org</owner>
  <owner>amoylan@chromium.org</owner>
  <owner>mschillaci@google.com</owner>
  <owner>chrome-a11y-core@google.com</owner>
  <summary>
    For each annotation of the given type returned by the image annotation
    server, records the confidence (as a percentage) produced by the ML model
    for the annotation. {ImageAnnotationServiceAnnotationType}

    This metric was recorded with a wrong name before M151.
  </summary>
  <token key="ImageAnnotationServiceAnnotationType"
      variants="ImageAnnotationServiceAnnotationType"/>
</histogram>

<histogram
    name="ImageAnnotationService.{ImageAnnotationServiceAnnotationType}.AccessibilityV1.Empty"
    enum="BooleanEmpty" expires_after="2027-06-20">
  <owner>dtseng@chromium.org</owner>
  <owner>amoylan@chromium.org</owner>
  <owner>mschillaci@google.com</owner>
  <owner>chrome-a11y-core@google.com</owner>
  <summary>
    For each annotation of the given type returned by the image annotation
    server, records whether or not the text of the annotation was empty. This is
    sometimes valid, e.g. for text extraction (OCR) on an image that does not
    contain any text. {ImageAnnotationServiceAnnotationType}

    This metric was recorded with a broken name before M151.
  </summary>
  <token key="ImageAnnotationServiceAnnotationType"
      variants="ImageAnnotationServiceAnnotationType"/>
</histogram>

<histogram
    name="ImageAnnotationService.{ImageAnnotationServiceAnnotationType}.AccessibilityV1.Status"
    enum="GoogleRpcCode" expires_after="2027-06-20">
  <owner>dtseng@chromium.org</owner>
  <owner>amoylan@chromium.org</owner>
  <owner>mschillaci@google.com</owner>
  <owner>chrome-a11y-core@google.com</owner>
  <summary>
    For each annotation backend run by the image annotation server, records the
    gRPC status reported. {ImageAnnotationServiceAnnotationType}

    This metric was recorded with a broken name before M151.
  </summary>
  <token key="ImageAnnotationServiceAnnotationType"
      variants="ImageAnnotationServiceAnnotationType"/>
</histogram>

<histogram name="ImageFetcher.CacheMetadataCount{ImageFetcherCacheStrategy}"
    units="records" expires_after="2027-03-10">
  <owner>wylieb@google.com</owner>
  <owner>skym@chromium.org</owner>
  <summary>
    The total number of metadata entries in the image fetcher cache metadata
    database for a given cache strategy. Recorded during cache eviction process.
    {ImageFetcherCacheStrategy}
  </summary>
  <token key="ImageFetcherCacheStrategy" variants="ImageFetcherCacheStrategy"/>
</histogram>

<histogram name="ImageFetcher.CacheSize{ImageFetcherCacheStrategy}" units="KB"
    expires_after="2027-02-07">
  <owner>wylieb@google.com</owner>
  <owner>skym@chromium.org</owner>
  <summary>
    The total size of the cache for a given cache strategy. Recorded during
    cache eviction process. {ImageFetcherCacheStrategy}
  </summary>
  <token key="ImageFetcherCacheStrategy" variants="ImageFetcherCacheStrategy"/>
</histogram>

<histogram name="ImageFetcher.Events{ImageFetcherClients}"
    enum="ImageFetcherEvent" expires_after="2027-02-07">
  <owner>wylieb@google.com</owner>
  <owner>skym@chromium.org</owner>
  <summary>
    Events that track the lifecycle and performance of the cached_image_fetcher.
    The events reported include: success/failure conditions, various recoverable
    errors and a couple of dead-end errors. {ImageFetcherClients}
  </summary>
  <token key="ImageFetcherClients" variants="ImageFetcherClients">
    <variant name=""/>
  </token>
</histogram>

<histogram name="ImageFetcher.ImageLoadFromCacheTimeJava{ImageFetcherClients}"
    units="ms" expires_after="2027-03-10">
  <owner>wylieb@google.com</owner>
  <owner>skym@chromium.org</owner>
  <summary>
    The time it takes for cached_image_fetcher to load an image from the cache
    in Java. {ImageFetcherClients}
  </summary>
  <token key="ImageFetcherClients" variants="ImageFetcherClients">
    <variant name=""/>
  </token>
</histogram>

<histogram name="ImageFetcher.ImageLoadFromCacheTime{ImageFetcherClients}"
    units="ms" expires_after="2027-03-10">
  <owner>wylieb@google.com</owner>
  <owner>skym@chromium.org</owner>
  <summary>
    The time it takes for cached_image_fetcher to load an image from the cache
    in native. {ImageFetcherClients}
  </summary>
  <token key="ImageFetcherClients" variants="ImageFetcherClients">
    <variant name=""/>
  </token>
</histogram>

<histogram name="ImageFetcher.ImageLoadFromNativeTimeJava{ImageFetcherClients}"
    units="ms" expires_after="2027-03-10">
  <owner>wylieb@google.com</owner>
  <owner>skym@chromium.org</owner>
  <summary>
    The time it takes for cached_image_fetcher to load an image from native
    code. Only recorded on successful loads. {ImageFetcherClients}
  </summary>
  <token key="ImageFetcherClients" variants="ImageFetcherClients">
    <variant name=""/>
  </token>
</histogram>

<histogram
    name="ImageFetcher.ImageLoadFromNetworkAfterCacheHit{ImageFetcherClients}"
    units="ms" expires_after="2027-09-13">
  <owner>wylieb@google.com</owner>
  <owner>skym@chromium.org</owner>
  <summary>
    The time it takes for cached_image_fetcher to load an image from the network
    after a cache hit. {ImageFetcherClients}
  </summary>
  <token key="ImageFetcherClients" variants="ImageFetcherClients">
    <variant name=""/>
  </token>
</histogram>

<histogram name="ImageFetcher.ImageLoadFromNetworkTime{ImageFetcherClients}"
    units="ms" expires_after="2027-09-13">
  <owner>wylieb@google.com</owner>
  <owner>skym@chromium.org</owner>
  <summary>
    The time it takes for cached_image_fetcher to load an image from the
    network. {ImageFetcherClients}
  </summary>
  <token key="ImageFetcherClients" variants="ImageFetcherClients">
    <variant name=""/>
  </token>
</histogram>

<histogram name="ImageFetcher.LoadImageMetadata" units="ms"
    expires_after="2027-03-10">
  <owner>wylieb@google.com</owner>
  <owner>skym@chromium.org</owner>
  <summary>
    The time it takes to load an image's metadata from the metadata store. Only
    recorded for cached image fetcher.
  </summary>
</histogram>

<histogram name="ImageFetcher.RequestStatusCode{ImageFetcherClients}"
    enum="CombinedHttpResponseAndNetErrorCode" expires_after="2027-02-07">
  <owner>wylieb@google.com</owner>
  <owner>skym@chromium.org</owner>
  <summary>
    Android: The integer status code of network requests made by the image data
    fetcher. This code includes both protocol(1xx-5xx) and non-protocol(-xxx)
    errors. Recorded when a request completes. {ImageFetcherClients}
  </summary>
  <token key="ImageFetcherClients" variants="ImageFetcherClients">
    <variant name=""/>
  </token>
</histogram>

<histogram name="ImageFetcher.TimeSinceLastCacheLRUEviction" units="ms"
    expires_after="2027-03-10">
  <owner>wylieb@google.com</owner>
  <owner>skym@chromium.org</owner>
  <summary>
    The time since the last LRU eviction from the image cache. Recorded when two
    LRU evictions occur within closure proximity to one another. Will be used to
    determine if LRU eviction is happening too frequently.
  </summary>
</histogram>

</histograms>

</histogram-configuration>
