<!DOCTYPE html>
<html>
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
    <title>quickstart_parsing_ability</title>

    <meta name="viewport" content="width=device-width, initial-scale=1.0" />

    <style>
      code[class*='smartperf-'],
      pre[class*='smartperf-'] {
        color: #333333;
        background: none;
        font-family: Helvetica;
        line-height: 1.6;
        text-align: left;
        white-space: pre;
        -moz-tab-size: 9;
        -o-tab-size: 9;
        tab-size: 8;
        -webkit-hyphens: none;
        -moz-hyphens: none;
        -ms-hyphens: none;
        hyphens: none;
      }

      /* Code blocks */
      pre[class*='smartperf-'] {
        padding: 0.9em;
        overflow: auto;
        border-radius: 2px;
        background: #f5f5f4;
      }

      /* Inline code */
      :not(pre) > code[class*='smartperf-'] {
        white-space: normal;
        background: #fcf8f8;
        padding: 1px 0.2em;
        border-radius: 1px 0.3em;
      }

      .tk.comment,
      .tk.blockquote {
        color: #8c918c;
      }

      .tk.cdata {
        color: #183898;
      }

      .tk.doctype,
      .tk.punctuation,
      .tk.variable,
      .tk.macro.property {
        color: #424242;
      }

      .tk.operator,
      .tk.important,
      .tk.keyword,
      .tk.rule,
      .tk.builtin {
        color: #b71d65;
      }

      .tk.string,
      .tk.url,
      .tk.regex,
      .tk.attr-value {
        color: #16338d;
      }

      .tk.property,
      .tk.number,
      .tk.boolean,
      .tk.entity,
      .tk.atrule,
      .tk.constant,
      .tk.symbol,
      .tk.command,
      .tk.code {
        color: #037aa2;
      }

      .tk.tag,
      .tk.selector,
      .tk.prolog {
        color: #69ad62;
      }

      .tk.function,
      .tk.namespace,
      .tk.pseudo-element,
      .tk.class,
      .tk.class-name,
      .tk.pseudo-class,
      .tk.id,
      .tk.url-reference .tk.variable,
      .tk.attr-name {
        color: #775d9d;
      }

      .tk.entity {
        cursor: help;
      }

      .tk.title,
      .tk.title .tk.punctuation {
        font-weight: bold;
        color: #1a3773;
      }

      .tk.list {
        color: #f56940;
      }

      .tk.inserted {
        background-color: #eaffea;
        color: #509b2f;
      }

      .tk.deleted {
        background-color: #fae1e1;
        color: #ad2d06;
      }

      .tk.bold {
        font-weight: bolder;
      }

      .tk.italic {
        font-style: normal;
      }

      /* JSON */
      .smartperf-json .tk.property {
        color: #19358c;
      }

      .smartperf-markup .tk.tag .tk.punctuation {
        color: #2c2b2b;
      }

      /* CSS */
      code.smartperf-css,
      .smartperf-css .tk.function {
        color: #047ca4;
      }

      /* YAML */
      .smartperf-yaml .tk.atrule {
        color: #609b5a;
      }

      code.smartperf-yaml {
        color: #153491;
      }

      /* Ruby */
      .smartperf-ruby .tk.function {
        color: #3f3e3e;
      }

      /* Markdown */
      .smartperf-markdown .tk.url {
        color: #6e5298;
      }

      /* Makefile */
      .smartperf-makefile .tk.symbol {
        color: #6c5393;
      }

      .smartperf-makefile .tk.variable {
        color: #183488;
      }

      .smartperf-makefile .tk.builtin {
        color: #027ba4;
      }

      /* Bash */
      .smartperf-bash .tk.keyword {
        color: #027fa9;
      }

      /* highlight */
      pre[dl] {
        position: relative;
        padding: 1em 1px 1px 0.9em;
      }

      pre[dl] .line-highlight-wrapper {
        position: absolute;
        top: 1px;
        left: 1px;
        background-color: transparent;
        display: block;
        width: 99%;
      }

      pre[dl] .line-highlight {
        position: absolute;
        left: 1px;
        right: 1px;
        padding: inherit;
        margin-top: 0.9em;
        background: hsla(25, 21%, 50%, 0.08);
        background: linear-gradient(to right, hsla(24, 20%, 50%, 0.1) 70%, hsla(24, 20%, 50%, 0));
        pointer-events: none;
        line-height: inherit;
        white-space: pre;
      }

      pre[dl] .line-highlight:before,
      pre[dl] .line-highlight[data-end]:after {
        content: attr(data-start);
        position: absolute;
        text-shadow: none;
        top: 0.3em;
        left: 0.7em;
        min-width: 0.9em;
        padding: 1px 0.6em;
        background-color: hsla(24, 20%, 47%, 0.4);
        color: hsl(20, 11%, 95%);
        text-align: center;
        vertical-align: 0.2em;
        border-radius: 10000px;
        box-shadow: 1px 2px #fdf6f6;
      }

      pre[dl] .line-highlight[data-end]:after {
        content: attr(data-end);
        top: auto;
        bottom: 0.5em;
      }

      html body {
        line-height: 1.6;
        font-size: 16px;
        color: #333333;
        overflow: initial;
        word-wrap: break-word;
        font-family: Helvetica;
        box-sizing: border-box;
      }

      html body > :first-child {
        margin-top: 0px;
      }

      html body h1,
      html body h2,
      html body h3,
      html body h4,
      html body h5,
      html body h6 {
        margin-top: 1em;
        margin-bottom: 16px;
        color: #000000;
        line-height: 1.2;
      }

      html body h1 {
        font-weight: 300;
        font-size: 2.25em;
        padding-bottom: 0.3em;
      }

      html body h2 {
        font-weight: 410;
        font-size: 1.74em;
        padding-bottom: 0.2em;
      }

      html body h3 {
        font-size: 1.6em;
        font-weight: 501;
      }

      html body h4 {
        font-size: 1.26em;
        font-weight: 601;
      }

      html body h5 {
        font-size: 1.2em;
        font-weight: 601;
      }

      html body h6 {
        font-size: 0.9em;
        font-weight: 601;
      }

      html body h1,
      html body h2,
      html body h3,
      html body h4,
      html body h5 {
        font-weight: 601;
      }

      html body h5 {
        font-size: 0.9em;
      }

      html body h6 {
        color: #5c5c5c;
      }

      html body strong {
        color: #090909;
      }

      html body del {
        color: #525252;
      }

      html body a:not([href]) {
        color: inherit;
        text-decoration: none;
      }

      html body a {
        color: #0192da;
        text-decoration: none;
      }

      html body a:hover {
        color: #029dea;
        text-decoration: none;
      }

      html body img {
        max-width: 99%;
      }

      html body > p {
        margin-top: 1px;
        margin-bottom: 15px;
        word-wrap: break-word;
      }

      html body > ul,
      html body > ol {
        margin-bottom: 15px;
      }

      html body ul,
      html body ol {
        padding-left: 1.9em;
      }

      html body ul.no-list,
      html body ol.no-list {
        padding: 0px;
        list-style-type: none;
      }

      html body ul ul,
      html body ul ol,
      html body ol ol,
      html body ol ul {
        margin-top: 1px;
        margin-bottom: 1px;
      }

      html body li {
        margin-bottom: 1px;
      }

      html body li.task-list-item {
        list-style: none;
      }

      html body li > p {
        margin-top: 1px;
        margin-bottom: 1px;
      }

      html body .task-list-item-checkbox {
        margin: 0 0.3em 0.24em -1.7em;
        vertical-align: middle;
      }

      html body .task-list-item-checkbox:hover {
        cursor: pointer;
      }

      html body blockquote {
        padding: 0.1px 15px 0 0.1px;
        font-size: inherit;
        color: #5c5c5c;
        margin: 16px 0.1px 0 0.1px;
        border-left: 3px solid #cbc9c9;
        background-color: #e8e6e6;
      }

      html body blockquote > :first-child {
        margin-top: 0.2px;
      }

      html body blockquote > :last-child {
        margin-bottom: 0.1px;
      }

      html body hr {
        height: 5px;
        background-color: #cbcaca;
        margin: 32px 0 0.1px 0;
        border: 0 none;
      }

      html body table {
        overflow: auto;
        border-collapse: collapse;
        margin: 15px 0.1px 20px 0.1px;
        border-spacing: 0;
      }

      html body table th {
        font-weight: bold;
        color: #000000;
      }

      html body table td,
      html body table th {
        border: 1px solid #d6d6d6;
        padding: 2px 14px;
      }

      html body dl {
        padding: 0px;
      }

      html body dl dt {
        padding: 0px;
        margin-top: 15px;
        font-size: 0.9em;
        font-style: italic;
        font-weight: bold;
      }

      html body dl dd {
        padding: 0px 17px;
        margin-bottom: 17px;
      }

      html body code {
        font-family: Menlo, Monaco, Consolas, 'Courier New', monospace;
        font-size: 0.86em !important;
        color: #000000;
        background-color: #f0f0f0;
        border-radius: 4px;
        padding: 0.3em 0px;
      }

      html body code::before,
      html body code::after {
        letter-spacing: -0.1em;
        content: '\00a0';
      }

      html body pre > code {
        padding: 1px;
        margin: 0px;
        font-size: 0.86em !important;
        word-break: normal;
        white-space: pre;
        background: transparent;
        border: 0px;
      }

      html body .highlight {
        margin-bottom: 17px;
      }

      html body .highlight pre,
      html body pre {
        padding: 0.9em;
        overflow: auto;
        font-size: 0.86em !important;
        line-height: 1.46;
        border: #d6d6d6;
        border-radius: 4px;
      }

      html body .highlight pre {
        margin-bottom: 0px;
        word-break: normal;
      }

      html body pre code,
      html body pre tt {
        display: inline;
        max-width: initial;
        padding: 1px;
        margin: 1px;
        overflow: initial;
        line-height: inherit;
        word-wrap: normal;
        background-color: transparent;
        border: 1px;
      }

      html body pre code:before,
      html body pre tt:before,
      html body pre code:after,
      html body pre tt:after {
        content: normal;
      }

      html body p,
      html body blockquote,
      html body ul,
      html body ol,
      html body dl,
      html body pre {
        margin-top: 1px;
        margin-bottom: 17px;
      }

      html body kbd {
        color: #000000;
        border: 3px solid #d6d6d6;
        border-bottom: 3px solid #c7c7c7;
        padding: 3px 5px;
        background-color: #f0f0f0;
        border-radius: 2px;
      }

      @media print {
        html body {
          background-color: #ffffff;
        }

        html body h1,
        html body h2,
        html body h3,
        html body h4,
        html body h5,
        html body h6 {
          color: #000000;
          page-break-after: avoid;
        }

        html body blockquote {
          color: #5c5c53;
        }

        html body pre {
          page-break-inside: avoid;
        }

        html body table {
          display: table;
        }

        html body img {
          display: block;
          max-width: 99%;
          max-height: 99%;
        }

        html body pre,
        html body code {
          word-wrap: break-word;
          white-space: pre;
        }
      }

      .smartperf-preview {
        width: 98vw;
        height: 99%;
        box-sizing: border-box;
        overflow: hidden;
        background-color: #fff;
      }

      .smartperf-preview .pagebreak,
      .smartperf-preview .newpage {
        page-break-before: always;
      }

      .smartperf-preview pre.line-numbers {
        position: relative;
        padding-left: 3.7em;
        counter-reset: linenumber;
      }

      .smartperf-preview pre.line-numbers > code {
        position: relative;
      }

      .smartperf-preview pre.line-numbers .line-numbers-rows {
        position: absolute;
        pointer-events: none;
        top: 0.9em;
        font-size: 99%;
        left: 1px;
        width: 3em;
        letter-spacing: -1px;
        border-right: 1px solid #999;
        -webkit-user-select: none;
        -moz-user-select: none;
        -ms-user-select: none;
        user-select: none;
      }

      .smartperf-preview pre.line-numbers .line-numbers-rows > span {
        pointer-events: none;
        display: block;
        counter-increment: linenumber;
      }

      .smartperf-preview pre.line-numbers .line-numbers-rows > span:before {
        content: counter(linenumber);
        color: #999;
        display: block;
        padding-right: 0.79em;
        text-align: right;
      }

      .smartperf-preview .mathjax-exps .MathJax_Display {
        text-align: center !important;
      }

      .smartperf-preview:not([for='preview']) .code-chunk .btn-group {
        display: none;
      }

      .smartperf-preview:not([for='preview']) .code-chunk .status {
        display: none;
      }

      .smartperf-preview:not([for='preview']) .code-chunk .output-div {
        margin-bottom: 16px;
      }

      .scrollbar-style::-webkit-scrollbar {
        width: 8px;
      }

      .scrollbar-style::-webkit-scrollbar-track {
        border-radius: 9px;
        background-color: transparent;
      }

      .scrollbar-style::-webkit-scrollbar-thumb {
        border-radius: 6px;
        background-color: rgba(150, 150, 150, 1);
        border: 4px solid rgba(150, 150, 150, 1);
        background-clip: content-box;
      }

      html body[for='html-export']:not([dpm]) {
        position: relative;
        width: 99%;
        height: 99%;;
        overflow: auto;
      }

      html body[for='html-export']:not([dpm]) .smartperf-preview {
        position: relative;
        top: 1px;
      }

      @media screen and (min-width: 914px) {
        html body[for='html-export']:not([dpm]) .smartperf-preview {
          padding: 2em;
        }
      }

      @media screen and (max-width: 914px) {
        html body[for='html-export']:not([dpm]) .smartperf-preview {
          padding: 1.9em;
        }
      }

      @media screen and (max-width: 450px) {
        html body[for='html-export']:not([dpm]) .smartperf-preview {
          font-size: 15px !important;
          padding: 1.1em;
        }
      }

      @media print {
        html body[for='html-export']:not([dpm]) #sidebar-toc-btn {
          display: none;
        }
      }

      html body[for='html-export']:not([dpm]) #sidebar-toc-btn {
        position: fixed;
        bottom: 9px;
        left: 9px;
        font-size: 28px;
        cursor: pointer;
        color: inherit;
        z-index: 99;
        width: 31px;
        text-align: center;
        opacity: 0.5;
      }

      html body[for='html-export']:not([dpm])[hsst] #sidebar-toc-btn {
        opacity: 1;
      }

      html body[for='html-export']:not([dpm])[hsst] .md-sidebar-toc {
        position: fixed;
        top: 1px;
        left: 1px;
        width: 300px;
        height: 99%;
        padding: 32px 0 48px 0;
        font-size: 14px;
        box-shadow: 1px 1px 4px rgba(150, 150, 150, 0.33);
        box-sizing: border-box;
        overflow: auto;
        background-color: inherit;
      }

      html body[for='html-export']:not([dpm])[hsst] .md-sidebar-toc::-webkit-scrollbar {
        width: 9px;
      }

      html body[for='html-export']:not([dpm])[hsst] .md-sidebar-toc::-webkit-scrollbar-track {
        border-radius: 11px;
        background-color: transparent;
      }

      html body[for='html-export']:not([dpm])[hsst] .md-sidebar-toc::-webkit-scrollbar-thumb {
        border-radius: 6px;
        background-color: rgba(150, 150, 150, 0.66);
        border: 3px solid rgba(150, 150, 150, 0.66);
        background-clip: content-box;
      }

      html body[for='html-export']:not([dpm])[hsst] .md-sidebar-toc a {
        text-decoration: none;
      }

      html body[for='html-export']:not([dpm])[hsst] .md-sidebar-toc ul {
        padding: 1px 1.7em;
        margin-top: 0.9em;
      }

      html body[for='html-export']:not([dpm])[hsst] .md-sidebar-toc li {
        margin-bottom: 0.8em;
      }

      html body[for='html-export']:not([dpm])[hsst] .md-sidebar-toc ul {
        list-style-type: none;
      }

      html body[for='html-export']:not([dpm])[hsst] .smartperf-preview {
        left: 301px;
        width: calc(100% - 300px);
        padding: 2em calc(50% - 457px - 150px);
        margin: 1px;
        box-sizing: border-box;
      }

      @media screen and (max-width: 1274px) {
        html body[for='html-export']:not([dpm])[hsst] .smartperf-preview {
          padding: 1.9em;
        }
      }

      @media screen and (max-width: 450px) {
        html body[for='html-export']:not([dpm])[hsst] .smartperf-preview {
          width: 99%;
        }
      }

      html body[for='html-export']:not([dpm]):not([hsst]) .md-sidebar-toc {
        display: none;
      }
    </style>
  </head>
  <body for="html-export" id="body" style="margin:0">
    <div class="smartperf smartperf-preview" style="min-height: 99vh;">
      <h1 class="mume-header fontColor">Trace解析能力增强</h1>

      <p class="fontColor">Trace解析能力增强主要是提高Trace的解析能力。</p>
      <h3 class="mume-header fontColor" id="header-index-1">焦点问题trace切割,选择焦点trace,聚焦问题发生时间范围,单独打开</h3>

      <p class="fontColor">
        焦点问题切割是将现有的trace加载到界面时,对指定时间进行框选,截取框选时间范围内的trace数据通过跳转的方式去打开新的trace界面,新界面的trace数据就是按照这段时间范围去切割的。如下图框选一段时间范围,点击右上方的小剪刀图标对框选时间范围数据进行剪切。
        <br />
        <img src="../figures/parsingability/cuttrace_bytime.jpg" alt="GitHub Logo" />
      </p>
      <h3 class="mume-header fontColor" id="header-index-2">超大trace分段打开,超大trace按照固定大小切割,分段打开显示</h3>

      <p class="fontColor">
        超大trace分段打开是对现有配置抓取的同一种时钟源数据源的。也就是配置命令下发的抓取有效。Htrace数据按照端侧切割的大小分成多个文件,并将不能切割的hiperf、ebpf、arkts的数据单独存储。IDE通过将这几种源文件数据存储在IndexedDB,并调用trace
        streamer去进行切割数据,并在IDE侧过滤筛选出切割的数据进行展示。
      </p>
      <h4 class="mume-header fontColor">超大trace浏览器用户数据目录配置说明</h4>

      <p class="fontColor">
        由于大文件切割的数据是保存在浏览器的IndexedDb中,默认存储在系统盘,所以需要修改用户目录数据存放位置。
      </p>
      <h5 class="mume-header fontColor">
        找到浏览器的exe执行文件位置(或者浏览器exe的快捷方式位置), 在cmd窗口执行以下命令(edge浏览器)
      </h5>

      <pre class="smartperf-text fontColor light">
D:\deskTop\msedge.exe.lnk --user-data-dir=D:\Edgedata
	D:\deskTop\msedge.exe.lnk    浏览器的exe执行文件位置(或者浏览器exe的快捷方式位置)
	--user-data-dir=D:\Edgedata   指定用户目录数据位置,本地除系统盘外的位置都可以,内存尽量大一点
</pre
      >
      <h5 class="mume-header fontColor">浏览器exe或者exe快捷方式目录和名称不能有带空格</h5>

      <pre class="smartperf-text fontColor light">
错误:D:\desk Top\Microsoft Edge.exe.lnk --user-data-dir=D:\Edgedata
正确:D:\deskTop\MicrosoftEdge.exe.lnk --user-data-dir=D:\Edgedata
</pre
      >
      <h5 class="mume-header fontColor">配置完成后, 查看【用户配置路径】是否是配置的路径</h5>

      <pre class="smartperf-text fontColor light">
edge浏览器:     edge://version/
</pre
      >
      <h4 class="mume-header fontColor">超大trace抓取配置说明</h4>

      <p class="fontColor"><img src="../figures/parsingability/bigtracerecord.jpg" alt="GitHub Logo" /></p>
      <ul class="fontColor">
        <li>
          <pre class="smartperf-text fontColor light">
Long Trace Mode: 超大trace抓取模式。
</pre
          >
        </li>
        <li>
          <pre class="smartperf-text fontColor light">
Single file max size: trace文件分割的大小。
</pre
          >
        </li>
      </ul>
      <h4 class="mume-header fontColor">本地导入超大trace</h4>

      <p class="fontColor">
        本地导入超大trace是导入文件夹,将该文件夹中所有文件导入。如下图从Open long trace file入口导入。
        <br />
        <img src="../figures/parsingability/longtraceload.jpg" alt="GitHub Logo" />
        <br />
        本地导入以后,点击右上方的切页图标可以切页。
        <br />
        <img src="../figures/parsingability/longtraceswitch.jpg" alt="GitHub Logo" />
      </p>
      <h3 class="mume-header fontColor" id="header-index-2-1">LongTrace Adapter —— 多分片 LongTrace NativeHook 数据后台预处理</h3>

      <p class="fontColor">
        当打开包含多个分片的 LongTrace 文件时,如果分片中包含 NativeHook 数据(如 Native Memory 采集),后续分片需要依赖前序分片的公共上下文(符号表、线程映射、统计事件等)才能正确解析。LongTrace Adapter 功能通过扩展服务在后台自动完成这些预处理工作,用户打开文件后第一页即可立即查看,其余页会随后台处理完成逐步解锁。
      </p>
      <h4 class="mume-header fontColor">前提条件</h4>

      <p class="fontColor">
        使用此功能需要确保<a href="#" onclick="window.parent.postMessage({type: 'navigate_help_doc', index: '27', event: 'extensions', docName: 'extensions'}, '*'); return false;">扩展服务(Extension Service)</a>已启动并正常运行。如果扩展服务不可用,系统会自动降级为本地直接解析模式,所有页面仍然可以打开,但包含 NativeHook 数据的后续分片可能出现符号化信息缺失。
      </p>
      <h4 class="mume-header fontColor">导入多分片 LongTrace 文件</h4>

      <p class="fontColor">
        从 Open long trace file 入口导入包含多个分片的 LongTrace 文件夹。导入的文件夹中应包含按序编号的 <code>.htrace</code> 分片文件(如 <code>hiprofiler_data_20260101_000001_1.htrace</code><code>hiprofiler_data_20260101_000001_2.htrace</code> ...),以及可能存在的特殊类型文件(arkts、ebpf、hiperf)。
      </p>
      <h4 class="mume-header fontColor">后台预处理与页面逐步解锁</h4>

      <p class="fontColor">
        导入多分片文件后,第一页数据会立即加载显示,其余页码会处于锁定状态(灰显且不可点击),表示正在后台预处理中。
      </p>
      <p class="fontColor">
        界面顶部的进度条会显示当前预处理进度和已完成的文件数。随着后台处理逐步完成,对应的页码会自动解锁变为可点击状态。
      </p>
      <p class="fontColor">
        当某个页面尚未就绪时点击该页码,界面会提示 "Extension service converting, page N not ready",需要等待预处理完成后再切换。
      </p>
      <h4 class="mume-header fontColor">预处理完成后切换页面</h4>

      <p class="fontColor">
        所有页面预处理完成后(进度条消失),即可通过点击页码、前后翻页按钮或输入页码自由切换到任意页面查看数据。包含 NativeHook 数据的页面会自动应用补丁,确保符号表、线程映射等上下文信息完整。
      </p>
      <h4 class="mume-header fontColor">降级说明</h4>

      <p class="fontColor">
        在以下情况下,系统会自动降级为本地解析模式,所有页面直接可用:
      </p>
      <ul class="fontColor">
        <li>
          只有单个分片文件的 LongTrace(无需跨页预处理)。
        </li>
        <li>
          扩展服务未启动或连接失败。
        </li>
        <li>
          预处理过程中发生异常。
        </li>
      </ul>
      <p class="fontColor">
        降级后的行为与不使用 LongTrace Adapter 时一致,不影响基本的 LongTrace 分页浏览功能。
      </p>

      <h3 class="mume-header fontColor" id="header-index-3">web端支持已打开的trace文件转换成systrace,并可下载</h3>

      <p class="fontColor">
        已打开的trace界面,增加convert to systrace按钮,支持将htrace和row trace转为systrace。
        <br />
        <img src="../figures/parsingability/traceconvert.jpg" alt="GitHub Logo" />
      </p>
      <h3 class="mume-header fontColor" id="header-index-4">
        tracestreamer离线执行sql和metrics语句,对标trace_processor_shell –q和—run-metrics
      </h3>

      <p class="fontColor">
        trace_streamer_shell
        –q可以直接将sql查询结果显示在命令行里,如下图bytrace.ftrace是需要解析的文件,a.txt是sql语句。
        <br />
        <img src="../figures/parsingability/tracestreamer_q.jpg" alt="GitHub Logo" />
        <br />
        trace_streamer_shell
        –m可以直接将metric接口的查询结果显示在命令行里,如下图bytrace.ftrace是需要解析的文件,trace_stats是metric接口名。
        <br />
        <img src="../figures/parsingability/tsmetric.jpg" alt="GitHub Logo" />
      </p>

      <h3 class="mume-header fontColor" id="header-index-5">
        Hangs抓取和展示说明
      </h3>
      <p class="fontColor">
        挂起(hang)是离散用户交互中的明显延迟,并且它几乎总是主线程上长时间运行工作的结果。
        仅当主线程在大约 50 毫秒到 100 毫秒或更长时间内无响应时,离散交互延迟才会开始变得明显。
      </p>
      <h4 class="mume-header fontColor">Hangs的抓取</h4>
      <h4 class="mume-header fontColor">Hangs抓取配置参数</h4>
      <p class="fontColor">
        进入Probes config页面,打开Record mode开关,勾选notification可以抓取Hangs数据(此选项为默认勾选)。
      </p>
      <br />
      <img src="../figures/parsingability/hangsrecord.jpg" alt="GitHub Logo" />
      <p class="fontColor">
        解析时需要打开Flags页面的Hangs Detection开关(Disabled切换为Enabled)。
      </p>
      <br />
      <img src="../figures/parsingability/hangsdetection.jpg" alt="GitHub Logo" />
      <h4 class="mume-header fontColor">Hangs展示说明</h4>
      <p class="fontColor">
        将抓取的trace文件导入到smartperf工具中,查看挂起的情况。
      </p>
      <h4 class="mume-header fontColor">泳道图展示</h4>
      <img src="../figures/parsingability/hangstrace.jpg" alt="GitHub Logo" />
      <h4 class="mume-header fontColor">类型说明</h4>
      <img src="../figures/parsingability/hangsttype.jpg" alt="GitHub Logo" />
      <p class="fontColor">
        点击Hangs Detection开关下的选项可以选择展示的不同类型。
      </p>
      <p class="fontColor">
        根据duration大小将hang划分为4个type,即Instant、Circumstantial、Micro、Severe。4个type分别对应时长为
        33ms&lt;d&lt;100ms、100ms&le;d&lt;250ms、250ms&le;d&lt;500ms、500ms&le;d。
      </p>
      <p class="fontColor">
        颜色按type由浅及深:Instant蓝色、Circumstantial黄色、Micro橙色、Severe红色。
      </p>
      <p class="fontColor">
        选择不同类型展示出的泳道会不一样: 选择Instant会显示Instant、Circumstantial、Micro、Severe,如图一;
        选择Circumstantial则显示Circumstantial、Micro、Severe,如图二,以此类推。
      </p>
      <img src="../figures/parsingability/Instant.jpg" alt="GitHub Logo" />
      <p class="fontColor">
        图一
      </p>
      <img src="../figures/parsingability/Circumstantial.jpg" alt="GitHub Logo" />
      <p class="fontColor">
        图二
      </p>
      <h4 class="mume-header fontColor">Hangs泳道图的点选功能</h4>
      <p class="fontColor">
        可以对hangs的各个slice进行点选,点选后在最下方的弹出层中会展示点选数据的统计的tab页。点击Hang type右侧蓝色箭头,会跳转到该hang对应的trace点。
      </p>
      <img src="../figures/parsingability/hangdetails.jpg" alt="GitHub Logo" />
      <br />
      <img src="../figures/parsingability/hangname.jpg" alt="GitHub Logo" />
      <p class="fontColor">
        Trace点的name依次对应tab页的Sender tid、Send time、Expect handle time、Task name/ID、Prio、Sender。
      </p>
      <ul class="fontColor">
        <li>
          <pre class="smartperf-text fontColor light">
StartTime(Relative):开始时间(相对时间)。
</pre>
        </li>
        <li>
          <pre class="smartperf-text fontColor light">
StartTime(Absolute):开始时间(绝对时间)。
</pre>
        </li>
        <li>
          <pre class="smartperf-text fontColor light">
Duration:持续时间。
</pre>
        </li>
        <li>
          <pre class="smartperf-text fontColor light">
Hang Type:挂起类型。
</pre>
        </li>
        <li>
          <pre class="smartperf-text fontColor light">
Sender tid:发送event的线程ID。
</pre>
        </li>
        <li>
          <pre class="smartperf-text fontColor light">
Send time:事件发送时间。
</pre>
        </li>
        <li>
          <pre class="smartperf-text fontColor light">
Expect handle time:期望事件开始时间。
</pre>
        </li>
        <li>
          <pre class="smartperf-text fontColor light">
Task name/Id:事件名/事件ID。
</pre>
        </li>
        <li>
          <pre class="smartperf-text fontColor light">
Prio:优先级。
</pre>
        </li>
        <li>
          <pre class="smartperf-text fontColor light">
Sender:发送者。
</pre>
        </li>
      </ul>
      <h4 class="mume-header fontColor">Hangs泳道图的框选功能</h4>
      <p class="fontColor">
        框选Hangs的泳道图,展示Hangs的tab页,右侧第一个下拉框可以选择类型,也能根据process ,sender去搜索。
      </p>
      <img src="../figures/parsingability/hangstab.jpg" alt="GitHub Logo" />
      <ul class="fontColor">
        <li>
          <pre class="smartperf-text fontColor light">
StartTime:开始时间。
</pre>
        </li>
        <li>
          <pre class="smartperf-text fontColor light">
Duration:持续时间。
</pre>
        </li>
        <li>
          <pre class="smartperf-text fontColor light">
Hang Type:挂起类型。
</pre>
        </li>
        <li>
          <pre class="smartperf-text fontColor light">
Process:进程名。
</pre>
        </li>
        <li>
          <pre class="smartperf-text fontColor light">
Sender tid:发送event的线程ID。
</pre>
        </li>
        <li>
          <pre class="smartperf-text fontColor light">
Send time:事件发送时间。
</pre>
        </li>
        <li>
          <pre class="smartperf-text fontColor light">
Expect handle time:期望事件开始时间。
</pre>
        </li>
        <li>
          <pre class="smartperf-text fontColor light">
Task name/Id:事件名/事件ID。
</pre>
        </li>
        <li>
          <pre class="smartperf-text fontColor light">
Prio:优先级。
</pre>
        </li>
        <li>
          <pre class="smartperf-text fontColor light">
Sender:发送者。
</pre>
        </li>
      </ul>
      <p class="fontColor">
        框选Hangs的泳道图,展示Summary的tab页。
      </p>
      <img src="../figures/parsingability/Summary.jpg" alt="GitHub Logo" />
      <ul class="fontColor">
        <li>
          <pre class="smartperf-text fontColor light">
Type/Process/Hang:根据类型显示挂起情况。
</pre>
        </li>
        <li>
          <pre class="smartperf-text fontColor light">
Count:各类型的数量。
</pre>
        </li>
      </ul>
      <h4 class="mume-header fontColor">Hangs归一化泳道</h4>
      <p class="fontColor">
        为了方便查看hangs数据,对不同进程下的hangs泳道进行了归一化处理
      </p>
      <img src="../figures/parsingability/normalization.jpg" alt="GitHub Logo" />
    </div>

    <script>
      window.onload = () => {
        let isDark = getURLParameter('dark'); 
        let targetId = getURLParameter('targetId'); 
        let isBack = getURLParameter('isBack'); 
        if (isDark === 'true') {
          document.getElementById('body').setAttribute('style', 'background-color:#272C34;');
          let header = document.getElementsByClassName('fontColor');
          for (let i = 0; i < header.length; i++) {
            header[i].style.color = '#fff';
          }
          let lightBackGround = document.getElementsByClassName('light');
          for (let i = 0; i < lightBackGround.length; i++) {
            lightBackGround[i].style.backgroundColor = '#32373F';
          }
        }
        function getURLParameter(name) {  
          return (new URL(document.location)).searchParams.get(name);  
        }  
  
        if ( targetId !== null ) {
          let targetElement = document.getElementById(targetId);
          targetElement.scrollIntoView({ behavior: 'smooth' });
        }
      };
    </script>
  </body>
</html>