@@ -22,6 +22,15 @@ The following metrics are added to the ping:
| geckoview.page_load_time |[timing_distribution](https://mozilla.github.io/glean/book/user/metrics/timing_distribution.html) |The time taken to load a page. This includes all static contents, no dynamic content. Loading of about: pages is not counted. |[1](https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1)||never |
| geckoview.page_reload_time |[timing_distribution](https://mozilla.github.io/glean/book/user/metrics/timing_distribution.html) |Time taken to reload a page. This includes all static contents, no dynamic content. Loading of about: pages is not counted. |[1](https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10)||never |
| geckoview.startup_runtime |[timing_distribution](https://mozilla.github.io/glean/book/user/metrics/timing_distribution.html) |The time taken to initialize GeckoRuntime. |[1](https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1)||never |
| gfx.adapter.primary.description |[string](https://mozilla.github.io/glean/book/user/metrics/string.html) |Long form description of the Graphics adapter |[1](https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4)||never |
| gfx.checkerboard.duration |[timing_distribution](https://mozilla.github.io/glean/book/user/metrics/timing_distribution.html) |The duration of a checkerboard event. Checkerboarding is when painting has not kept up with asynchronous panning and zooming so the compositor has to display a "checkerboard pattern" (or in practice, the background color) rather than the actual page content. |[1](https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1)||never |
| gfx.checkerboard.peak_pixel_count |[custom_distribution](https://mozilla.github.io/glean/book/user/metrics/custom_distribution.html) |The peak number of CSS pixels that checkerboarded during a checkerboard event. The minimum value of the largest histogram bucket is the size of a 4k display with maximum APZ zooming. |[1](https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1)||never |
| gfx.checkerboard.potential_duration |[timing_distribution](https://mozilla.github.io/glean/book/user/metrics/timing_distribution.html) |The total amount of time that we could reasonably be checkerboarding. This is the union of two possibly-intersecting sets of time periods: The first set is that in which checkerboarding was actually happening, since by definition it could potentially be happening. The second set is that in which the APZC is actively transforming content in the compositor, since it could potentially transform it so as to display checkerboarding to the user. Combined with other information, this allows us to meaningfully say how frequently users actually enncounters checkerboarding. |[1](https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1)||never |
@@ -35,9 +44,14 @@ The following metrics are added to the ping:
| gfx.content.frame_time.without_upload |[custom_distribution](https://mozilla.github.io/glean/book/user/metrics/custom_distribution.html) |The time, in percentage of a vsync interval, spent from beginning a paint in the content process until that frame is presented in the compositor by webrender, excluding time spent uploading any content. |[1](https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1)||never |
| gfx.content.full_paint_time |[timing_distribution](https://mozilla.github.io/glean/book/user/metrics/timing_distribution.html) |Time spent in the full paint pipeline for content until it's ready for composition. For non-webrender this includes `paint_time`, plus rasterization if OMTP is enabled. For webrender, this includes `paint_time`, plus scene building time. |[1](https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1)||never |
| gfx.content.paint_time |[timing_distribution](https://mozilla.github.io/glean/book/user/metrics/timing_distribution.html) |Time spent in the main-thread paint pipeline for content. For non-webrender, this includes display list building, layer building, and when OMTP is disabled, rasterization. For webrender, this includes display list building, and webrender display list building. |[1](https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1)||never |
| gfx.webrender.framebuild_time |[timing_distribution](https://mozilla.github.io/glean/book/user/metrics/timing_distribution.html) |The time taken to build a webrender frame. This involves calculating the visibility of primitives, requesting resources, and building the render passes which will be used to render the frame. |[1](https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1)||never |
| gfx.display.count |[quantity](https://mozilla.github.io/glean/book/user/metrics/quantity.html) |Amount of displays connected to the device |[1](https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4)||never |
| gfx.display.primary_height |[quantity](https://mozilla.github.io/glean/book/user/metrics/quantity.html) |Height of the primary display, takes device rotation into account. |[1](https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4)||never |
| gfx.display.primary_width |[quantity](https://mozilla.github.io/glean/book/user/metrics/quantity.html) |Width of the primary display, takes device rotation into account. |[1](https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4)||never |
| gfx.status.compositor |[string](https://mozilla.github.io/glean/book/user/metrics/string.html) |Name of the graphics compositor in use. possible values are "opengl, d3d11, client, webrender or basic" |[1](https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4)||never |
| gfx.status.framebuild_time |[timing_distribution](https://mozilla.github.io/glean/book/user/metrics/timing_distribution.html) |The time taken to build a webrender frame. This involves calculating the visibility of primitives, requesting resources, and building the render passes which will be used to render the frame. |[1](https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1)||never |
| gfx.status.headless |[boolean](https://mozilla.github.io/glean/book/user/metrics/boolean.html) |Boolean indicated whether graphics is running in headless (no display) mode |[1](https://bugzilla.mozilla.org/show_bug.cgi?id=1594145#c4)||never |
| gfx.status.sceneswap_time |[timing_distribution](https://mozilla.github.io/glean/book/user/metrics/timing_distribution.html) |The time taken to do a webrender scene swap. This is book-keeping that APZ must perform once webrender has built a new scene. |[1](https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1)||never |
| gfx.webrender.scenebuild_time |[timing_distribution](https://mozilla.github.io/glean/book/user/metrics/timing_distribution.html) |The time taken to build a webrender scene. This occurs each time webrender receives a new display list. This additionally includes blob rasterization time. |[1](https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1)||never |
| gfx.webrender.sceneswap_time |[timing_distribution](https://mozilla.github.io/glean/book/user/metrics/timing_distribution.html) |The time taken to do a webrender scene swap. This is book-keeping that APZ must perform once webrender has built a new scene. |[1](https://bugzilla.mozilla.org/show_bug.cgi?id=1584109#c1)||never |
| network.cache_hit_time |[timing_distribution](https://mozilla.github.io/glean/book/user/metrics/timing_distribution.html) |Time to open existing cache entry file. |[1](https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10)||never |
| network.dns_end |[timing_distribution](https://mozilla.github.io/glean/book/user/metrics/timing_distribution.html) |In the HTTP page channel, time from the DNS request being issued to the response. |[1](https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10)||never |
| network.dns_start |[timing_distribution](https://mozilla.github.io/glean/book/user/metrics/timing_distribution.html) |In the HTTP page channel, time from connection open to the DNS request being issued. |[1](https://bugzilla.mozilla.org/show_bug.cgi?id=1580077#c10)||never |