From 435b3e9ef1d04947c6427103965842a2f3d3efe7 Mon Sep 17 00:00:00 2001 From: luyuxuan418 Date: Mon, 22 Jan 2024 11:45:16 +0800 Subject: [PATCH 1/3] =?UTF-8?q?=E5=B8=AE=E5=8A=A9=E6=96=87=E6=A1=A3?= =?UTF-8?q?=E4=BF=AE=E6=94=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: luyuxuan418 --- README_zh.md | 2 +- ide/src/doc/md/des_tables.md | 48 +++++++++--------- ide/src/doc/md/quickstart_ability_monitor.md | 6 ++- ide/src/doc/md/quickstart_arkts.md | 6 +-- ide/src/doc/md/quickstart_bio.md | 8 +-- ide/src/doc/md/quickstart_device_record.md | 30 +++++------ ide/src/doc/md/quickstart_filesystem.md | 19 ++++--- ide/src/doc/md/quickstart_hiperf.md | 15 +++--- ide/src/doc/md/quickstart_hisystemevent.md | 2 +- ide/src/doc/md/quickstart_native_memory.md | 7 +-- ide/src/doc/md/quickstart_page_fault.md | 10 ++-- ide/src/doc/md/quickstart_parsing_ability.md | 2 +- ide/src/doc/md/quickstart_sql_metrics.md | 2 +- ide/src/doc/md/quickstart_systemtrace.md | 4 +- ide/src/doc/md/quickstart_web_record.md | 19 +++---- ide/src/doc/quickstart_bio.html | 10 ++-- ide/src/doc/quickstart_device_record.html | 4 +- ide/src/doc/quickstart_filesystem.html | 20 +++++++- ide/src/doc/quickstart_hiperf.html | 26 ++++++++-- ide/src/doc/quickstart_page_fault.html | 4 +- .../figures/FileSystem/FileSystemOptions.jpg | Bin 84978 -> 53887 bytes .../FileSystem/FileSystemstatistics.jpg | Bin 88322 -> 45234 bytes ide/src/figures/hdc/hdc.jpg | Bin 10062 -> 7498 bytes ide/src/figures/perf/Options.jpg | Bin 136252 -> 103706 bytes ide/src/figures/perf/PerfProfile.jpg | Bin 93358 -> 93827 bytes ide/src/figures/perf/Samplelist.jpg | Bin 174714 -> 116624 bytes ide/src/figures/perf/datamining.jpg | Bin 67546 -> 104872 bytes ide/src/figures/perf/flame.jpg | Bin 113829 -> 102824 bytes ide/src/figures/perf/flameshow.jpg | Bin 119305 -> 124470 bytes ide/src/figures/perf/heaviesttrace1.jpg | Bin 104381 -> 102823 bytes ide/src/figures/perf/inputfilter.jpg | Bin 112016 -> 99802 bytes ide/src/figures/perf/samplecounter.jpg | Bin 99825 -> 102220 bytes ide/src/figures/perf/summary.jpg | Bin 56772 -> 110187 bytes 33 files changed, 148 insertions(+), 96 deletions(-) diff --git a/README_zh.md b/README_zh.md index b01b7e41e..a69806f90 100644 --- a/README_zh.md +++ b/README_zh.md @@ -53,7 +53,7 @@ PC端以Smartperf_Host网站的形式进行发布，内部分为Trace Streamer ### Bio抓取 使用Smartperf_Host抓取每次IO访问的起始时间、总延迟、进程、每4k数据的平均延迟、线程、操作（写数据、页面换入、Metadata）、访问量、路径等、Block number、优先级、Backtrace调用栈，详见《[Bio的抓取和展示说明](./ide/src/doc/md/quickstart_bio.md)》。 ### 进程Smaps抓取 -使用Smartperf_Host抓取单个进程的smaps数据（类别、Pss、Rss、Vss等），数据源为/proc/$pid/smaps，详见《[进程smaps的抓取和展示说明](./ide/src/doc/md/quickstart_smaps.md)》。 +使用Smartperf_Host抓取单个进程的smaps数据（类别、Pss、Rss、Vss等），数据源为/proc/$pid/smaps，详见《[进程smaps的抓取和展示说明](./ide/src/doc/md/quickstart_memory_template.md)》。 ### Sql分析和Metrics说明 Smartperf_Host网站trace解析完成后在线数据库使用说明，详见《[Sql分析和Metrics说明](./ide/src/doc/md/quickstart_sql_metrics.md)》。 ## 发行版指南 diff --git a/ide/src/doc/md/des_tables.md b/ide/src/doc/md/des_tables.md index 747e49801..40dff9d40 100644 --- a/ide/src/doc/md/des_tables.md +++ b/ide/src/doc/md/des_tables.md @@ -270,7 +270,7 @@ log 表记录日志信息。可以根据 seq 字段的连续性，来判断是 frame_slice: 记录 RS(RenderService)和应用的帧渲染。 gpu_slice: 记录 RS 的帧对应的 gpu 渲染时长。 -frame_maps:记录应用到 RS 的帧的映射关系。 +frame_maps: 记录应用到 RS 的帧的映射关系。 ![GitHub Logo](../../figures/traceStreamer/frames.jpg) ### 查询示例 @@ -290,10 +290,10 @@ js_heap_files：记录 js 内存数据的文件名和文件索引 ![1683163158954](image/des_tables/js_heap_files.png) -js_heap_nodes:记录 js 内存类对象数据 -js_heap_edges:记录 js 内存类对象的成员数据 -js_heap_trace_node:记录 timeline 的调用栈信息 -js_heap_sample:记录 timeline 的时间轴信息 +js_heap_nodes: 记录 js 内存类对象数据 +js_heap_edges: 记录 js 内存类对象的成员数据 +js_heap_trace_node: 记录 timeline 的调用栈信息 +js_heap_sample: 记录 timeline 的时间轴信息 ![1683163373206](image/des_tables/js_heap_nodes.png) ## TraceStreamer 输出数据库表格详细介绍 @@ -765,13 +765,13 @@ js_heap_sample:记录 timeline 的时间轴信息 #### 相关字段描述 -- pid:目标进程 ID。 -- type:JS 数据类型，取值与枚举 HeapType 对应，0 表示 JS 内存数据为 snapshot 类型，1 表示 JS 内存数据为 timeline 类型，-1 表示没有 JS 内存数据。 -- interval:当 type=0 时生效，单位是秒，表示一次 snapshot 事件和下一次 snapshot 事件之间的间隔。 -- capture_numeric_value:当 type=0 时生效，表示是否同时抓取 numeric。 -- track_allocation:当 type=1 时生效，表示是否抓取 allocations。 -- enable_cpu_profiler:表示是否存在 cpuprofiler 的数据。 -- cpu_profiler_interval:表示 cpuprofiler 数据的采集间隔。 +- pid: 目标进程 ID。 +- type: JS 数据类型，取值与枚举 HeapType 对应，0 表示 JS 内存数据为 snapshot 类型，1 表示 JS 内存数据为 timeline 类型，-1 表示没有 JS 内存数据。 +- interval: 当 type=0 时生效，单位是秒，表示一次 snapshot 事件和下一次 snapshot 事件之间的间隔。 +- capture_numeric_value: 当 type=0 时生效，表示是否同时抓取 numeric。 +- track_allocation: 当 type=1 时生效，表示是否抓取 allocations。 +- enable_cpu_profiler: 表示是否存在 cpuprofiler 的数据。 +- cpu_profiler_interval: 表示 cpuprofiler 数据的采集间隔。 ### js_cpu_profiler_node 表 @@ -796,14 +796,14 @@ js_heap_sample:记录 timeline 的时间轴信息 #### 相关字段描述 - function_id: 函数的 ID 号。 -- function_index:函数名称在 data_dict 中的索引号。 -- script_id:关联到的类对象所在文件的绝对路径 ID。 -- url_index:关联到的类对象所在文件的绝对路径名称在 data_dict 中的索引号。 -- line_number:类对象所在文件的行号。 -- column_number:类对象所在文件的列号。 -- hit_count:采样次数。 -- children:子节点的 id 号。 -- parent_id:父节点的 id 号。 +- function_index: 函数名称在 data_dict 中的索引号。 +- script_id: 关联到的类对象所在文件的绝对路径 ID。 +- url_index: 关联到的类对象所在文件的绝对路径名称在 data_dict 中的索引号。 +- line_number: 类对象所在文件的行号。 +- column_number: 类对象所在文件的列号。 +- hit_count: 采样次数。 +- children: 子节点的 id 号。 +- parent_id: 父节点的 id 号。 ### js_cpu_profiler_sample 表 @@ -824,10 +824,10 @@ js_heap_sample:记录 timeline 的时间轴信息 #### 相关字段描述 - id: ts 内部 ID 号。 -- function_id:函数的 ID 号。 -- start_time:数据上报的起始时间。 -- end_time:数据上报的终止时间。 -- dur:数据上报的间隔时间。 +- function_id: 函数的 ID 号。 +- start_time: 数据上报的起始时间。 +- end_time: 数据上报的终止时间。 +- dur: 数据上报的间隔时间。 ### js_heap_edges 表 diff --git a/ide/src/doc/md/quickstart_ability_monitor.md b/ide/src/doc/md/quickstart_ability_monitor.md index e0325ef11..4a448988b 100644 --- a/ide/src/doc/md/quickstart_ability_monitor.md +++ b/ide/src/doc/md/quickstart_ability_monitor.md @@ -15,7 +15,7 @@ ![GitHub Logo](../../figures/AbilityMonitor/abilitysetting.jpg) 点击 Trace command，就会根据上面的配置生成抓取命令，点击复制按钮，会将命令行复制。 ![GitHub Logo](../../figures/AbilityMonitor/abilitycommand.jpg) -输入 hdc_shell，进入设备，执行命令。 +输入 hdc shell，进入设备，执行命令。 ![GitHub Logo](../../figures/AbilityMonitor/abilityexcutecommand.jpg) 进入指定目录，cd /data/local/tmp 进入到目录，会看到生成的 trace 文件。 ![GitHub Logo](../../figures/AbilityMonitor/abilityhtrace.jpg) @@ -43,6 +43,10 @@ Ability Monitor 展开就可以看到泳道图，包括 CPU，内存，磁盘 IO - Network Bytes Out/Sec： 每秒发送的网络数据字节数。 - Network Packets In/Sec：每秒接收的网络数据包数。 - Network Packets Out/Sec： 每秒发送的网络数据包数。 +- Purgeable Total： 可清除总量。 +- Purgeable Pin：可清除编码。 +- DMA：直接内存存取。 +- Skia Gpu Memory：Skia显存。 ### Ability Monitor 泳道图的框选功能 diff --git a/ide/src/doc/md/quickstart_arkts.md b/ide/src/doc/md/quickstart_arkts.md index c5c40238e..e47cb29c5 100644 --- a/ide/src/doc/md/quickstart_arkts.md +++ b/ide/src/doc/md/quickstart_arkts.md @@ -20,7 +20,7 @@ Cpuprofiler 模板帮助 ArkTs 开发和测试分析虚拟机层执行开销大 ![GitHub Logo](../../figures/arkts/cpuprofilertip.jpg) - Name : 函数名。 -- Self Time: 函数自身执行时间(不包含其调用者)。 +- Self Time : 函数自身执行时间(不包含其调用者)。 - Total Time : 函数自身及调用者的调用时间总和。 - Url : 函数所在的文件名称。 @@ -38,13 +38,13 @@ Js Profiler Statistics 的 Tab 页显示数据的维度信息，以饼图和 Tab ![GitHub Logo](../../figures/arkts/cpuprofilerselectc.jpg) ![GitHub Logo](../../figures/arkts/cpuprofilerdragc.jpg) - Symbol : 函数名。 -- Self Time: 函数自身执行时间(不包含其调用者)。 +- Self Time : 函数自身执行时间(不包含其调用者)。 - Total Time : 函数自身及调用者的调用时间总和。 Js Profiler BottomUp 的 Tab 页把 name，url，depth，parent 相同的函数合并，构建成一个 bottom up 的树结构，以树形表格的形式显示，只不过作为根节点的是被调用者，表格中显示函数被调用关系，如下图： ![GitHub Logo](../../figures/arkts/cpuprofilerselectb.jpg) ![GitHub Logo](../../figures/arkts/cpuprofilerdragb.jpg) - Symbol : 函数名。 -- Self Time: 函数自身执行时间(不包含其调用者)。 +- Self Time : 函数自身执行时间(不包含其调用者)。 - Total Time : 函数自身及调用者的调用时间总和。 ### Cpuprofiler 的 Heaviest Stack 功能 diff --git a/ide/src/doc/md/quickstart_bio.md b/ide/src/doc/md/quickstart_bio.md index 4862bc402..ac305257e 100644 --- a/ide/src/doc/md/quickstart_bio.md +++ b/ide/src/doc/md/quickstart_bio.md @@ -45,7 +45,7 @@ Disk I/O Tier Statistics 的 Tab 页如图： - Min Total Latency：最小延迟时间。 - Avg Total Latency：平均延迟时间。 - Max Total Latency：最大延迟时间。 - Disk I/O Latency Calltree 的 Tab 页如图： + Disk I/O Latency CallTree 的 Tab 页如图： ![GitHub Logo](../../figures/Bio/BioCalltree.jpg) - Call Stack：为经过符号解析后的Callstack，并且给出动态链接库或者进程名的信息。 - Local：为该调用方法自身占用的CPU时间。 @@ -66,7 +66,7 @@ Disk I/O Tier Statistics 的 Tab 页如图： ### Bio 支持多种 Options 展示风格 -点击 Disk I/O Latency Calltree 的 Tab 页底部的 Options，会有两个 CheckBox 复选框。 +点击 Disk I/O Latency CallTree 的 Tab 页底部的 Options，会有两个 CheckBox 复选框。 ![GitHub Logo](../../figures/Bio/BioOptions.jpg) - Invert：反向输出调用树。 @@ -74,7 +74,7 @@ Disk I/O Tier Statistics 的 Tab 页如图： ### Bio 支持过滤调用栈调用次数的展示风格 -点击 Disk I/O Latency Calltree 的 Tab 页底部的 Sample Counter Filter，可以填上区间值。过滤出符合该区间值调用次数的调用栈信息。 +点击 Disk I/O Latency CallTree 的 Tab 页底部的 Sample Count Filter，可以填上区间值。过滤出符合该区间值调用次数的调用栈信息。 ![GitHub Logo](../../figures/Bio/Biocounter.jpg) ### Bio 功能的调用栈 Group 展示-数据分析支持剪裁功能 @@ -103,7 +103,7 @@ Disk I/O Tier Statistics 的 Tab 页如图： ### Bio 的火焰图功能 -点击 Disk I/O Latency Calltree 左下角的柱状图的图标，会切换到火焰图页面。 +点击 Disk I/O Latency CallTree 左下角的柱状图的图标，会切换到火焰图页面。 ![GitHub Logo](../../figures/Bio/Bioflame.jpg) 进入到火焰图页面，火焰图的展示跟 Callinfo 的 tab 页的调用栈显示一致，鼠标放到色块上，悬浮框可以显示调用栈名称和 Duration 时长。 ![GitHub Logo](../../figures/Bio/Bioflameshow.jpg) diff --git a/ide/src/doc/md/quickstart_device_record.md b/ide/src/doc/md/quickstart_device_record.md index f072110f8..9a1f750a7 100644 --- a/ide/src/doc/md/quickstart_device_record.md +++ b/ide/src/doc/md/quickstart_device_record.md @@ -7,15 +7,15 @@ ![GitHub Logo](../../figures/hiprofilercmd/systraceconfig.jpg) 说明： -- Record setting:设置 trace 的抓取模式，buffer size 大小，抓取时长。 -- Trace command:生成的抓取命令行。 -- Probes config:trace 的抓取参数配置。 -- Native Memory:NativeMemory 数据的抓取参数配置。 -- Hiperf:Hiperf 数据的抓取参数配置。 -- eBPF Config:ebpf 数据的抓取参数配置。 -- VM Tracker:smaps 数据的抓取参数配置。 -- HiSystemEvent:HiSystemEvent 数据抓取参数配置。 -- SDK Config:SDK 数据抓取参数配置。 +- Record setting: 设置 trace 的抓取模式，buffer size 大小，抓取时长。 +- Trace command: 生成的抓取命令行。 +- Probes config: trace 的抓取参数配置。 +- Native Memory: NativeMemory 数据的抓取参数配置。 +- Hiperf: Hiperf 数据的抓取参数配置。 +- eBPF Config: ebpf 数据的抓取参数配置。 +- VM Tracker: Smaps数据的抓取参数配置。 +- HiSystemEvent: HiSystemEvent 数据抓取参数配置。 +- SDK Config: SDK 数据抓取参数配置。 ## 命令行的生成和 trace 文件的抓取 @@ -27,12 +27,12 @@ ![GitHub Logo](../../figures/hiprofilercmd/command.jpg) 命令参数说明： -- -o:文件的输入路径和名称。 -- -t:抓取的时长。 -- buffer pages:buffer size 大小。 -- sample_duration:数据采集的时间。 -- sample_interval:主动获取插件数据的间隔时间（ms，只针对轮询插件，例如 memory 插件，cpu 插件，dikio 插件等，对流式插件和独立插件无效）。 -- trace_period_ms:ftrace 插件读取内核缓冲区数据的间隔时间（ms）。 +- -o: 文件的输入路径和名称。 +- -t: 抓取的时长。 +- buffer pages: buffer size 大小。 +- sample_duration: 数据采集的时间。 +- sample_interval: 主动获取插件数据的间隔时间（ms，只针对轮询插件，例如 memory 插件，cpu 插件，dikio 插件等，对流式插件和独立插件无效）。 +- trace_period_ms: ftrace 插件读取内核缓冲区数据的间隔时间（ms）。 - hitrace_time:hitrace 命令行抓取时间，与 hiprofiler_cmd 下发的-t 配置联动。 输入 hdc_std shell，进入设备，执行命令。 diff --git a/ide/src/doc/md/quickstart_filesystem.md b/ide/src/doc/md/quickstart_filesystem.md index 425d2c88d..72fd4f6b2 100644 --- a/ide/src/doc/md/quickstart_filesystem.md +++ b/ide/src/doc/md/quickstart_filesystem.md @@ -35,14 +35,14 @@ FileSystem 分析文件系统的信息和活动，比如读和写操作等。 ### FileSystem 泳道图展示 -FileSystem 泳道图按照读操作和写操作展示，鼠标移动都泳道图上，悬浮框会以 10ms 为周期展示读，写类型系统调用的次数。 +FileSystem 泳道图按照读操作和写操作展示，鼠标移动到泳道图上，悬浮框会以 10ms 为周期展示读，写类型系统调用的次数。 ![GitHub Logo](../../figures/FileSystem/FileSystemchart.jpg) 按住 w 键放大界面，悬浮框会显示当前时刻的文件读写次数。 ![GitHub Logo](../../figures/FileSystem/FileSystemcount.jpg) ### FileSystem 泳道图的框选功能 -可以对读写操作泳道图进行框选，框选后在最下方的弹出层中会展示框选数据的统计表格，总共有五个 tab 页。 +可以对读写操作泳道图进行框选，框选后展示框选数据的统计表格，总共有六个 tab 页。 FileSystem statistics 的 Tab 页如图： ![GitHub Logo](../../figures/FileSystem/FileSystemstatistics.jpg) @@ -55,7 +55,7 @@ FileSystem statistics 的 Tab 页如图： - Min Duration：最小时长。 - Avg Duration： 平均时长。 - Max Duration：最大时长。 - FileSystem Calltree 的 Tab 页如图： + FileSystem CallTree 的 Tab 页如图： ![GitHub Logo](../../figures/FileSystem/FileSystemCalltree.jpg) - Call Stack：为经过符号解析后的Callstack，并且给出动态链接库或者进程名的信息。 - Local：为该调用方法自身占用的CPU时间。 @@ -66,6 +66,9 @@ FileSystem statistics 的 Tab 页如图： - Duration：时长。 - Process：进程名。 - Thread：线程名。 +- Type：操作类型。 +- File Descriptor：fd。 +- File Path：文件路径。 - First Argument：系统调用的第一个参数。 - Second Argument：系统调用的第二个参数。 - Third Argument：系统调用的第三个参数。 @@ -80,6 +83,7 @@ FileSystem statistics 的 Tab 页如图： - Process：进程名。 - Type：操作类型。 - File Descriptor：fd。 +- Path：文件路径。 - Backtrace：调用栈顶部函数，并显示调用栈深度。 File Descriptor Time Slice 的 Tab 页如图： ![GitHub Logo](../../figures/FileSystem/FileSystemtimeslice.jpg) @@ -87,19 +91,22 @@ FileSystem statistics 的 Tab 页如图： - Open Duration：打开的时长。 - Process：进程名。 - File Descriptor：fd。 +- Path：文件路径。 - Backtrace：调用栈顶部函数，并显示调用栈深度。 ### FileSystem 支持多种 Options 展示风格 -点击 FileSystem Calltree 的 Tab 页底部的 Options，会有两个 CheckBox 复选框。 +点击 FileSystem CallTree 的 Tab 页底部的 Options，会有四个 CheckBox 复选框。 ![GitHub Logo](../../figures/FileSystem/FileSystemOptions.jpg) - Invert：反向输出调用树。 - Hide System so：隐藏系统库文件。 +- Hide Event：隐藏事件。 +- Hide Thread：隐藏线程。 ### FileSystem 支持过滤调用栈调用次数的展示风格 -点击 FileSystem Calltree 的 Tab 页底部的 Sample Counter Filter，可以填上区间值。过滤出符合该区间值调用次数的调用栈信息。 +点击 FileSystem CallTree 的 Tab 页底部的 Sample Count Filter，可以填上区间值。过滤出符合该区间值调用次数的调用栈信息。 ![GitHub Logo](../../figures/FileSystem/FileSystemsamplecounter.jpg) ### FileSystem 功能的调用栈 Group 展示-数据分析支持剪裁功能 @@ -128,7 +135,7 @@ FileSystem statistics 的 Tab 页如图： ### FileSystem 的火焰图功能 -点击 FileSystem Calltre 左下角的柱状图的图标，会切换到火焰图页面。 +点击 FileSystem CallTree 左下角的柱状图的图标，会切换到火焰图页面。 ![GitHub Logo](../../figures/FileSystem/FileSystemflame.jpg) 进入到火焰图页面，火焰图的展示跟 Callinfo 的 tab 页的调用栈显示一致，鼠标放到色块上，悬浮框可以显示调用栈名称和 Duration 时长。 ![GitHub Logo](../../figures/FileSystem/FileSystemflameshow.jpg) diff --git a/ide/src/doc/md/quickstart_hiperf.md b/ide/src/doc/md/quickstart_hiperf.md index e4da5784f..224570c68 100644 --- a/ide/src/doc/md/quickstart_hiperf.md +++ b/ide/src/doc/md/quickstart_hiperf.md @@ -10,7 +10,7 @@ HiPerf 工具是对系统性能数据进行采样记录，并将采样数据保 配置项说明： - Start Hiperf Sampling：配置项的总开关。 -- Process：离线模式下配置的是整个系统的。 +- Process：离线模式下配置的是整个系统的进程。 - Frequency：配置抓取的频率。 - Call Stack：配置抓取的堆栈类型。 - Advance Options：更多的抓取配置项。 @@ -18,7 +18,7 @@ HiPerf 工具是对系统性能数据进行采样记录，并将采样数据保 ![GitHub Logo](../../figures/perf/perfset.jpg) 点击 Trace command，就会根据上面的配置生成抓取命令，点击复制按钮，会将命令行复制。 ![GitHub Logo](../../figures/perf/perfcommand.jpg) - 输入 hdc_shell，进入设备，执行命令。 + 输入 hdc shell，进入设备，执行命令。 ![GitHub Logo](../../figures/perf/perfexcutecommand.jpg) 执行完成后，进入指定目录查看，在/data/local/tmp 下就会生成 trace 文件。 ![GitHub Logo](../../figures/perf/perffile.jpg) @@ -45,13 +45,14 @@ Perf 泳道图上浅色表示无效调用栈的采样点，抓取时由于设备 ### HiPerf 泳道图的框选功能 -可以对 CPU 使用量区，线程和进程区数据进行框选，框选后在最下方的弹出层中会展示框选数据的统计表格，总共有两个 tab 页。 +可以对 CPU 使用量的线程和进程区数据进行框选，框选后在最下方的弹出层中会展示框选数据的统计表格，总共有四个 tab 页。 Perf Profile 的 Tab 页如图： ![GitHub Logo](../../figures/perf/PerfProfile.jpg) - Call Stack：为经过符号解析后的Callstack，并且给出动态链接库或者进程名的信息。 - Local：为该调用方法自身占用的CPU时间。 -- Weight：调用方法的执行次数和占比。 +- Sample Count：采样数量。 +- Event Count：事件数量。 Sample List 的 Tab 页如图： ![GitHub Logo](../../figures/perf/Samplelist.jpg) - Sample Time：采样的时间戳信息。 @@ -63,15 +64,17 @@ Perf Profile 的 Tab 页如图： ### HiPerf 支持多种 Options 展示风格 -点击 Perf Profile 的 Tab 页底部的 Options，会有两个 CheckBox 复选框。 +点击 Perf Profile 的 Tab 页底部的 Options，会有四个 CheckBox 复选框。 ![GitHub Logo](../../figures/perf/Options.jpg) - Invert：反向输出调用树。 - Hide System so：隐藏系统库文件。 +- Hide Thread：隐藏线程。 +- Hide Thread State：隐藏线程状态。 ### HiPerf 支持过滤调用栈调用次数的展示风格 -点击 Perf Profile 的 Tab 页底部的 Sample Counter Filter，可以填上区间值。过滤出符合该区间值调用次数的调用栈信息。 +点击 Perf Profile 的 Tab 页底部的 Sample Count Filter，可以填上区间值。过滤出符合该区间值调用次数的调用栈信息。 ![GitHub Logo](../../figures/perf/samplecounter.jpg) ### HiPerf 功能的调用栈 Group 展示-数据分析支持剪裁功能 diff --git a/ide/src/doc/md/quickstart_hisystemevent.md b/ide/src/doc/md/quickstart_hisystemevent.md index 8e8d80e9d..cd3269ead 100644 --- a/ide/src/doc/md/quickstart_hisystemevent.md +++ b/ide/src/doc/md/quickstart_hisystemevent.md @@ -27,7 +27,7 @@ HiSystemEvent 应用功耗模块主要是展示应用的各个子类别功耗占 - Anomaly Event泳道： 显示系统异常和应用异常的ToolTip。 - System Event泳道： 以条状图显示，红色代表后台任务(WORKSCHEDULER)，黄色代表应用锁(POWER)，蓝色代表GPS定位(LOCATION)。 -- Power泳道：应用各个子类的功耗柱状图、折现图以及应用各个子类绘制的图例，鼠标的悬浮可以显示出各个子类功耗的具体值。 +- Power泳道：应用各个子类的功耗柱状图、折线图以及应用各个子类绘制的图例，鼠标的悬浮可以显示出各个子类功耗的具体值。 - Brightness Nit泳道：鼠标悬浮可以显示屏幕亮度值。 - Wifi Event Received泳道：鼠标悬浮可以显示WiFi信号强度值。 - Audio Stream Change泳道：鼠标悬浮可以显示Audio状态(AUDIO_STREAM_CHANGE事件)。 diff --git a/ide/src/doc/md/quickstart_native_memory.md b/ide/src/doc/md/quickstart_native_memory.md index d6474b1be..ac216a723 100644 --- a/ide/src/doc/md/quickstart_native_memory.md +++ b/ide/src/doc/md/quickstart_native_memory.md @@ -17,7 +17,7 @@ Native Memory 是查看内存的分配和释放等情况。 - Use Record Accurately：不过滤数据，上报全量的。 - Use Offline Symbolization：离线符号化。 - Use Record Statistics：统计数据上报时间间隔设置。 -- Use Startup Mode :抓取应用启动阶段的内存(默认是关闭，需要抓取应用启阶段内存可开启)。 +- Use Startup Mode: 抓取应用启动阶段的内存(默认是关闭，需要抓取应用启阶段内存可开启)。 再点击 Record setting，在 output file path 输入文件名 hiprofiler_data_nativememory.htrace，拖动滚动条设置 buffer size 大小是 64M，抓取时长是 50s。 ![GitHub Logo](../../figures/NativeMemory/nativememoryset.jpg) @@ -141,9 +141,10 @@ Call Info 的 Tab 页，主要显示了调用树详细类型。 ### 搜索框支持表达式输入 -调用栈默认显示火焰图，新增搜索框表达式输入。表达式作用范围为 nativehook 统计与非统计模式。其中处理的均为 Responsible Library 与 Responsible Caller，其中 Responsible Library，Responsible Caller 表示从下往上非 libc++ musl 的第一条调用栈的 lib 跟 symbol，如下图所示，由于最后一条 [ operator new(unsigned long) ] libc++.so 为 libc++.so 的函数，固跳过，所以该条调用栈的 Responsible Library 为 libhilog.so，Responsible Caller 为 OHOS::HiviewDFX::GetDomainLevel(unsigned int) 。 +调用栈默认会显示火焰图，新增搜索框表达式输入。表达式作用范围为 nativehook 的统计与非统计模式。其中处理的为 Responsible Library 与 Responsible Caller，其中 Responsible Library 和Responsible Caller 表示从下往上非 libc++ musl 的第一条调用栈的 lib 跟 symbol，如下图所示，由于最后一条 [ operator new(unsigned long) ] libc++.so 为 libc++.so 的函数，故跳过，所以该条调用栈的 Responsible Library 为 libhilog.so，Responsible Caller 为 OHOS::HiviewDFX::GetDomainLevel(unsigned int) 。 ![GitHub Logo](../../figures/NativeMemory/framecaller.jpg) -表达式说明:在 InputFilter 输入框可以进行搜索过滤和表达式过滤，其中表达式必须以@开头，英文括号包起所需要过滤的内容，每个括号必须包括 （Responsible Library，Responsible Caller）匹配全量以\*表示，否则认为该输入为搜索过滤。 + +表达式说明: 在 InputFilter 输入框可以进行搜索过滤和表达式过滤，其中表达式必须以@开头，英文括号包起所需要过滤的内容，每个括号必须包括 （Responsible Library，Responsible Caller）匹配全量以\*表示，否则认为该输入为搜索过滤。 | 表达式 | 含义 | | --------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | diff --git a/ide/src/doc/md/quickstart_page_fault.md b/ide/src/doc/md/quickstart_page_fault.md index b3968ce99..c5b095703 100644 --- a/ide/src/doc/md/quickstart_page_fault.md +++ b/ide/src/doc/md/quickstart_page_fault.md @@ -50,7 +50,7 @@ Page Fault Statistics 的 Tab 页如图： - Max Duration：最大时长。 点击下方的 Statistics by Thread，可以切换到按照 Thread 为基点显示数据。 ![GitHub Logo](../../figures/EBPF/ebpf_bythread.jpg) - Page Fault Calltree 的 Tab 页如图： + Page Fault CallTree 的 Tab 页如图： ![GitHub Logo](../../figures/EBPF/VMCalltree.jpg) - Call Stack：为经过符号解析后的Callstack，并且给出动态链接库或者进程名的信息。 - Local：为该调用方法自身占用的CPU时间。 @@ -66,7 +66,7 @@ Page Fault Statistics 的 Tab 页如图： ### 页内存支持多种 Options 展示风格 -点击 Page Fault Calltree 的 Tab 页底部的 Options，会有两个 CheckBox 复选框。 +点击 Page Fault CallTree 的 Tab 页底部的 Options，会有两个 CheckBox 复选框。 ![GitHub Logo](../../figures/EBPF/vmOptions.jpg) - Invert：反向输出调用树。 @@ -74,7 +74,7 @@ Page Fault Statistics 的 Tab 页如图： ### 页内存支持过滤调用栈调用次数的展示风格 -点击 Page Fault Calltree 的 Tab 页底部的 Sample Counter Filter，可以填上区间值。过滤出符合该区间值调用次数的调用栈信息。 +点击 Page Fault CallTree 的 Tab 页底部的 Sample Count Filter，可以填上区间值。过滤出符合该区间值调用次数的调用栈信息。 ![GitHub Logo](../../figures/EBPF/vmcounter.jpg) ### 页内存功能的调用栈 Group 展示-数据分析支持剪裁功能 @@ -97,12 +97,12 @@ Page Fault Statistics 的 Tab 页如图： ### 页内存的事件类型的过滤 -通过选择可以过滤是 File Backed In 类型，还是 Copy On Write 类型事件。 +通过选择类型事件进行过滤。 ![GitHub Logo](../../figures/EBPF/VMfilter.jpg) ### 页内存的火焰图功能 -点击 Page Fault Calltree 左下角的柱状图的图标，会切换到火焰图页面。 +点击 Page Fault CallTree 左下角的柱状图的图标，会切换到火焰图页面。 ![GitHub Logo](../../figures/EBPF/vmflame.jpg) 进入到火焰图页面，火焰图的展示跟 Callinfo 的 tab 页的调用栈显示一致，鼠标放到色块上，悬浮框可以显示调用栈名称和 Duration 时长。 ![GitHub Logo](../../figures/EBPF/vmflameshow.jpg) diff --git a/ide/src/doc/md/quickstart_parsing_ability.md b/ide/src/doc/md/quickstart_parsing_ability.md index b3bb85846..e39a320ae 100644 --- a/ide/src/doc/md/quickstart_parsing_ability.md +++ b/ide/src/doc/md/quickstart_parsing_ability.md @@ -28,7 +28,7 @@ Trace 解析能力增强主要是提高 Trace 的解析能力。 ##### 配置完成后, 查看【用户配置路径】是否是配置的路径 - edge浏览器: edge://version/ + edge浏览器: edge://version/ chrome浏览器: chrome://version/ #### 超大 trace 抓取配置说明 diff --git a/ide/src/doc/md/quickstart_sql_metrics.md b/ide/src/doc/md/quickstart_sql_metrics.md index f06ba59ce..dcfe181f3 100644 --- a/ide/src/doc/md/quickstart_sql_metrics.md +++ b/ide/src/doc/md/quickstart_sql_metrics.md @@ -9,7 +9,7 @@ Sql 功能是方便使用者查询 sql 语句查看相关业务，Metrics 是更 ## Metrics 功能介绍 -Metrics 是更高级别的查询接口，无需手动键入任何 SQL 语句，只需要选择定制好的查询接口，就能获得想要跟踪的结果。 +Metrics 是更高级别的查询接口，无需手动输入任何 SQL 语句，只需要选择定制好的查询接口，就能获得想要跟踪的结果。 ### Metrics 查询接口展示 diff --git a/ide/src/doc/md/quickstart_systemtrace.md b/ide/src/doc/md/quickstart_systemtrace.md index 4802cbbdb..b4f52d8d6 100644 --- a/ide/src/doc/md/quickstart_systemtrace.md +++ b/ide/src/doc/md/quickstart_systemtrace.md @@ -12,7 +12,7 @@ - Open trace file：导入离线 trace 文件入口。 - Open long trace file：导入大文件入口。 - Record new trace：抓取新的 trace 文件入口。 -- Record template：抓取指定模块的 trace 入口。 +- Record template：抓取指定模块的 trace 文件入口。 ## 导入 trace 文件后显示页面 @@ -128,7 +128,7 @@ Thread States、Thread Switches 的 2 个 Tab 页，点击移动到某一行， ### Tab 页信息和泳道图可跳转(点击和框选场景,框选类似搜索) -泳道图高亮场景：框选 Cpu Frequency 或者 Cpu State 泳道图后，弹出 Cpu Frequency 或 Cpu State Tab 页，在点击 Tab 页表格的行时，框选范围泳道图的当前行的 Value 值一样的部分上方会出现一条以圆点开头颜色比趋势图颜色同色但稍深的粗线条，如下图: +泳道图高亮场景：框选 Cpu Frequency 或者 Cpu State 泳道图后，弹出 Cpu Frequency 或 Cpu State Tab 页，点击 Tab 页表格中行某一行数据时，会在框选范围泳道内出现一个以圆形开头的图标，表示当前所点击的数据，如下图: ![GitHub Logo](../../figures/Web/Tabskill.jpg) 搜索场景：框选函数调用栈的泳道图，弹出 Slices Tab 页，点击表格行，会跳转到框选范围内的第一条调用栈的位置，点击下图 Slices Tab 页的 Background concurrent copying GC 调用栈。 ![GitHub Logo](../../figures/Web/Tabskillcalltack.jpg) diff --git a/ide/src/doc/md/quickstart_web_record.md b/ide/src/doc/md/quickstart_web_record.md index efcf14b6d..a6f0e3db4 100644 --- a/ide/src/doc/md/quickstart_web_record.md +++ b/ide/src/doc/md/quickstart_web_record.md @@ -5,10 +5,11 @@ ## 界面配置说明 ![GitHub Logo](../../figures/hdc/hdc.jpg) + 说明： -- Record:trace 抓取按钮。 -- Add HDC Device:连接设备。 +- Record: trace 抓取按钮。 +- Add HDC Device: 连接设备。 ## trace 文件的在线抓取 @@ -18,13 +19,13 @@ ![GitHub Logo](../../figures/hdc/Schedulingdetails.jpg) 抓取项说明： -- Scheduling details:线程切换事件，暂停恢复方法，线程唤醒事件，进程退出和销毁处理，新建线程处理方法，线程重命名处理方法。 -- CPU Frequency and idle states:CPU 频率信息和 CPU 空闲状态。 -- Advanced ftrace config:线程切换事件，暂停恢复方法，线程唤醒事件，进程退出和销毁处理，新建线程处理方法，线程重命名处理方法，IRQ 事件，时钟频率处理方法，Binder 事件，线程调用堆栈开始和结束的处理。 -- AbilityMonitor:进程的 CPU，内存，磁盘，网络使用情况。 -- Kernel meminfo:内核内存。 -- Virtual memory stats:系统虚拟内存。 -- Hitrace categories:Bytrace 的抓取项，各解释项说明如下图： +- Scheduling details: 线程切换事件，暂停恢复方法，线程唤醒事件，进程退出和销毁处理，新建线程处理方法，线程重命名处理方法。 +- CPU Frequency and idle states: CPU 频率信息和 CPU 空闲状态。 +- Advanced ftrace config: 线程切换事件，暂停恢复方法，线程唤醒事件，进程退出和销毁处理，新建线程处理方法，线程重命名处理方法，IRQ 事件，时钟频率处理方法，Binder 事件，线程调用堆栈开始和结束的处理。 +- AbilityMonitor: 进程的 CPU，内存，磁盘，网络使用情况。 +- Kernel meminfo: 内核内存。 +- Virtual memory stats: 系统虚拟内存。 +- Hitrace categories: Bytrace 的抓取项，各解释项说明如下图： ![GitHub Logo](../../figures/hdc/bytacedescription.jpg) 再点击 Record setting，在 output file path 输入文件名 hiprofiler_data_example.htrace，拖动滚动条设置 buffer size 大小是 64M，抓取时长是 50s。 diff --git a/ide/src/doc/quickstart_bio.html b/ide/src/doc/quickstart_bio.html index b1fa979c5..6ed54a19f 100644 --- a/ide/src/doc/quickstart_bio.html +++ b/ide/src/doc/quickstart_bio.html @@ -908,7 +908,7 @@ Max Total Latency：最大延迟时间。

- Disk I/O Latency Calltree的Tab页如图：
+ Disk I/O Latency CallTree的Tab页如图：
GitHub Logo