bmgordon@google.com project-bolton@google.com Records the result of attempting to add a printer manually from the OS Settings Printers page. A failed result is recorded each time the user clicks the Add button and the attempt fails. bmgordon@chromium.org cros-printing-dev@chromium.org Records whether resolution of a .local address via mDNS was successful. The metric is recorded during attempted setup of a printer discovered via mDNS. pawliczek@chromium.org bmgordon@chromium.org project-bolton@google.com The success or error code for the automatic setup of a USB printer. The result is recorded only if all the following conditions are fulfilled: 1. The setup procedure was initiated automatically when a USB printer was physically connected to the device. 2. There is a matching PPD file that can be used to setup the printer. 3. The printer supports IPP over USB protocol. bmgordon@google.com cros-device-enablement@google.com Records one of the available DPI values from a printer's capabilities whenever the printer is selected in Print Preview. A separate record is emitted for every DPI value that the printer supports. The recorded value is a 32 bit combination of two DPI values which can be decoded as the higher order 16 bits representing the DPI width and the lower order 16 bits representing the DPI height. bmgordon@google.com cros-device-enablement@google.com Records the count of all DPI values from a printer's capabilities whenever the printer is selected in Print Preview. bmgordon@google.com cros-device-enablement@google.com Records the {Type} DPI value from a printer's capabilities whenever the printer is selected in Print Preview. The recorded value is a 32 bit combination of two DPI values which can be decoded as the higher order 16 bits representing the DPI width and the lower order 16 bits representing the DPI height. bmgordon@chromium.org cros-printing-dev@chromium.org Record if the request for IPP attributes was successful in reaching the printer. Recorded during the attempt to setup IPP/IPPS printers. bmgordon@chromium.org project-bolton@google.com Records the print job duration of a cancelled print job. Includes time spent in a suspended or error state. Only recorded on Chrome OS. bmgordon@chromium.org project-bolton@google.com Records the print job duration of a done/completed print job. Includes time spent in a suspended or error state. Only recorded on Chrome OS. bmgordon@chromium.org cros-printing-dev@chromium.org The final status of every print job that was succesfully queued. Only used on Chrome OS. Recorded upon the completion of each print job by the CupsPrintJobManager. pawliczek@chromium.org bmgordon@chromium.org project-bolton@google.com The final status of every print job that was succesfully queued for a USB printer that meets all of the following conditions: 1. The setup procedure of the printer was initiated automatically when the printer was physically connected to the device. 2. There is a matching PPD file that can be used to setup the printer. 3. The printer supports IPP over USB protocol. 4. The printer was setup in the first attempt. bmgordon@chromium.org project-bolton@google.com The number of detected network printers classified as Automatic, excluding Saved printers. Recorded when the user navigates to the OS Settings Printing page to set up printers. Only recorded on Chrome OS. bmgordon@chromium.org project-bolton@google.com The number of detected network printers classified as Discovered, excluding Saved printers. Recorded when the user navigates to the OS Settings Printing page to set up printers. Only recorded on Chrome OS. bmgordon@chromium.org project-bolton@google.com The number of detected network printers that have not been saved. Recorded when the user navigates to the OS Settings Printing page to set up printers. Only recorded on Chrome OS. bmgordon@chromium.org project-bolton@google.com Records the total size of the printed document (PDF) sent to CUPS. Only recorded on Chrome OS. bmgordon@chromium.org src/chromeos/printing/OWNERS The protocol for a printer that was added. Used to track printer churn by protocol. Only on Chrome OS. nmuggli@google.com project-bolton@google.com Tracks when the printer edit dialog is opened and certain user interactions. Every time the dialog is opened, the first bucket will get incremented. Additional buckets will get incremented for specific actions, such as clicking the View PPD button. Therefore, the first bucket acts as the total number of potential events and subsequest buckets track how many times specific events occurred. Only on Chrome OS. Note that this metric was not being recorded until middle of January 2024 (M122) despite initially landing in M109. bmgordon@chromium.org src/chromeos/printing/OWNERS The protocol for a printer that was removed. Used to track printer churn by protocol. Only on Chrome OS. bmgordon@chromium.org src/chromeos/printing/OWNERS The number of printers shown in the discovered printers dialog during printer set up. Only recorded on Chrome OS. bmgordon@chromium.org src/chromeos/printing/OWNERS The success or error code for the setup of a CUPS printer. Recorded when setup is attempted through the settings dialogs. Only recorded on Chrome OS. Printer setup results go into either this histogram or the Printing.CUPS.ZeroconfPrinterSetupResult histogram - not both. bmgordon@chromium.org cros-printing-dev@chromium.org The success or error code for the setup of a CUPS printer. Recorded when setup is attempted from the print preview dialog. Only recorded on Chrome OS. Printer setup results go into either this histogram or the Printing.CUPS.ZeroconfPrinterSetupResult.PrintPreview histogram - not both. gavinwill@google.com bmgordon@chromium.org src/chromeos/printing/OWNERS The success or error code for the setup of printers classified as "Discovered". Recorded when the user clicks the Setup button in OS Printer Settings when attempting to save a printer. Only recorded on Chrome OS. bmgordon@google.com cros-device-enablement@google.com Records the success outcome of a printer status query to a local printer. Note: Missing data from 2024-01-14 to 2024-07-29. gavinwill@google.com cros-device-enablement@google.com Records the status reasons returned by a local printer from a printer status query. Each returned printer status request can contain multiple status reasons so summing these buckets will overcount the total # of status queries. bmgordon@chromium.org cros-printing-dev@chromium.org Records the protocol for a selected printer in Chrome OS. Used to track usage of the various printer protocols. Since a selection occurs when print preview is opened, this will count at least one every time that happens if a CUPS printer was selected. gavinwill@google.com cros-device-enablement@google.com Records the number of saved printers when the user launches or refreshes the OS Settings Printing page. bmgordon@google.com cros-device-enablement@google.com Records the action a user takes on the OS Printer settings page. bmgordon@chromium.org project-bolton@google.com The total number of detected network printers. Recorded whenever the background running mDNS detector reports detected printers. The mDNS detector reports more often when printers are detected on the network, so the "0 printers" case might be underrepresented in this metric. Look to "Printing.CUPS.TotalNetworkPrintersCount2.SettingsOpened" for more accurate "0 printers" representation. Only recorded on Chrome OS. bmgordon@chromium.org project-bolton@google.com The total number of detected network printers. Recorded when the user navigates to the OS Settings Printing page to set up printers. Only recorded on Chrome OS. gavinwill@google.com cros-device-enablement@google.com Records the source from which a USB printer was configured in Chrome OS. Used to track relative usage of the various printer setup routes. Only emits after a successful printer setup. Warning: this histogram was expired from 2022-10-04 to M130; data may be missing. kdlee@chromium.org cros-printing-dev@chromium.org The success or error code for the setup of a Zeroconf printer. Recorded when setup is attempted through the settings dialogs. Only recorded on Chrome OS. Printer setup results go into either this histogram or the Printing.CUPS.PrinterSetupResult histogram - not both. bmgordon@chromium.org cros-printing-dev@chromium.org The success or error code for the setup of a Zeroconf printer. Recorded when setup is attempted from the print preview dialog. Only recorded on Chrome OS. Printer setup results go into either this histogram or the Printing.CUPS.PrinterSetupResult.PrintPreview histogram - not both. awscreen@chromium.org thestig@chromium.org Records the final result of a print job where the interactions with the system printing APIs are performed out-of-process in the PrintBackend service. This covers printing initiated from Print Preview as well as from a system print dialog for platforms which provide that. Recorded upon completion of each print job by PrintJobWorkerOop. awscreen@chromium.org thestig@chromium.org Records the time to successfully print a document to a local printer. All print job settings are determined before the start of the measurement. This time represents the period from when a print job is started until a document done completes successfully, after the document has been fully spooled to the platform for transmission to the printer. This includes the time for any required data format conversions, such as from PDF to another format like EMF, PostScript, or XPS. Specifically excluded from collection for this metric are Windows print jobs which use a printer driver that prompts the user with a "Save Print Output As" dialog, since such print jobs could be arbitrarily long waiting for data entry by users. gavinwill@google.com cros-device-enablement@google.com Recorded the time it takes for the Print Management UI to receive a response from a `getPrintJobs()` request. Recorded whenever print jobs are requested. pawliczek@chromium.org bmgordon@chromium.org Records the number of print servers that must be queried according to policies. Only non-zero values are recorded. The histogram is emitted when ExternalPrintServers* policies are loaded and processed. It happens when a profile is opened or when one of the policies is modified. awscreen@chromium.org thestig@chromium.org Time to acquire the list of local printers from the print backend, as needed by Print Preview. awscreen@chromium.org thestig@chromium.org Time to acquire the set of capabilities for a local printer from the print backend, as needed by Print Preview. awscreen@chromium.org thestig@chromium.org Time to acquire the name of the default printer from the print backend, as needed by Print Preview. Warning: this histogram was expired from 2025-03-14 to 2025-03-18; data may be missing. gavinwill@google.com cros-device-enablement@google.com The amount of time it takes to fetch {PrinterType} printers. Recorded whenever Print Preview is opened and {PrinterType} printers are requested. thestig@chromium.org dhoss@chromium.org Time from when print preview is initiated until the initial preview is sent to the preview tab for rendering. gavinwill@google.com cros-device-enablement@google.com Time from when print preview is initiated until the initial preview is sent to the preview tab for rendering with the minimum bucket set as 10 seconds to give better granularity for longer load times. thestig@chromium.org awscreen@chromium.org Time from when print preview is initiated until the initial preview is sent to the preview tab for rendering. Only captured for the very first print preview request since the browser started. This metric will not be captured if the user cancels out of the first print preview before the result is ready for rendering. gavinwill@google.com cros-device-enablement@google.com Time from when print preview is initiated until the initial preview is sent to the preview tab for rendering with the minimum bucket set as 10 seconds to give better granularity for longer load times. Only captured for the very first print preview request since the browser started. This metric will not be captured if the user cancels out of the first print preview before the result is ready for rendering. thestig@chromium.org dhoss@chromium.org Time from when print preview is initiated until the preview PDF generation is started. thestig@chromium.org dhoss@chromium.org Count the total number of printers shown in destination drop down list. gavinwill@google.com cros-device-enablement@google.com Tracks the outcome of a print journey on ChromeOS. This metric attempts to capture all expected outcomes when a user goes to print. Once Print Preview is opened, this metric gets recorded after one of the following: either Print Preview is canceled and closed, or the attempted print job completes. rbpotter@chromium.org awscreen@chromium.org Track type of documents printed (HTML vs PDF). Recorded immediately after a user requests that a document be printed. ashleydp@google.com gavinwill@google.com cros-device-enablement@google.com Tracks the source element that triggers navigation to Printer settings from Print Preview on ChromeOS. It attempts to capture the state of Print Preview when a user clicks the Printer settings button. Possible states include: preview-area displaying connection error on selected printer, destination-dialog-cros displaying destinations, and destination-dialog-cros displaying empty state. Note: Missing data from 2024-01-23 to 2024-07-29. gavinwill@google.com cros-device-enablement@google.com Tracks the success rate of a print job on ChromeOS while the {StatusReason} status is shown for the selected printer in Print Preview. The metric is recorded once the print job completes. thestig@chromium.org awscreen@chromium.org Track the popularity of print settings. (Settings when printing to PDF are excluded from this statistic.) rbpotter@chromium.org thestig@chromium.org Actions performed by the user interacting with print settings UI elements. thestig@chromium.org dhoss@chromium.org Time taken to render and generate PDF for print preview. (Includes time to reflow the page back to normal, but not the time to reflow the page to prepare for printing.) thestig@chromium.org dhoss@chromium.org Time taken to render and generate PDF for print preview divided by the number of pages. (Includes time to reflow the page back to normal, but not the time to reflow the page to prepare for printing.) thestig@chromium.org dhoss@chromium.org Count how frequently a set of pre-defined print preview errors occur. thestig@chromium.org awscreen@chromium.org Time taken to render to PDF for print preview. awscreen@chromium.org thestig@chromium.org Records the error that puts Print Preview into an error state. The NONE error state is not recorded. In an error state, the Print button is disabled. Warning: this histogram was expired from 2024-01-24 to 2024-06-10; data may be missing. gavinwill@google.com thestig@chromium.org Records `Success` when Print Preview transitions from the initial NOT_READY state to the READY state. Records `Failure` when Print Preview transitions from the initial NOT_READY state to the ERROR state. This metric only records for non-PDF destinations. Note: Missing data from 2024-01-23 to 2024-07-29. thestig@chromium.org awscreen@chromium.org Action taken by the user in the preview tab such as print, cancel, print to pdf and show advanced print settings dialog.