OLD | NEW |
(Empty) | |
| 1 // Copyright 2014 The Chromium Authors. All rights reserved. |
| 2 // Use of this source code is governed by a BSD-style license that can be |
| 3 // found in the LICENSE file. |
| 4 |
| 5 module tracing; |
| 6 |
| 7 // To participate in the tracing ecosystem, implement the TraceController |
| 8 // interface and connect to the tracing app. Then, when the controller's Start() |
| 9 // function is called collect tracing data and pass it back via the provided |
| 10 // TraceDataCollector interface up until Stop() is called. |
| 11 |
| 12 interface TraceController { |
| 13 StartTracing(string categories, TraceDataCollector collector); |
| 14 StopTracing(); |
| 15 }; |
| 16 |
| 17 interface TraceDataCollector { |
| 18 DataCollected(string json); |
| 19 }; |
| 20 |
| 21 interface TraceCoordinator { |
| 22 // Request tracing data from all connected TraceControllers to stream to |
| 23 // |stream|. |
| 24 Start(handle<data_pipe_producer> stream, string categories); |
| 25 |
| 26 // Stop tracing and flush results to file. |
| 27 StopAndFlush(); |
| 28 }; |
| 29 |
| 30 // These times are used to determine startup performance metrics. |
| 31 // TODO(msw): Use TimeTicks to avoid system clock changes: crbug.com/521164 |
| 32 struct StartupPerformanceTimes { |
| 33 // TODO(msw): Rename to match "BrowserMainEntryTimeAbsolute" metric? |
| 34 int64 shell_process_creation_time; |
| 35 int64 browser_message_loop_start_time; |
| 36 int64 browser_window_display_time; |
| 37 int64 browser_open_tabs_time; |
| 38 // TODO(msw): Rename to avoid "web contents"? |
| 39 int64 first_web_contents_main_frame_load_time; |
| 40 // TODO(msw): Rename to match "FirstWebContents.NonEmptyPaint" metric? |
| 41 int64 first_visually_non_empty_layout_time; |
| 42 }; |
| 43 |
| 44 // This interface accepts startup performance timing from a variety of sources. |
| 45 interface StartupPerformanceDataCollector { |
| 46 // These setters may be called many times, only the first time is recorded. |
| 47 SetShellProcessCreationTime(int64 time); |
| 48 SetBrowserMessageLoopStartTime(int64 time); |
| 49 SetBrowserWindowDisplayTime(int64 time); |
| 50 SetBrowserOpenTabsTime(int64 time); |
| 51 SetFirstWebContentsMainFrameLoadTime(int64 time); |
| 52 SetFirstVisuallyNonEmptyLayoutTime(int64 time); |
| 53 |
| 54 // Get the currently available startup performance times. |
| 55 GetStartupPerformanceTimes() => (StartupPerformanceTimes times); |
| 56 }; |
OLD | NEW |