| # Copyright 2014 The Chromium Authors. All rights reserved. |
| # Use of this source code is governed by a BSD-style license that can be |
| # found in the LICENSE file. |
| |
| import random |
| import unittest |
| |
| from telemetry.web_perf.metrics.rendering_stats import ( |
| UI_COMP_NAME, BEGIN_COMP_NAME, ORIGINAL_COMP_NAME, END_COMP_NAME) |
| from telemetry.web_perf.metrics.rendering_stats import ComputeInputEventLatency |
| from telemetry.web_perf.metrics.rendering_stats import GetInputLatencyEvents |
| from telemetry.web_perf.metrics.rendering_stats import HasRenderingStats |
| from telemetry.web_perf.metrics.rendering_stats import NotEnoughFramesError |
| from telemetry.web_perf.metrics.rendering_stats import RenderingStats |
| from telemetry.util.statistics import DivideIfPossibleOrZero |
| import telemetry.timeline.bounds as timeline_bounds |
| from telemetry.timeline import model |
| import telemetry.timeline.async_slice as tracing_async_slice |
| |
| |
| class MockTimer(object): |
| """A mock timer class which can generate random durations. |
| |
| An instance of this class is used as a global timer to generate random |
| durations for stats and consistent timestamps for all mock trace events. |
| The unit of time is milliseconds. |
| """ |
| def __init__(self): |
| self.milliseconds = 0 |
| |
| def Get(self): |
| return self.milliseconds |
| |
| def Advance(self, low=0, high=1): |
| delta = random.uniform(low, high) |
| self.milliseconds += delta |
| return delta |
| |
| |
| class ReferenceRenderingStats(object): |
| """ Stores expected data for comparison with actual RenderingStats """ |
| def __init__(self): |
| self.frame_timestamps = [] |
| self.frame_times = [] |
| self.paint_times = [] |
| self.painted_pixel_counts = [] |
| self.record_times = [] |
| self.recorded_pixel_counts = [] |
| self.rasterize_times = [] |
| self.rasterized_pixel_counts = [] |
| self.approximated_pixel_percentages = [] |
| |
| def AppendNewRange(self): |
| self.frame_timestamps.append([]) |
| self.frame_times.append([]) |
| self.paint_times.append([]) |
| self.painted_pixel_counts.append([]) |
| self.record_times.append([]) |
| self.recorded_pixel_counts.append([]) |
| self.rasterize_times.append([]) |
| self.rasterized_pixel_counts.append([]) |
| self.approximated_pixel_percentages.append([]) |
| |
| class ReferenceInputLatencyStats(object): |
| """ Stores expected data for comparison with actual input latency stats """ |
| def __init__(self): |
| self.input_event_latency = [] |
| self.input_event = [] |
| |
| def AddMainThreadRenderingStats(mock_timer, thread, first_frame, |
| ref_stats = None): |
| """ Adds a random main thread rendering stats event. |
| |
| thread: The timeline model thread to which the event will be added. |
| first_frame: Is this the first frame within the bounds of an action? |
| ref_stats: A ReferenceRenderingStats object to record expected values. |
| """ |
| # Create randonm data and timestap for main thread rendering stats. |
| data = { 'frame_count': 0, |
| 'paint_time': 0.0, |
| 'painted_pixel_count': 0, |
| 'record_time': mock_timer.Advance(2, 4) / 1000.0, |
| 'recorded_pixel_count': 3000*3000 } |
| timestamp = mock_timer.Get() |
| |
| # Add a slice with the event data to the given thread. |
| thread.PushCompleteSlice( |
| 'benchmark', 'BenchmarkInstrumentation::MainThreadRenderingStats', |
| timestamp, duration=0.0, thread_timestamp=None, thread_duration=None, |
| args={'data': data}) |
| |
| if not ref_stats: |
| return |
| |
| # Add timestamp only if a frame was output |
| if data['frame_count'] == 1: |
| if not first_frame: |
| # Add frame_time if this is not the first frame in within the bounds of an |
| # action. |
| prev_timestamp = ref_stats.frame_timestamps[-1][-1] |
| ref_stats.frame_times[-1].append(round(timestamp - prev_timestamp, 2)) |
| ref_stats.frame_timestamps[-1].append(timestamp) |
| |
| ref_stats.paint_times[-1].append(data['paint_time'] * 1000.0) |
| ref_stats.painted_pixel_counts[-1].append(data['painted_pixel_count']) |
| ref_stats.record_times[-1].append(data['record_time'] * 1000.0) |
| ref_stats.recorded_pixel_counts[-1].append(data['recorded_pixel_count']) |
| |
| |
| def AddImplThreadRenderingStats(mock_timer, thread, first_frame, |
| ref_stats = None): |
| """ Adds a random impl thread rendering stats event. |
| |
| thread: The timeline model thread to which the event will be added. |
| first_frame: Is this the first frame within the bounds of an action? |
| ref_stats: A ReferenceRenderingStats object to record expected values. |
| """ |
| # Create randonm data and timestap for impl thread rendering stats. |
| data = { 'frame_count': 1, |
| 'rasterize_time': mock_timer.Advance(5, 10) / 1000.0, |
| 'rasterized_pixel_count': 1280*720, |
| 'visible_content_area': random.uniform(0, 100), |
| 'approximated_visible_content_area': random.uniform(0, 5)} |
| timestamp = mock_timer.Get() |
| |
| # Add a slice with the event data to the given thread. |
| thread.PushCompleteSlice( |
| 'benchmark', 'BenchmarkInstrumentation::ImplThreadRenderingStats', |
| timestamp, duration=0.0, thread_timestamp=None, thread_duration=None, |
| args={'data': data}) |
| |
| if not ref_stats: |
| return |
| |
| # Add timestamp only if a frame was output |
| if data['frame_count'] == 1: |
| if not first_frame: |
| # Add frame_time if this is not the first frame in within the bounds of an |
| # action. |
| prev_timestamp = ref_stats.frame_timestamps[-1][-1] |
| ref_stats.frame_times[-1].append(round(timestamp - prev_timestamp, 2)) |
| ref_stats.frame_timestamps[-1].append(timestamp) |
| |
| ref_stats.rasterize_times[-1].append(data['rasterize_time'] * 1000.0) |
| ref_stats.rasterized_pixel_counts[-1].append(data['rasterized_pixel_count']) |
| ref_stats.approximated_pixel_percentages[-1].append( |
| round(DivideIfPossibleOrZero(data['approximated_visible_content_area'], |
| data['visible_content_area']) * 100.0, 3)) |
| |
| |
| def AddInputLatencyStats(mock_timer, start_thread, end_thread, |
| ref_latency_stats = None): |
| """ Adds a random input latency stats event. |
| |
| start_thread: The start thread on which the async slice is added. |
| end_thread: The end thread on which the async slice is ended. |
| ref_latency_stats: A ReferenceInputLatencyStats object for expected values. |
| """ |
| |
| mock_timer.Advance(2, 4) |
| original_comp_time = mock_timer.Get() * 1000.0 |
| mock_timer.Advance(2, 4) |
| ui_comp_time = mock_timer.Get() * 1000.0 |
| mock_timer.Advance(2, 4) |
| begin_comp_time = mock_timer.Get() * 1000.0 |
| mock_timer.Advance(10, 20) |
| end_comp_time = mock_timer.Get() * 1000.0 |
| |
| data = { ORIGINAL_COMP_NAME: {'time': original_comp_time}, |
| UI_COMP_NAME: {'time': ui_comp_time}, |
| BEGIN_COMP_NAME: {'time': begin_comp_time}, |
| END_COMP_NAME: {'time': end_comp_time} } |
| |
| timestamp = mock_timer.Get() |
| |
| async_slice = tracing_async_slice.AsyncSlice( |
| 'benchmark', 'InputLatency', timestamp) |
| |
| async_sub_slice = tracing_async_slice.AsyncSlice( |
| 'benchmark', 'InputLatency', timestamp) |
| async_sub_slice.args = {'data': data} |
| async_sub_slice.parent_slice = async_slice |
| async_sub_slice.start_thread = start_thread |
| async_sub_slice.end_thread = end_thread |
| |
| async_slice.sub_slices.append(async_sub_slice) |
| async_slice.start_thread = start_thread |
| async_slice.end_thread = end_thread |
| start_thread.AddAsyncSlice(async_slice) |
| |
| if not ref_latency_stats: |
| return |
| |
| ref_latency_stats.input_event.append(async_sub_slice) |
| ref_latency_stats.input_event_latency.append( |
| (data[END_COMP_NAME]['time'] - data[ORIGINAL_COMP_NAME]['time']) / 1000.0) |
| |
| |
| class RenderingStatsUnitTest(unittest.TestCase): |
| def testHasRenderingStats(self): |
| timeline = model.TimelineModel() |
| timer = MockTimer() |
| |
| # A process without rendering stats |
| process_without_stats = timeline.GetOrCreateProcess(pid = 1) |
| thread_without_stats = process_without_stats.GetOrCreateThread(tid = 11) |
| process_without_stats.FinalizeImport() |
| self.assertFalse(HasRenderingStats(thread_without_stats)) |
| |
| # A process with rendering stats, but no frames in them |
| process_without_frames = timeline.GetOrCreateProcess(pid = 2) |
| thread_without_frames = process_without_frames.GetOrCreateThread(tid = 21) |
| AddMainThreadRenderingStats(timer, thread_without_frames, True, None) |
| process_without_frames.FinalizeImport() |
| self.assertFalse(HasRenderingStats(thread_without_frames)) |
| |
| # A process with rendering stats and frames in them |
| process_with_frames = timeline.GetOrCreateProcess(pid = 3) |
| thread_with_frames = process_with_frames.GetOrCreateThread(tid = 31) |
| AddImplThreadRenderingStats(timer, thread_with_frames, True, None) |
| process_with_frames.FinalizeImport() |
| self.assertTrue(HasRenderingStats(thread_with_frames)) |
| |
| def testRangeWithoutFrames(self): |
| timer = MockTimer() |
| timeline = model.TimelineModel() |
| |
| # Create a renderer process, with a main thread and impl thread. |
| renderer = timeline.GetOrCreateProcess(pid = 2) |
| renderer_main = renderer.GetOrCreateThread(tid = 21) |
| renderer_compositor = renderer.GetOrCreateThread(tid = 22) |
| |
| # Create 10 main and impl rendering stats events for Action A. |
| timer.Advance(2, 4) |
| renderer_main.BeginSlice('webkit.console', 'ActionA', timer.Get(), '') |
| for i in xrange(0, 10): |
| first = (i == 0) |
| AddMainThreadRenderingStats(timer, renderer_main, first, None) |
| AddImplThreadRenderingStats(timer, renderer_compositor, first, None) |
| timer.Advance(2, 4) |
| renderer_main.EndSlice(timer.Get()) |
| |
| # Create 5 main and impl rendering stats events not within any action. |
| for i in xrange(0, 5): |
| first = (i == 0) |
| AddMainThreadRenderingStats(timer, renderer_main, first, None) |
| AddImplThreadRenderingStats(timer, renderer_compositor, first, None) |
| |
| # Create Action B without any frames. This should trigger |
| # NotEnoughFramesError when the RenderingStats object is created. |
| timer.Advance(2, 4) |
| renderer_main.BeginSlice('webkit.console', 'ActionB', timer.Get(), '') |
| timer.Advance(2, 4) |
| renderer_main.EndSlice(timer.Get()) |
| |
| renderer.FinalizeImport() |
| |
| timeline_markers = timeline.FindTimelineMarkers(['ActionA', 'ActionB']) |
| timeline_ranges = [ timeline_bounds.Bounds.CreateFromEvent(marker) |
| for marker in timeline_markers ] |
| self.assertRaises(NotEnoughFramesError, RenderingStats, |
| renderer, None, timeline_ranges) |
| |
| def testFromTimeline(self): |
| timeline = model.TimelineModel() |
| |
| # Create a browser process and a renderer process, and a main thread and |
| # impl thread for each. |
| browser = timeline.GetOrCreateProcess(pid = 1) |
| browser_main = browser.GetOrCreateThread(tid = 11) |
| browser_compositor = browser.GetOrCreateThread(tid = 12) |
| renderer = timeline.GetOrCreateProcess(pid = 2) |
| renderer_main = renderer.GetOrCreateThread(tid = 21) |
| renderer_compositor = renderer.GetOrCreateThread(tid = 22) |
| |
| timer = MockTimer() |
| renderer_ref_stats = ReferenceRenderingStats() |
| browser_ref_stats = ReferenceRenderingStats() |
| |
| # Create 10 main and impl rendering stats events for Action A. |
| timer.Advance(2, 4) |
| renderer_main.BeginSlice('webkit.console', 'ActionA', timer.Get(), '') |
| renderer_ref_stats.AppendNewRange() |
| browser_ref_stats.AppendNewRange() |
| for i in xrange(0, 10): |
| first = (i == 0) |
| AddMainThreadRenderingStats( |
| timer, renderer_main, first, renderer_ref_stats) |
| AddImplThreadRenderingStats( |
| timer, renderer_compositor, first, renderer_ref_stats) |
| AddMainThreadRenderingStats( |
| timer, browser_main, first, browser_ref_stats) |
| AddImplThreadRenderingStats( |
| timer, browser_compositor, first, browser_ref_stats) |
| timer.Advance(2, 4) |
| renderer_main.EndSlice(timer.Get()) |
| |
| # Create 5 main and impl rendering stats events not within any action. |
| for i in xrange(0, 5): |
| first = (i == 0) |
| AddMainThreadRenderingStats(timer, renderer_main, first, None) |
| AddImplThreadRenderingStats(timer, renderer_compositor, first, None) |
| AddMainThreadRenderingStats(timer, browser_main, first, None) |
| AddImplThreadRenderingStats(timer, browser_compositor, first, None) |
| |
| # Create 10 main and impl rendering stats events for Action B. |
| timer.Advance(2, 4) |
| renderer_main.BeginSlice('webkit.console', 'ActionB', timer.Get(), '') |
| renderer_ref_stats.AppendNewRange() |
| browser_ref_stats.AppendNewRange() |
| for i in xrange(0, 10): |
| first = (i == 0) |
| AddMainThreadRenderingStats( |
| timer, renderer_main, first, renderer_ref_stats) |
| AddImplThreadRenderingStats( |
| timer, renderer_compositor, first, renderer_ref_stats) |
| AddMainThreadRenderingStats( |
| timer, browser_main, first, browser_ref_stats) |
| AddImplThreadRenderingStats( |
| timer, browser_compositor, first, browser_ref_stats) |
| timer.Advance(2, 4) |
| renderer_main.EndSlice(timer.Get()) |
| |
| # Create 10 main and impl rendering stats events for Action A. |
| timer.Advance(2, 4) |
| renderer_main.BeginSlice('webkit.console', 'ActionA', timer.Get(), '') |
| renderer_ref_stats.AppendNewRange() |
| browser_ref_stats.AppendNewRange() |
| for i in xrange(0, 10): |
| first = (i == 0) |
| AddMainThreadRenderingStats( |
| timer, renderer_main, first, renderer_ref_stats) |
| AddImplThreadRenderingStats( |
| timer, renderer_compositor, first, renderer_ref_stats) |
| AddMainThreadRenderingStats( |
| timer, browser_main, first, browser_ref_stats) |
| AddImplThreadRenderingStats( |
| timer, browser_compositor, first, browser_ref_stats) |
| timer.Advance(2, 4) |
| renderer_main.EndSlice(timer.Get()) |
| |
| browser.FinalizeImport() |
| renderer.FinalizeImport() |
| |
| timeline_markers = timeline.FindTimelineMarkers( |
| ['ActionA', 'ActionB', 'ActionA']) |
| timeline_ranges = [ timeline_bounds.Bounds.CreateFromEvent(marker) |
| for marker in timeline_markers ] |
| stats = RenderingStats(renderer, browser, timeline_ranges) |
| |
| # Compare rendering stats to reference. |
| self.assertEquals(stats.frame_timestamps, |
| browser_ref_stats.frame_timestamps) |
| self.assertEquals(stats.frame_times, browser_ref_stats.frame_times) |
| self.assertEquals(stats.rasterize_times, renderer_ref_stats.rasterize_times) |
| self.assertEquals(stats.rasterized_pixel_counts, |
| renderer_ref_stats.rasterized_pixel_counts) |
| self.assertEquals(stats.approximated_pixel_percentages, |
| renderer_ref_stats.approximated_pixel_percentages) |
| self.assertEquals(stats.paint_times, renderer_ref_stats.paint_times) |
| self.assertEquals(stats.painted_pixel_counts, |
| renderer_ref_stats.painted_pixel_counts) |
| self.assertEquals(stats.record_times, renderer_ref_stats.record_times) |
| self.assertEquals(stats.recorded_pixel_counts, |
| renderer_ref_stats.recorded_pixel_counts) |
| |
| def testInputLatencyFromTimeline(self): |
| timeline = model.TimelineModel() |
| |
| # Create a browser process and a renderer process. |
| browser = timeline.GetOrCreateProcess(pid = 1) |
| browser_main = browser.GetOrCreateThread(tid = 11) |
| renderer = timeline.GetOrCreateProcess(pid = 2) |
| renderer_main = renderer.GetOrCreateThread(tid = 21) |
| |
| timer = MockTimer() |
| ref_latency = ReferenceInputLatencyStats() |
| |
| # Create 10 input latency stats events for Action A. |
| timer.Advance(2, 4) |
| renderer_main.BeginSlice('webkit.console', 'ActionA', timer.Get(), '') |
| for _ in xrange(0, 10): |
| AddInputLatencyStats(timer, browser_main, renderer_main, ref_latency) |
| timer.Advance(2, 4) |
| renderer_main.EndSlice(timer.Get()) |
| |
| # Create 5 input latency stats events not within any action. |
| timer.Advance(2, 4) |
| for _ in xrange(0, 5): |
| AddInputLatencyStats(timer, browser_main, renderer_main, None) |
| |
| # Create 10 input latency stats events for Action B. |
| timer.Advance(2, 4) |
| renderer_main.BeginSlice('webkit.console', 'ActionB', timer.Get(), '') |
| for _ in xrange(0, 10): |
| AddInputLatencyStats(timer, browser_main, renderer_main, ref_latency) |
| timer.Advance(2, 4) |
| renderer_main.EndSlice(timer.Get()) |
| |
| # Create 10 input latency stats events for Action A. |
| timer.Advance(2, 4) |
| renderer_main.BeginSlice('webkit.console', 'ActionA', timer.Get(), '') |
| for _ in xrange(0, 10): |
| AddInputLatencyStats(timer, browser_main, renderer_main, ref_latency) |
| timer.Advance(2, 4) |
| renderer_main.EndSlice(timer.Get()) |
| |
| browser.FinalizeImport() |
| renderer.FinalizeImport() |
| |
| input_events = [] |
| |
| timeline_markers = timeline.FindTimelineMarkers( |
| ['ActionA', 'ActionB', 'ActionA']) |
| for timeline_range in [ timeline_bounds.Bounds.CreateFromEvent(marker) |
| for marker in timeline_markers ]: |
| if timeline_range.is_empty: |
| continue |
| input_events.extend(GetInputLatencyEvents(browser, timeline_range)) |
| |
| self.assertEquals(input_events, ref_latency.input_event) |
| self.assertEquals(ComputeInputEventLatency(input_events), |
| ref_latency.input_event_latency) |
