profile-viewer 0.0.0

data/dist/docs/images/transform-merge-node.svg

@@ -0,0 +1,96 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="410" height="328" viewBox="0 0 410 328">
+  <g fill="none" fill-rule="evenodd">
+    <text fill="#FF0039" font-family="Helvetica-Bold, Helvetica" font-size="17" font-weight="bold">
+      <tspan x="175.965" y="67">Merge</tspan> <tspan x="171.25" y="87">Node C</tspan>
+    </text>
+    <path fill="#FF0039" stroke="#FF0039" stroke-linecap="square" stroke-width="3" d="M163.5 37.5L238.506666 37.5M238.506666 37.5L227.706666 34.5 227.706666 40.5 238.506666 37.5z"/>
+    <g transform="translate(22 24)">
+      <ellipse cx="42" cy="141.5" stroke="#FF0039" stroke-width="3" rx="19" ry="19.5"/>
+      <ellipse cx="70" cy="77.5" stroke="#0A84FF" stroke-width="3" rx="19" ry="19.5"/>
+      <path fill="#4A4A4A" stroke="#4A4A4A" stroke-linecap="square" d="M69.5 27.5L69.5 62.5M69.5 62.5L72.5 51.7 66.5 51.7 69.5 62.5zM13.5 219.5L13.5 254.5M13.5 254.5L16.5 243.7 10.5 243.7 13.5 254.5zM70.5 219.5L70.5 254.5M70.5 254.5L73.5 243.7 67.5 243.7 70.5 254.5zM70.5 76.5L48.5 128.5M48.5 128.5L55.4710137 119.722474 49.9452101 117.384634 48.5 128.5zM42.5 139.5L20.5 191.5M20.5 191.5L27.4710137 182.722474 21.9452101 180.384634 20.5 191.5z"/>
+      <path fill="#4A4A4A" stroke="#4A4A4A" stroke-linecap="square" d="M91.5,76.5 L69.5,128.5" transform="matrix(-1 0 0 1 161 0)"/>
+      <path fill="#4A4A4A" stroke="#4A4A4A" stroke-linecap="square" d="M69.5,128.5 L76.4710137,119.722474 L70.9452101,117.384634 L69.5,128.5 Z"/>
+      <path fill="#4A4A4A" stroke="#4A4A4A" stroke-linecap="square" d="M63.5,139.5 L41.5,191.5" transform="matrix(-1 0 0 1 105 0)"/>
+      <path fill="#4A4A4A" stroke="#4A4A4A" stroke-linecap="square" d="M41.5,191.5 L48.4710137,182.722474 L42.9452101,180.384634 L41.5,191.5 Z"/>
+      <path fill="#4A4A4A" stroke="#4A4A4A" stroke-linecap="square" d="M119.5,139.5 L97.5,191.5" transform="matrix(-1 0 0 1 217 0)"/>
+      <path fill="#4A4A4A" stroke="#4A4A4A" stroke-linecap="square" d="M97.5,191.5 L104.471014,182.722474 L98.9452101,180.384634 L97.5,191.5 Z"/>
+      <circle cx="70" cy="14" r="14" fill="#D7D7DB" stroke="#737373"/>
+      <circle cx="70" cy="78" r="14" fill="#D7D7DB" stroke="#737373"/>
+      <circle cx="42" cy="142" r="14" fill="#D7D7DB" stroke="#737373"/>
+      <circle cx="14" cy="206" r="14" fill="#D7D7DB" stroke="#737373"/>
+      <circle cx="70" cy="206" r="14" fill="#D7D7DB" stroke="#737373"/>
+      <circle cx="70" cy="270" r="14" fill="#D7D7DB" stroke="#737373"/>
+      <circle cx="14" cy="270" r="14" fill="#D7D7DB" stroke="#737373"/>
+      <circle cx="98" cy="142" r="14" fill="#D7D7DB" stroke="#737373"/>
+      <circle cx="126" cy="206" r="14" fill="#D7D7DB" stroke="#737373"/>
+      <text fill="#000" font-family="Helvetica" font-size="17">
+        <tspan x="64.331" y="19">A</tspan>
+      </text>
+      <text fill="#000" font-family="Helvetica" font-size="17">
+        <tspan x="64.331" y="83">B</tspan>
+      </text>
+      <text fill="#000" font-family="Helvetica" font-size="17">
+        <tspan x="35.862" y="147">C</tspan>
+      </text>
+      <text fill="#000" font-family="Helvetica" font-size="17">
+        <tspan x="7.862" y="211">D</tspan>
+      </text>
+      <text fill="#000" font-family="Helvetica" font-size="17">
+        <tspan x="64.808" y="211">F</tspan>
+      </text>
+      <text fill="#000" font-family="Helvetica" font-size="17">
+        <tspan x="63.388" y="275">G</tspan>
+      </text>
+      <text fill="#000" font-family="Helvetica" font-size="17">
+        <tspan x="8.331" y="275">E</tspan>
+      </text>
+      <text fill="#000" font-family="Helvetica" font-size="17">
+        <tspan x="91.862" y="147">H</tspan>
+      </text>
+      <text fill="#000" font-family="Helvetica" font-size="17">
+        <tspan x="119.862" y="211">C</tspan>
+      </text>
+      <path fill="#FF0039" stroke="#FF0039" stroke-linecap="square" stroke-width="2" d="M43.5 121.5L55 98M55 98L47.5581789 106.382082 52.9474792 109.019399 55 98z"/>
+    </g>
+    <g transform="translate(242 24)">
+      <ellipse cx="70" cy="77.5" stroke="#0A84FF" stroke-width="3" rx="19" ry="19.5"/>
+      <path fill="#4A4A4A" stroke="#4A4A4A" stroke-linecap="square" d="M69.5 27.5L69.5 62.5M69.5 62.5L72.5 51.7 66.5 51.7 69.5 62.5zM13.5 169.5L13.5 204.5M13.5 204.5L16.5 193.7 10.5 193.7 13.5 204.5zM70.5 169.5L70.5 204.5M70.5 204.5L73.5 193.7 67.5 193.7 70.5 204.5zM126.5 169.5L126.5 204.5M126.5 204.5L129.5 193.7 123.5 193.7 126.5 204.5zM66.5 81.5L20.5 141.5M20.5 141.5L29.4518798 134.754346 24.6902416 131.103757 20.5 141.5z"/>
+      <path fill="#4A4A4A" stroke="#4A4A4A" stroke-linecap="square" d="M69.5,92.5 L69.5,140.5" transform="matrix(-1 0 0 1 139 0)"/>
+      <path fill="#4A4A4A" stroke="#4A4A4A" stroke-linecap="square" d="M69.5,140.5 L72.5,129.7 L66.5,129.7 L69.5,140.5 Z"/>
+      <path fill="#4A4A4A" stroke="#4A4A4A" stroke-linecap="square" d="M119.5,81.5 L73.5,141.5" transform="matrix(-1 0 0 1 193 0)"/>
+      <path fill="#4A4A4A" stroke="#4A4A4A" stroke-linecap="square" d="M73.5,141.5 L82.4518798,134.754346 L77.6902416,131.103757 L73.5,141.5 Z"/>
+      <circle cx="70" cy="14" r="14" fill="#D7D7DB" stroke="#737373"/>
+      <circle cx="70" cy="78" r="14" fill="#D7D7DB" stroke="#737373"/>
+      <circle cx="14" cy="156" r="14" fill="#D7D7DB" stroke="#737373"/>
+      <circle cx="70" cy="156" r="14" fill="#D7D7DB" stroke="#737373"/>
+      <circle cx="70" cy="220" r="14" fill="#D7D7DB" stroke="#737373"/>
+      <circle cx="126" cy="219" r="14" fill="#D7D7DB" stroke="#737373"/>
+      <circle cx="14" cy="220" r="14" fill="#D7D7DB" stroke="#737373"/>
+      <circle cx="126" cy="156" r="14" fill="#D7D7DB" stroke="#737373"/>
+      <text fill="#000" font-family="Helvetica" font-size="17">
+        <tspan x="64.331" y="19">A</tspan>
+      </text>
+      <text fill="#000" font-family="Helvetica" font-size="17">
+        <tspan x="64.331" y="83">B</tspan>
+      </text>
+      <text fill="#000" font-family="Helvetica" font-size="17">
+        <tspan x="7.862" y="161">D</tspan>
+      </text>
+      <text fill="#000" font-family="Helvetica" font-size="17">
+        <tspan x="64.808" y="161">F</tspan>
+      </text>
+      <text fill="#000" font-family="Helvetica" font-size="17">
+        <tspan x="63.388" y="225">G</tspan>
+      </text>
+      <text fill="#000" font-family="Helvetica" font-size="17">
+        <tspan x="119.862" y="224">C</tspan>
+      </text>
+      <text fill="#000" font-family="Helvetica" font-size="17">
+        <tspan x="8.331" y="225">E</tspan>
+      </text>
+      <text fill="#000" font-family="Helvetica" font-size="17">
+        <tspan x="119.862" y="161">H</tspan>
+      </text>
+    </g>
+  </g>
+</svg>

data/dist/docs/index.html

@@ -0,0 +1,21 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <title>Firefox Profiler - Documentation</title>
+  <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1" />
+  <meta name="description" content="Documentation related to the Firefox Profiler, a tool to record and visualize profile.">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <link rel="stylesheet" href="css/vue_v4.12.2.min.css">
+  <link rel="stylesheet" href="css/style-overrides.css">
+</head>
+<body>
+  <div id="app"></div>
+  <script src='js/init.js'></script>
+  <!-- This includes a fix in docsify for pages with more than 1 video.
+    See https://github.com/docsifyjs/docsify/pull/1824 -->
+  <script src="js/docsify_v4.12.2+.min.js"></script>
+  <script src="js/ga_v4.12.2.min.js"></script>
+  <script src="js/search_v4.12.2.min.js"></script>
+</body>
+</html>

data/dist/docs/ipc-messages.md

@@ -0,0 +1,44 @@
+# IPC Messages
+
+The Firefox Profiler supports recording IPC messages for any actively-profiled
+thread. During profiling, each IPC message is recorded with 5 events:
+
+1. When the `SendXXX` function is called on the origin thread
+2. When the sender's IO thread begins sending bytes over the IPC channel
+3. When the sender's IO thread finishes sending bytes over the IPC channel
+4. When the recipient's IO thread finishes receiving bytes from the IPC channel
+5. When the `RecvXXX` function is called on the destination thread
+
+## IPC Track
+
+After collecting a profile with IPC messages, there will be a new track in the
+timeline showing the outgoing (blue) and incoming (purple) IPC messages.
+Hovering over a marker for an IPC message will provide more details about it:
+
+![A screenshot of the popup UI for an IPC message.](images/ipc-messages-popup.png)
+
+Each IPC message has several durations associated with it, corresponding to the
+spans of time between consecutive IPC message phases as described above:
+
+* *Send thread latency*: the time between `SendXXX` being called and the first
+  byte sent over the IPC channel
+* *IPC send duration*: the time taken to send all the bytes over the IPC channel
+* *IPC recv latency*: the time between the last byte being sent over the IPC
+  channel and the last byte being *received*
+* *Recv thread latency*: the time between the last byte being received from the
+  IPC channel and the `RecvXXX` function being called
+
+## Enabling the Feature
+
+In `about:profiling`, scroll down to the `Features` section and enable the
+`IPC Messages` checkbox.
+
+![A screenshot of the UI to turn on IPC messages.](images/ipc-messages-feature.png)
+
+### Profiling the IO Threads
+
+By default, the sender's and recipient's IO threads aren't included in a
+profile. To include these, add `Gecko_IOThread` and  `Chrome_ChildThread` to the
+list of threads to be profiled.
+
+![A screenshot of the UI to profile the IO threads](images/ipc-messages-io-threads.png)