Skip to content

Commit 0f93372

Browse files
committed
pngs at top of Overview
1 parent b02f493 commit 0f93372

7 files changed

Lines changed: 63 additions & 29 deletions

File tree

625 Bytes
Loading
284 Bytes
Loading
287 Bytes
Loading
213 KB
Loading
132 KB
Loading
Binary file not shown.

microsoft-edge/devtools-guide-chromium/performance/overview.md

Lines changed: 63 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -46,24 +46,46 @@ Use the **Performance** tool to analyze your website's performance.
4646

4747

4848
<!-- ====================================================================== -->
49-
## Overview
49+
## Switch between Local metrics view and recorded profile timeline view
50+
<!-- upstream heading: ## Overview -->
5051
<!-- https://developer.chrome.com/docs/devtools/performance/overview#overview -->
52+
<!-- https://microsoftedge.github.io/Demos/exploring-the-universe/ -->
53+
<!-- covers basic nav between the two states, and what to use them for, not how to use either view -->
5154

52-
The **Performance** tool lets you record CPU performance profiles of your web applications. Analyze profiles to find potential performance bottlenecks and ways you can optimize resource use.
55+
The **Performance** tool displays local metrics for page interactions, and lets you record CPU performance profiles of your web applications. Analyze profiles to find potential performance bottlenecks and ways that you can optimize resource use.
5356

54-
![The Performance tool](./overview-images/performance-tool.png)
55-
<!-- https://microsoftedge.github.io/Demos/exploring-the-universe/ -->
57+
Use the **Performance** tool to view Core Web Vitals metrics in the initial, **Local metrics** view. The home page of the **Performance** tool shows **Local metrics**, which is performance metrics about the rendered webpage:
58+
59+
* Largest Contentful Paint (LCP) - How quickly the main content of the page loaded.
60+
* Cumulative Layout Shift (CLS) - A measure of the most recent unexpected page layout shift.
61+
* Interaction to Next Paint (INP) - The responsiveness of the most recent user interaction on the page.
62+
63+
When you initially open the **Performance** tool, Core Web Vitals metrics are displayed, in three cards in a **Local metrics** section:
5664

57-
Use the **Performance** tool to do the following:
65+
![The Performance tool home page showing Local metrics](./overview-images/performance-tool-intro-home-page.png)<!-- do not reuse -->
5866

59-
* View local Core Web Vitals metrics: Largest Contentful Paint (LCP), Cumulative Layout Shift (CLS), and Interaction to Next Paint (INP).
67+
To switch to displaying an opened recorded profile timeline, click the **Show recent timeline sessions** dropdown, to the right of the **Go back to the live metrics page** (![The "Go back to the live metrics page" (house) icon, dimmed](./overview-images/house-icon-dimmed.png)) button.
68+
69+
Also use the **Performance** tool to view a recorded performance trace, including:
6070
* Record a performance profile.
6171
* Change capture settings.
62-
* Analyze a performance report.
72+
* Analyze a performance report. Shows information about the performance of the page over the period of time where the recording occurred, such as:
73+
* The user interactions that occurred during the recording.
74+
* The JavaScript code that ran.
75+
* The styling and layout operations that occurred.
76+
* Other performance metrics over time, such as network requests and layout shifts.
77+
78+
After you record a performance trace, the performance trace is displayed instead of **Local metrics**.
79+
80+
The **Show recent timeline sessions** dropdown, to the right of the **Go back to the live metrics page** (![The "Go back to the live metrics page" (house) icon, dimmed](./overview-images/house-icon-dimmed.png)) button, enables switching between **Local metrics** (Core Web Vitals) and multiple recorded performance traces (also called _profiles_ or _timeline sessions_).
6381

64-
When you initially open the **Performance** tool, Core Web Vitals metrics are displayed, in three cards in a **Local metrics** section. After you record a performance trace, the performance trace is displayed instead of Core Web Vitals. A dropdown menu enables switching between Core Web Vitals (**Local metrics**) and multiple recorded performance traces.
82+
![The Performance tool displaying a recorded profile](./overview-images/performance-tool-intro-profile.png)<!-- do not reuse -->
6583

66-
For a comprehensive guide on improving your website's performance, see [Analyze runtime performance (tutorial)](./index.md).
84+
To switch to displaying the initial, **Local metrics** view, click the **Go back to the live metrics page** (![The "Go back to the live metrics page" (house) icon](./overview-images/house-icon.png)) button.
85+
86+
To switch to displaying a different opened recorded profile timeline, click the **Show recent timeline sessions** dropdown, to the right of the **Go back to the live metrics page** (![The "Go back to the live metrics page" (house) icon](./overview-images/house-icon.png)) button.
87+
88+
For a walkthrough of using the **Performance** tool to improve your website's performance, see [Analyze runtime performance (tutorial)](./index.md).
6789

6890

6991
<!-- ====================================================================== -->
@@ -72,11 +94,13 @@ For a comprehensive guide on improving your website's performance, see [Analyze
7294

7395
To open the **Performance** tool:
7496

75-
1. Right-click a webpage,<!-- https://microsoftedge.github.io/Demos/devtools-performance-get-started/ --> and then select **Inspect**.
97+
1. Go to a webpage, such as the [Exploring the universe](https://microsoftedge.github.io/Demos/exploring-the-universe/) demo, in a new window or tab.
98+
99+
1. Right-click the webpage, and then select **Inspect**.
76100

77101
DevTools opens.
78102

79-
1. In the **Activity Bar** at top, select the ![Performance icon](./overview-images/performance-icon.png) **Performance** tool.
103+
1. In the **Activity Bar** at top, click the ![Performance icon](./overview-images/performance-icon.png) **Performance** tool.
80104

81105
If the ![Performance icon](./overview-images/performance-icon.png) **Performance** tool isn't shown in the **Activity Bar**, click the **More tools** (![The More tools icon](./overview-images/more-tools-icon.png)) button and then select the **Performance** tool.
82106

@@ -85,36 +109,34 @@ To open the **Performance** tool:
85109
#### Using the Command Menu
86110
<!-- added heading as separator, compared to upstream -->
87111

88-
Or, open the **Performance** tool by using the **Command Menu**, as follows:
112+
To open the **Performance** tool by using the **Command Menu**:
89113

90-
1. Right-click a webpage, and then select **Inspect**.
114+
1. Go to a webpage, such as the [Exploring the universe](https://microsoftedge.github.io/Demos/exploring-the-universe/) demo, in a new window or tab.
115+
116+
1. Right-click the webpage, and then select **Inspect**.
91117

92118
DevTools opens.
93119

94-
1. Open the **Command Menu** by pressing:
120+
1. In the upper right of DevTools, click **Customize and control DevTools**, click **Run command**.
121+
122+
Or, press:
95123

96124
* macOS: **Command+Shift+P**
97125
* Windows, Linux, ChromeOS: **Control+Shift+P**
98126

99-
![Command Menu with 'performance' entered](./overview-images/command-menu-performance.png)
127+
The **Command Menu** opens, and reads **Run >Command**.
100128

101129
1. Start typing **performance**, select **Show Performance [panel]**, and then press **Enter**.
102130

131+
![Command Menu with 'performance' entered](./overview-images/command-menu-performance.png)
132+
103133

104134
<!-- ====================================================================== -->
105135
## Monitor Core Web Vitals metrics
106136
<!-- ## Observe Core Web Vitals live https://developer.chrome.com/docs/devtools/performance/overview#live-metrics -->
137+
<!-- details about using this view -->
107138

108-
The home page of the **Performance** tool shows performance metrics about the rendered webpage, such as:
109-
* Largest Contentful Paint (LCP), which shows how quickly the main content of the page loaded.
110-
* Cumulative Layout Shift (CLS), which shows a measure of the most recent unexpected layout shift.
111-
* Interaction to Next Paint (INP), which assesses the responsiveness of the most recent user interaction on the page.
112-
113-
In contrast, a recorded performance trace shows information about the performance of the page over the period of time where the recording occurred, such as:
114-
* The user interactions that occurred during the recording.
115-
* The JavaScript code that ran.
116-
* The styling and layout operations that occurred.
117-
* Other performance metrics over time, such as network requests and layout shifts.
139+
To view **Local metrics** (Core Web Vitals metrics) instead of a profile, see [Switch between Local metrics view and recorded profile timeline view](#switch-between-local-metrics-view-and-recorded-profile-timeline-view), above.
118140

119141

120142
<!-- ---------------------------------- -->
@@ -145,13 +167,25 @@ To get a breakdown of a metric score, hover over the metric value to see a toolt
145167

146168
To interact with a webpage to display the **Interaction to Next Paint (INP)** card:
147169

148-
1. Open the [Exploring the universe](https://microsoftedge.github.io/Demos/exploring-the-universe/) demo in a new window or tab.
170+
1. Open a webpage, such as the [Exploring the universe](https://microsoftedge.github.io/Demos/exploring-the-universe/) demo, in a new window or tab.
149171

150-
1. Right-click the webpage and then select **Inspect** to open DevTools, and then select the **Performance** tool.
172+
1. Right-click the webpage and then select **Inspect**.
173+
174+
DevTools opens.
175+
176+
1. In the **Activity Bar** at top, click the ![Performance icon](./overview-images/performance-icon.png) **Performance** tool.
177+
178+
If the ![Performance icon](./overview-images/performance-icon.png) **Performance** tool isn't shown in the **Activity Bar**, click the **More tools** (![The More tools icon](./overview-images/more-tools-icon.png)) button and then select the **Performance** tool.
179+
180+
1. Select **Home page** > **Next steps** pane > **Environment settings** card > **CPU throttling** dropdown > **4x slowdown - recommended**.
181+
182+
Or, select **Capture settings** (![Capture settings icon with a blue dot](./overview-images/capture-settings-icon-blue-dot.png)) > **CPU throttling** dropdown > **4x slowdown - recommended**.
183+
184+
1. Select **Home page** > **Next steps** pane > **Environment settings** card > **Network throttling** dropdown > **Slow 4G**.
151185

152-
1. Set a 4x CPU slowdown and a slow 4G network throttle.
186+
Or, select **Capture settings** (![Capture settings icon with a blue dot](./overview-images/capture-settings-icon-blue-dot.png)) > **Network throttling** dropdown > **Slow 4G**.
153187

154-
1. Right-click the **Refresh** button to the left of the Address bar, and then select **Empty cache and hard refresh**.
188+
1. Right-click (or long-click) the **Refresh** button to the left of the Address bar, and then select **Empty cache and hard refresh**.
155189

156190
This ensures that the image is loaded again from the server, not from the local cache.
157191

0 commit comments

Comments
 (0)