<!--
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
[email protected].
-->
<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."/>
<variant name=".AutofillImageFetcher"
summary="Show customized card art image for credit card."/>
<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=".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=".Internal"
summary="Showing cache patterns only for Internal."/>
<variant name=".NewTabPageAnimatedLogo"
summary="Showing cache patterns only for NewTabPageAnimatedLogo."/>
<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="2025-01-20">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</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="2025-01-20">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</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="2025-01-20">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</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="2025-01-20">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</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="2025-01-20">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</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="2025-01-20">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</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="2025-01-20">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</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="2025-01-20">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</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="2025-01-20">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</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="2025-01-20">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</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="2025-01-20">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</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="2025-01-20">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</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="2025-01-20">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</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="2025-01-20">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</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="2025-01-20">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</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="2025-01-20">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</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="2025-01-20">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</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}
Warning: This histogram was expired from 2022-04-24 to 2023-06-23; data may
be missing. Use data from M117+ only.
</summary>
<token key="ImageAnnotationServiceAnnotationType"
variants="ImageAnnotationServiceAnnotationType"/>
</histogram>
<histogram
name="ImageAnnotationService.{ImageAnnotationServiceAnnotationType}AccessibilityV1.Empty"
enum="BooleanEmpty" expires_after="2025-01-20">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</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}
Warning: This histogram was expired from 2022-04-24 to 2023-06-23; data may
be missing. Use data from M117+ only.
</summary>
<token key="ImageAnnotationServiceAnnotationType"
variants="ImageAnnotationServiceAnnotationType"/>
</histogram>
<histogram
name="ImageAnnotationService.{ImageAnnotationServiceAnnotationType}AccessibilityV1.Status"
enum="GoogleRpcCode" expires_after="2025-01-20">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
For each annotation backend run by the image annotation server, records the
gRPC status reported. {ImageAnnotationServiceAnnotationType}
Warning: This histogram was expired from 2022-04-24 to 2023-06-23; data may
be missing. Use data from M117+ only.
</summary>
<token key="ImageAnnotationServiceAnnotationType"
variants="ImageAnnotationServiceAnnotationType"/>
</histogram>
<histogram name="ImageDecoder.Png.UiGfxIntoSkBitmap" units="microseconds"
expires_after="2025-01-20">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Measures the runtime of the `gfx::PNGCodec::Decode(..., SkBitmap* bitmap)`
API. Logged every time the API is called. Primarily used to evaluate the
go/rusty-png-ui-gfx-decoder project.
The metric is reported for only clients with high-resolution clocks (i.e.
excludes a small percentage of Windows users population - see the
Windows.HasHighResolutionTimeTicks metric). This is okay, because we are
mostly interested in comparing C++ vs Rust and it seems okay to assume that
such comparison would give similar results for the filtered and non-filtered
population.
</summary>
</histogram>
<histogram name="ImageDecoder.Png.UiGfxIntoVector" units="microseconds"
expires_after="2025-01-20">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
Measures the runtime of the `gfx::PNGCodec::Decode(...,
std::vector<unsigned char>* output, ...)` API. Logged every time the
API is called. Primarily used to evaluate the go/rusty-png-ui-gfx-decoder
project.
The metric is reported for only clients with high-resolution clocks (i.e.
excludes a small percentage of Windows users population - see the
Windows.HasHighResolutionTimeTicks metric). This is okay, because we are
mostly interested in comparing C++ vs Rust and it seems okay to assume that
such comparison would give similar results for the filtered and non-filtered
population.
</summary>
</histogram>
<histogram name="ImageFetcher.CacheMetadataCount{ImageFetcherCacheStrategy}"
units="records" expires_after="2025-01-20">
<owner>[email protected]</owner>
<owner>[email protected]</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="2025-01-20">
<owner>[email protected]</owner>
<owner>[email protected]</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="2025-01-20">
<owner>[email protected]</owner>
<owner>[email protected]</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="2025-01-20">
<owner>[email protected]</owner>
<owner>[email protected]</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="2025-01-20">
<owner>[email protected]</owner>
<owner>[email protected]</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="2025-01-20">
<owner>[email protected]</owner>
<owner>[email protected]</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="2025-01-20">
<owner>[email protected]</owner>
<owner>[email protected]</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="2025-01-20">
<owner>[email protected]</owner>
<owner>[email protected]</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="2025-01-20">
<owner>[email protected]</owner>
<owner>[email protected]</owner>
<summary>
The time it takes to load an image's metadata from the metadata store.
</summary>
</histogram>
<histogram name="ImageFetcher.RequestStatusCode{ImageFetcherClients}"
enum="CombinedHttpResponseAndNetErrorCode" expires_after="2025-01-20">
<owner>[email protected]</owner>
<owner>[email protected]</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="2025-01-20">
<owner>[email protected]</owner>
<owner>[email protected]</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>
Codebase Browser
chromium