# TraceStreamer 数据表概述

TraceStreamer 可以将 trace 数据源转化为易于理解和使用的数据库。用户可以通过 SmartPerf 界面直观的研究系统跟踪数据，也可在理解 TraceStreamer 生成的数据库的基础上，在 TraceStreamer 的交互模式或者 Smartperf 的数据库查询模式下，使用 SQL 查询语句自由组装查看用户关心的数据。下文将对 TraceStreamer 生成的数据库进行详细描述，给用户使用 SQL 查询系统跟踪数据提供帮助。

## TraceStreamer 输出的数据表分类

- 常规泳道图数据表
  ![GitHub Logo](../../figures/traceStreamer/db_common.png)
- native memory 数据源相关表
  ![GitHub Logo](../../figures/traceStreamer/db_native_memory.png)
- perf 相关数据表
  ![GitHub Logo](../../figures/traceStreamer/db_hiperf.png)
- hisysevent 相关数据表
  ![GitHub Logo](../../figures/traceStreamer/db_hisys_event.png)

## TraceStreamer 输出数据库包含以下表格

| 表名称                      | 作用                                                                                                                                                                |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- |
| animation                   | 记录动效的响应时延和完成时延                                                                                                                                        |
| app_name                    | 记录 HiSysEvent 事件的事件名与 IDE 部分事件的字段名为 APPNAME 中存放的相关信息的映射关系                                                                            |
| app_startup                 | 记录了应用启动相关数据                                                                                                                                              |
| args                        | 记录方法参数集合                                                                                                                                                    |
| bio_latency_sample          | 记录 IO 操作相关方法调用，及调用栈数据                                                                                                                              |
| callstack                   | 记录调用堆栈和异步调用信息，其中 depth,stack_id 和 parent_stack_id 仅在非异步调用中有效。当 cookid 不为空时，为异步调用，此时 callid 为进程唯一号，否则为线程唯一号 |
| clk_event_filter            | 记录时钟相关的信息                                                                                                                                                  |
| clock_event_filter          | 此结构用来维护时钟事件，cpu 与唯一的 ID 做关联                                                                                                                      |
| clock_snapshot              | 时钟号和时间，时钟名的映射表                                                                                                                                        |
| cpu_measure_filter          | cpu 事件过滤器表                                                                                                                                                    |
| cpu_usage                   | 记录 CPU 使用率事件                                                                                                                                                 |
| datasource_clockid          | 数据源和时钟号的映射表                                                                                                                                              |
| data_dict                   | 记录常用的字符串，将字符串和索引关联，降低程序运行的内存占用，用作辅助数据                                                                                          |
| data_type                   | 记录数据类型和 typeId 的关联关系                                                                                                                                    |
| device_info                 | 记录设备分辨率和帧率                                                                                                                                                |
| device_state                | 记录设备屏幕亮度，蓝牙，位置，wifi，音乐，媒体等信息                                                                                                                |
| diskio                      | 记录磁盘读写数据事件                                                                                                                                                |
| dynamic_frame               | 记录动效帧的分辨率和结束时间等                                                                                                                                      |
| ebpf_callstack              | 记录了采样相关信息                                                                                                                                                  |
| file_system_sample          | 记录了调用栈的相关信息                                                                                                                                              |
| frame_maps                  | 记录应用到 RS 的帧的映射关系                                                                                                                                        |
| frame_slice                 | 记录 RS(RenderService)和应用的帧渲染                                                                                                                                |
| gpu_slice                   | 记录 RS 的帧对应的 gpu 渲染时长                                                                                                                                     |
| hidump                      | 记录 FPS（Frame Per Second）数据                                                                                                                                    |
| hisys_event_measure         | 记录了 HiSysEvent 事件相关数据，目前 HiSysEvent 事件包括了异常事件，IDE 事件，器件状态事件                                                                          |
| instant                     | 记录 Sched_waking, sched_wakeup 事件， 用作 ThreadState 表的上下文使用                                                                                              |
| irq                         | 记录中断相关事件                                                                                                                                                    |
| js_config                   | 记录了 arkTs 数据采集的相关配置                                                                                                                                     |
| js_cpu_profiler_node        | 记录了 cpu profiler 中 node 节点的数据                                                                                                                              |
| js_cpu_profiler_sample      | 记录了 cpu profiler 中 sample 节点的数据                                                                                                                            |
| js_heap_edges               | 记录了 js 内存数据类对象对应的成员的信息                                                                                                                            |
| js_heap_files               | 记录了 js 内存数据的名称和时间                                                                                                                                      |
| js_heap_info                | 记录了 js 内存数据类型，如 nodes 和 edges 的字段类型和数据总数                                                                                                      |
| js_heap_location            | 记录了 js 内存 location 节点相关数据                                                                                                                                |
| js_heap_nodes               | 记录了 js 内存类对象和其成员的对应关系                                                                                                                              |
| js_heap_sample              | 记录了 timeline 模式下的时间轴信息                                                                                                                                  |
| js_heap_string              | 记录了 js 内存数据中的字符串                                                                                                                                        |
| js_heap_trace_function_info | 记录了 timeline 模式下的调用栈的每个函数信息                                                                                                                        |
| js_heap_trace_node          | 记录了 timeline 模式下的调用栈信息                                                                                                                                  |
| live_process                | 记录了一些实时的进程中执行的一些数据                                                                                                                                |
| log                         | 记录 hilog 打印日志数据                                                                                                                                             |
| measure                     | 记录所有的计量值                                                                                                                                                    |
| measure_filter              | 记录一个递增的 filterid 队列，所有其他的 filter 类型在获取过程中，均从此数据列表中获取下一个可用的 filter_id 并做记录                                               |
| memory_ashmem               | 记录了进程所占用的 ashmem 相关信息                                                                                                                                  |
| memory_dma                  | 记录了进程占用的 DMA 内存相关信息                                                                                                                                   |
| memory_process_gpu          | 记录进程占用 GPU 内存相关信息                                                                                                                                       |
| memory_window_gpu           | 记录窗口占用 GPU 内存相关信息                                                                                                                                       |
| meta                        | 记录执行解析操作相关的基本信息                                                                                                                                      |
| native_hook                 | 记录堆内存申请与释放相关的数据                                                                                                                                      |
| native_hook_frame           | 记录堆内存申请与释放相关的调用栈                                                                                                                                    |
| native_hook_statistic       | 记录堆内存申请与释放相关的统计信息                                                                                                                                  |
| network                     | 抓取网络信息传输时产生的一些相关信息                                                                                                                                |
| paged_memory_sample         | 记录内存操作相关方法调用，及调用栈数据                                                                                                                              |
| perf_callchain              | 记录 Hiperf 采样数据的调用栈信息                                                                                                                                    |
| perf_files                  | 记录 Hiperf 工具采集到的函数符号表和文件名                                                                                                                          |
| perf_report                 | 记录 Hiperf 工具采集数据时的配置信息。包括                                                                                                                          | 抓取的事件类型，抓取数据的命令， 抓数据时指定的进程名称 |
| perf_sample                 | 记录 Hiperf 工具的采样信息                                                                                                                                          |
| perf_thread                 | 记录 Hiperf 工具采集到的进程和线程数据                                                                                                                              |
| process                     | 记录所有的进程信息                                                                                                                                                  |
| process_filter              | 过滤进程                                                                                                                                                            |
| process_measure             | 保存进程的所有计量值                                                                                                                                                |
| process_measure_filter      | 将进程 ID 作为 key1，进程的内存，界面刷新，屏幕亮度等信息作为 key2，唯一确定一个 filter_id                                                                          |
| raw                         | 此数据结构主要作为 ThreadState 的上下文使用，这张表是 sched_waking,sched_wakup, cpu_idle 事件的原始记录                                                             |
| sched_slice                 | 此数据结构主要作为 ThreadState 的上下文使用，这张表是 sched_switch 事件的原始记录                                                                                   |
| smaps                       | 记录进程的内存消耗的相关信息采样                                                                                                                                    |
| stat                        | 此结果用来统计数据解析中各类数据的数据条数，数据和合法性，数据的匹配程度（begin-end），数据的损失等，查看此结构对应的表，可对数据源有基本的了解                     |
| static_initalize            | 记录了 so 初始化相关数据                                                                                                                                            |
| symbols                     | 记录系统调用名称和其函数指针的对应关系，trace 中用 addr 来映射 function_name 来节省存储空间                                                                         |
| syscall                     | 记录用户空间函数与内核空间函数相互调用记录                                                                                                                          |
| sys_event_filter            | 记录所有的 filter                                                                                                                                                   |
| sys_mem_measure             | 记录了所有的系统内存相关的测量信息                                                                                                                                  |
| task_pool                   | 记录任务池相关数据，与 callstack 表相关联                                                                                                                           |
| thread                      | 记录所有的线程信息                                                                                                                                                  |
| thread_filter               | 过滤线程                                                                                                                                                            |
| thread_state                | 记录线程状态信息                                                                                                                                                    |
| trace_config                | 记录 trace 数据源，proto 的事件-plugin 与其 process_name                                                                                                            |
| trace_range                 | 记录 ftrace 数据与其他类型数据的时间交集，供前端展示数据时使用                                                                                                      |

## 表与事件来源

| 表名称                      | 事件源 | 插件名                | 备注                                               |
| --------------------------- | ------ | --------------------- | -------------------------------------------------- |
| animation                   | -      | ftrace-plugin         | 记录动效的响应时延和完成时延                       |
| app_name                    | -      | hisysevent-plugin     | JSON 数据源                                        |
| args                        | -      | ftrace-plugin         | 配合 callstack 使用                                |
| bio_latency_sample          | -      | -                     | IO 操作相关方法调用，及调用栈数据                  |
| callstack                   | -      | ftrace-plugin         | 异步或非异步的调用                                 |
| cpu_measure_filter          | -      | ftrace-plugin         | cpu 跟踪器，cpu 频率等                             |
| cpu_usage                   | -      | cpu-plugin            | cpu 使用率                                         |
| data_dict                   | 通用的 | -                     | 所有字符串的记录                                   |
| data_type                   | 通用的 | -                     | 辅助表                                             |
| device_info                 | -      | ftrace-plugin         | 记录设备分辨率和帧率                               |
| device_state                | 通用的 | hisysevent-plugin     | 记录设备屏幕亮度，蓝牙，位置等信息                 |
| dynamic_frame               | -      | ftrace-plugin         | 动效帧的分辨率和结束时间等                         |
| ebpf_callstack              | -      | -                     | 磁盘读写相关的数据                                 |
| file_system_callstack       | -      | -                     | ebpf 文件系统                                      |
| file_system_sample          | -      | -                     | ebpf 文件系统                                      |
| frame_maps                  | -      | ftrace-plugin         | 帧渲染数据，app 到 RS 的映射                       |
| frame_slice                 | -      | ftrace-plugin         | 帧渲染数据                                         |
| gpu_slice                   | -      | ftrace-plugin         | gpu 渲染时长                                       |
| hidump                      | -      | hidump-plugin         | FPS 数据                                           |
| hisys_event_measure         | -      | hisysevent-plugin     | JSON 数据源                                        |
| instant                     | -      | ftrace-plugin         | waking 和 wakeup 事件                              |
| irq                         | -      | ftrace-plugin         | 记录中断事件                                       |
| js_config                   | -      | arkts-plugin          | arkTs 数据采集的配置                               |
| js_cpu_profiler_node        | -      | arkts-plugin          | 记录了 cpu profiler 中 node 节点的数据             |
| js_cpu_profiler_sample      | -      | arkts-plugin          | 记录了 cpu profiler 中 sample 节点的数据           |
| js_heap_edges               | -      | arkts-plugin          | js 内存数据                                        |
| js_heap_files               | -      | arkts-plugin          | js 内存数据                                        |
| js_heap_info                | -      | arkts-plugin          | js 内存数据                                        |
| js_heap_location            | -      | arkts-plugin          | js 内存数据                                        |
| js_heap_nodes               | -      | arkts-plugin          | js 内存数据                                        |
| js_heap_sample              | -      | arkts-plugin          | js 内存数据                                        |
| js_heap_string              | -      | arkts-plugin          | js 内存数据                                        |
| js_heap_trace_function_info | -      | arkts-plugin          | js 内存数据                                        |
| js_heap_trace_node          | -      | arkts-plugin          | js 内存数据                                        |
| app_startup                 | -      | ftrace-plugin         | 应用启动数据                                       |
| static_initalize            | -      | ftrace-plugin         | so 初始化数据                                      |
| live_process                | -      | process-plugin        | Monitor 数据                                       |
| network                     | -      | network-plugin        | Monitor 数据                                       |
| diskio                      | -      | diskio-plugin         | Monitor 数据                                       |
| log                         | -      | hilog-plugin          | 系统日志                                           |
| measure                     | 通用的 | -                     | 系统中的计量值（数值型）                           |
| measure_filter              | 通用的 | -                     | 计量值的查询辅助表                                 |
| memory_ashmem               | -      | memory-plugin         | 进程所占用 ashmem 相关信息                         |
| memory_dma                  | -      | memory-plugin         | 进程占用的 DMA 内存相关信息                        |
| memory_process_gpu          | -      | memory-plugin         | 进程占用 GPU 内存相关信息                          |
| memory_window_gpu           | -      | memory-plugin         | 窗口占用 GPU 内存相关信息                          |
| meta                        | 通用的 | -                     | 记录解析现场数据（解析时间，数据类型，解析工具等） |
| native_hook                 | -      | nativehook/hookdaemon | malloc && mmap 内存数据                            |
| native_hook_frame           | -      | nativehook/hookdaemon | native_hook 调用栈数据                             |
| native_hook_statistic       | -      | nativehook/hookdaemon | malloc && mmap 统计数据                            |
| paged_memory_sample         | -      | -                     | 网络数据传输相关的信息                             |
| perf_callchain              | -      | perf-plugin           | perf 数据（非插件模式）                            |
| perf_files                  | -      | -                     | perf 数据（非插件模式）                            |
| perf_report                 | -      | -                     | perf 数据（非插件模式）                            |
| perf_sample                 | -      | -                     | perf 数据（非插件模式）                            |
| perf_thread                 | -      | -                     | perf 数据（非插件模式）                            |
| process                     | -      | ftrace-plugin         | 进程信息                                           |
| process_filter              | -      | ftrace-plugin         | 进程计量表的辅助表                                 |
| process_measure             | -      | ftrace-plugin         | 进程内存                                           |
| process_measure_filter      | -      | ftrace-plugin         | process_measure 的辅助表                           |
| raw                         | -      | ftrace-plugin         | 线程唤醒信息                                       |
| sched_slice                 | -      | ftrace-plugin         | 配合现场状态表使用，dsched_switch 的原始数据       |
| smaps                       | -      | memory-plugin         | 进程的内存消耗                                     |
| stat                        | 通用的 | -                     | 记录不同种类数据的数据量                           |
| symbols                     | -      | ftrace-plugin         | 符号表（地址到字符串的映射）                       |
| syscall                     | -      | ftrace-plugin         | 系统调用 sys_enter/exit                            |
| sys_event_filter            | -      | ftrace-plugin         |                                                    |
| sys_mem_measure             | -      | memory-plugin         | 系统内存                                           |
| thread                      | 通用的 | -                     | 线程信息（常用）                                   |
| thread_state                | 通用的 | ftrace-plugin         | 线程调度图（常用）                                 |
| trace_config                | 通用的 | hisysevent-plugin     | 记录 trace 数据源                                  |
| trace_range                 | 通用的 | -                     | trace 数据的时长                                   |
| thread_filter               | 通用的 | ftrace-plugin         | 线程计量跟踪表（比较少用）                         |
| clock_snapshot              | 通用的 | 通用的                | 时钟号和时间，时钟名的映射表                       |
| datasource_clockid          | 通用的 | 通用的                | 数据源和时钟号的映射表                             |
| task_pool                   | -      | -                     | 任务池数据                                         |

## **_表格关系图_**

---

### 进程表与线程表关系

当一个进程或者线程结束后，系统可能再次将该进程号或者线程号分配给其他进程或者线程，造成一个进程号或线程号代表多个进程或线程的情况。  
Process 和 Thread 表中的 id 字段可以唯一标识进程和线程。process 表中的 id 在其他表中用作 ipid 字段。thread 表中的 id 在其他表中用作 itid 字段。  
thread 表通过 ipid 字段关联 process 表的 id 字段，可以查询线程归属进程。  
![GitHub Logo](../../figures/traceStreamer/process_thread.png)

### 查询举例

- 已知 pid = 123,查看当前进程下的所有线程信息,可以使用如下 SQL 语句：  
  `select thread.* from thread, process where process.pid = 123 and thread.ipid = process.id`

### 线程表与线程运行状态表关系图

thread_state 表记录所有线程的运行状态信息，包含 ts(状态起始时间)，dur(状态持续时间)，cpu, itid, state（线程状态）。 thread 表的 id 字段与 thread_state 表的 itid 字段相关联。  
![GitHub Logo](../../figures/traceStreamer/thread_state.png)

### 查询举例

- 已知 tid = 123, 查看当前线程的所有运行状态信息，可以使用如下 SQL 语句：  
  `select thread_state.* from thread, thread_state where thread.tid = 123 and thread.id = thread_state.itid`

### 堆内存数据变化表关系图

native_hook 表记录堆内存申请(AllocEvent)和释放(FreeEvent)数据。native_hook 表通过 ipid 和 itid 字段分别与 process 和 thread 表的 id 字段关联，通过 callChainId 与 native_hook_frame 表的 callChainId 字段相关联。
native_hook 表字段解释如下：

- callChainId：唯一标识一次堆内存申请或释放， 通过与 native_hook_frame 表关联可以拿到当前申请或释放的函数调用堆栈。
- addr：堆内存申请/释放的地址。
- native_hook_size：堆内存申请/释放的大小。

native_hook_frame 表记录内存申请/释放的调用堆栈。通过 callChainId 区分一组调用堆栈，depth 为堆栈深度，depth 为 0 时，表示当前行为栈顶数据。  
![GitHub Logo](../../figures/traceStreamer/dump_and_mem.png)

native_hook_statistic 表记录内存申请/释放的统计信息。通过 callChainId 区分一组调用堆栈。每个统计事件将记录当前事件的 callChainId，并统计当前调用栈内存分配/释放的总次数和总大小。
![GitHub Logo](../../figures/traceStreamer/db_native_hook_statistic.png)

### 查询举例

- 已知 tid = 123，查看当前线程的所有堆内存变化信息，可以使用如下 SQL 语句：  
  `select native_hook.* from thread, native_hook where thread.tid = 123 and thread.id = native_hook.itid`
- 已知 callchainid = 1, 查看当前内存变化调用堆栈  
  `select * from native_hook_frame where callchain_id = 1`
- 已知 callchainid = 1, 查看当前内存变化调用堆栈对应的统计信息
  `select * from native_hook_statistic where callchain_id = 1`

### 日志表与进程线程表关系图

log 表记录日志信息。可以根据 seq 字段的连续性，来判断是否存在日志丢失的情况。  
![GitHub Logo](../../figures/traceStreamer/log.png)

### 查询举例

- 已知 tid = 123，查看当前线程的所有 error 级别的日志，可以使用如下 SQL 语句：  
  `select * from log where tid = 123 and level = "error"`

### perf 表之间关系图

- perf_report：此表记录 Hiperf 工具采集数据时的配置信息。
- perf_thread：此表记录 hiperf 采集到的进程和线程数据。
- perf_sample：此表中记录 Hiperf 工具的采样信息。sample_id 唯一表识一次采样记录，与 perf_callchain 表中的 sample_id 字段相关联。thread_id 为线程号。与 perf_thread 表中的 thread_id 字段相关联。event_type_id 为当前采样的事件类型 id，与 perf_report 表中的 id 字段相关联。
- perf_callchain：此表格记录的是调用栈信息。
- Perf_files：此表格主要存放着获取到的函数符号表和文件信息。file_id 唯一表识一个文件，与 perf_callchain 表中的 file_id 字段相关联。

![GitHub Logo](../../figures/traceStreamer/perf.png)

### 查询举例

- 已知同步后的时间戳为 28463134340470，查询采样数据  
  `select * from perf_sample where timestamp_trace = 28463134340470`

- 已知同步后的时间戳为 28463134340470，查询采样数据对应的的调用栈信息  
  `select A.* from perf_callchain as A, perf_sample as B where B.timestamp_trace = 28463134340470 and A.sample_id = B.sample_id`

- 已知同步后的时间戳为 28463134277762，查询采样数据的函数名及文件路径  
  `select A.*, B.name, C.path from perf_sample as A, perf_callchain as B, perf_files as C where A.timestamp_trace = 28463134277762 and B.sample_id = A.sample_id and B.callchain_id = 0 and B.file_id = C.file_id and C.serial_id = 0`

- 已知线程号为 6700，查询所有的采样记录  
  `select * from perf_sample where thread_id = 6700`

- 已知进程号为 7863，查询所有的采样记录  
  `select A.* from perf_sample as A, perf_thread as B where B.process_id = 7863 and A.thread_id = B.thread_id`

- 查询所有采样对应的事件类型  
  `select A.*, B.report_value from perf_sample as A, perf_report as B where A.event_type_id = B.id`

### 帧渲染表之间的关系图

frame_slice: 记录 RS(RenderService)和应用的帧渲染。  
gpu_slice: 记录 RS 的帧对应的 gpu 渲染时长。  
frame_maps: 记录应用到 RS 的帧的映射关系。  
![GitHub Logo](../../figures/traceStreamer/frames.jpg)

### 查询示例

- 已知进程，查询进程对应的实际渲染帧  
  `select * from frame_slice where ipid = 1`

- 已知进程的实际渲染帧的 dst 为 12，求其对应的 RS 进程的渲染帧  
  `select * from frame_slice where id = 12 `

- 已知 RS 的渲染帧在 frame_slice 中所在行是 14，求其对应的 GPU 渲染时长  
  `select * from gpu_slice where frame_row = 14`

### JS 内存数据表关系图

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 的时间轴信息
![1683163373206](image/des_tables/js_heap_nodes.png)

## TraceStreamer 输出数据库表格详细介绍

### app_name 表

#### 表结构

| Columns Name | SQL TYPE |
| ------------ | -------- |
| id           | INT      |
| flag         | INT      |
| app_name     | INT      |
| app_key      | INT      |

#### 表描述

记录 HiSysevent 上报事件中的 IDE 相关事件中 APPNAME 的表关联信息。

#### 字段详细描述

- id：用于与表 hisys_event_measure 表中的 key_id 字段做对应
- app_name：对应的事件的信息 ID
- app_key：对应的事件的 APPNAME 字段的信息 ID

### args 表

#### 表结构

| Columns Name | SQL TYPE |
| ------------ | -------- |
| id           | INT      |
| key          | INT      |
| datatype     | INT      |
| value        | INT      |
| argset       | INT      |

#### 表描述

记录方法的参数集合。

#### 字段详细描述

- key：键
- datatype：数据类型
- value：取值
- argset：参数集合

### bio_latency_sample 表

#### 表结构

| Columns Name | SQL TYPE |
| ------------ | -------- |
| id           | INT      |
| callchain_id | INT      |
| datatype     | INT      |
| type         | INT      |
| ipid         | INT      |
| itid         | INT      |
| start_ts     | INT      |
| end_ts       | INT      |
| latency_dur  | INT      |
| tier         | INT      |
| size         | INT      |
| block_number | TEXT     |
| path         | TEXT     |
| dur_per_4k   | INT      |

#### 表描述

记录 IO 操作相关方法调用，及调用栈数据。

#### 字段详细描述

- callchain_id：调用栈的唯一标识。与 ebpf_callstack 表中 Callchain_id 字段关联
- type：事件类型其取值为枚举类型（DATA_READ，DATA_WRITE，METADATA_READ，- METADATA_WRITE，PAGE_IN，PAGE_OUT）
- ipid：TS 内部进程号
- itid：TS 内部线程号
- start_ts：开始时间
- end_ts：结束时间
- latency_dur：总延迟
- tier：优先级
- size：文件大小
- block_number：数据量大小（一般为 4K）
- path：路径 id
- dur_per_4k：每 4k 数据的平均延迟

### callstack 表

#### 表结构

| Columns Name | SQL TYPE |
| ------------ | -------- |
| id           | INT      |
| ts           | INT      |
| dur          | INT      |
| callid       | INT      |
| cat          | TEXT     |
| identify     | INT      |
| name         | TEXT     |
| depth        | INT      |
| cookie       | INT      |
| parent_id    | INT      |
| argsetid     | INT      |
| chainId      | TEXT     |
| spanId       | TEXT     |
| parentSpanId | TEXT     |
| flag         | TEXT     |
| args         | TEXT     |

#### 表描述

记录调用堆栈和异步调用信息，其中 depth,stack_id 和 parent_stack_id 仅在非异步的调用中有效。当 cookid 不为空时，为异步调用，此时 callid 为进程唯一号，否则为线程唯一号。

#### 字段详细描述

- dur：调用时长
- callid：调用者的 ID，比如针对线程表里面的 id
- identify：调用栈的名字，与表 dataDict 相关联能够取出其 string 值
- name：调用名称
- depth：调用深度
- parent_id：父调用的 id
- spanId：分布式调用关联关系
- flag：C 表示分布式调用发送方，S 表示接受方
- args：分布式调用函数参数

### clk_event_filter 表

#### 表结构

| Columns Name | SQL TYPE |
| ------------ | -------- |
| id           | INT      |
| type         | TEXT     |
| name         | TEXT     |
| cpu          | INT      |

#### 表描述

记录时钟信息。

#### 字段详细描述

- Type：时钟事件类型
- Name：时钟事件名称

### clock_event_filter 表

#### 表结构

| Columns Name | SQL TYPE |
| ------------ | -------- |
| id           | INT      |
| type         | TEXT     |
| name         | TEXT     |
| cpu          | INT      |

#### 表描述

此结构用来维护时钟事件，cpu 与唯一的 ID 做关联。

#### 主要字段描述

- Type：时钟事件类型
- Name：时钟事件名称

### cpu_measure_filter 表

#### 表结构

| Columns Name | SQL TYPE |
| ------------ | -------- |
| id           | INT      |
| type         | TEXT     |
| name         | TEXT     |
| cpu          | INT      |

#### 表描述

将 cpu 号作为 key1，cpu 的频率，空闲等状态作为 key2，唯一确定一个 filter_id。

#### 主要字段描述

- Id(filterid), cpu：事件名称，cpu 号

### cpu_usage 表

#### 表结构

| Columns Name | SQL TYPE |
| ------------ | -------- |
| ts           | INT      |
| dur          | INT      |
| total_load   | REAL     |
| user_load    | REAL     |
| system_load  | REAL     |
| process_num  | INT      |

#### 表描述

记录了与 CPU 使用率相关的数据。

#### 主要字段描述

- total_load：总负荷
- user_load：用户负载
- system_load：系统负载
- process_num：线程数

### data_dict 表

#### 表结构

| Columns Name | SQL TYPE |
| ------------ | -------- |
| id           | INT      |
| data         | TEXT     |

#### 表描述

此表记录了一个数据类型 ID 和字符串的映射。

#### 主要字段描述

- id：索引值
- data：字符串

### data_type 表

#### 表结构

| Columns Name | SQL TYPE |
| ------------ | -------- |
| id           | INT      |
| typeId       | INT      |
| desc         | TEXT     |

#### 表描述

此表记录了一个数据类型 ID 和数据描述的映射。

#### 主要字段描述

- typeId:：数据类型 id
- Desc：数据类型描述

### diskio 表

#### 表结构

| Columns Name   | SQL TYPE |
| -------------- | -------- |
| ts             | INT      |
| dur            | INT      |
| rd             | INT      |
| wr             | INT      |
| rd_speed       | REAL     |
| wr_speed       | REAL     |
| rd_count       | INT      |
| wr_count       | INT      |
| rd_count_speed | REAL     |
| wr_count_speed | REAL     |

#### 表描述

记录了与磁盘读写相关的数据。

#### 主要字段描述

- rd_sectors_kb：读数据的速度
- wr_sectors_kb：写入数据的速度
- ts：时间戳

### ebpf_callstack 表

#### 表结构

| Columns Name | SQL TYPE |
| ------------ | -------- |
| id           | INT      |
| callchain_id | INT      |
| depth        | TEXT     |
| ip           | TEXT     |
| symbols_id   | INT      |
| file_path_id | INT      |

#### 表描述

记录了与磁盘读写相关的数据。

#### 主要字段描述

- callchain_id：调用栈的唯一标识
- depth：调用栈深度。取值为零时表示栈顶
- ip：调用栈 ip
- symbols_id：调用栈函数名称, 与 data_dict 中的 id 字段关联
- file_path_id：调用栈函数所属文件路径, 与 data_dict 中的 id 字段关联

### file_system_sample 表

#### 表结构

| Columns Name    | SQL TYPE |
| --------------- | -------- |
| callchain_id    | INT      |
| type            | INT      |
| ipid            | INT      |
| itid            | INT      |
| start_ts        | INT      |
| end_ts          | INT      |
| dur             | INT      |
| return_value    | TEXT     |
| error_code      | TEXT     |
| fd              | INT      |
| file_id         | INT      |
| size            | INT      |
| first_argument  | TEXT     |
| second_argument | TEXT     |
| third_argument  | TEXT     |
| fourth_argument | TEXT     |

#### 表描述

记录了调用栈的相关信息。

#### 主要字段描述

- callchain_id：调用栈信息 ID 与 file_system_callstack 表中 call_chain_id 字段相关联
- type：对应文件操作 open，close，read，write
- ipid：线程所属的进程 ID
- start_ts：开始时间
- end_ts：结束时间
- dur：耗时
- return_value：文件操作的返回值
- error_code：文件操作发生错误时的错误码
- fd：文件描述符 fd
- file_id：当 type 为 open，close 时为其操作的文件路径，当 type 为 read，write 时为固定字段（null）
- size：在 type 为 read，write 时对应的文件的读或者写的大小
- first_argument：参数一
- second_argument：参数二
- third_argument：参数三
- fourth_argument：参数四

### hidump 表

#### 表结构

| Columns Name | SQL TYPE |
| ------------ | -------- |
| id           | INT      |
| ts           | INT      |
| fps          | INT      |

#### 表描述

此表记录了设备的帧率信息，fps。

#### 相关字段描述

- fps：帧率值

### hisys_event_measure 表

#### 表结构

| Columns Name | SQL TYPE |
| ------------ | -------- |
| serial       | INT      |
| ts           | INT      |
| name_id      | INT      |
| key_id       | INT      |
| type         | INT      |
| int_value    | REAL     |
| string_value | TEXT     |

#### 表描述

记录所有的 system event 事件的相关数据，及其相关表的映射信息。

#### 相关字段描述

- serial：每条数据过来携带唯一一条 id 作为标识
- name_id：存放事件对应的 ID，与 data_dict 表相关联可以取出对应的字段
- key_id：存放事件包含的字段的 ID，与表 app_name 的 id 字段相关联，找到 app_name 表的 id 字段对应行的 app_key 字段与表 data_dict 表相关联取出对应的字段
- type：存放事件所包含的字段的值所属的类型为 int 型还是 string（0 为 int，1 为 string）
- int_value：存放本事件所包含的字段的 int 型的值
- string_value：存放本事件所包含的字段的 string 型的值

### instant 表

#### 表结构

| Columns Name | SQL TYPE |
| ------------ | -------- |
| ts           | INT      |
| name         | TEXT     |
| ref          | INT      |
| wakeup_from  | INT      |
| ref_type     | TEXT     |
| value        | REAL     |

#### 表描述

记录了系统中的 waking 和 wakeup 事件。

#### 字段描述

- ts：唤醒时间
- name：唤醒事件的名称
- ref：索引号
- wakeup_from：唤醒当前线程的内部线程号（itid）
- ref_type：描述了 value 字段的类型（一般取值为 itid）
- value：一般为当前线程的内部线程号取值

### irq 表

#### 表结构

| Columns Name | SQL TYPE |
| ------------ | -------- |
| id           | INT      |
| ts           | INT      |
| dur          | INT      |
| callid       | INT      |
| cat          | TEXT     |
| name         | TEXT     |
| depth        | INT      |
| cookie       | INT      |
| parent_id    | INT      |
| argsetid     | INT      |
| chainId      | TEXT     |
| spanId       | TEXT     |
| parentSpanId | TEXT     |
| flag         | TEXT     |
| args         | TEXT     |

#### 表描述

记录中断相关事件。

#### 相关字段描述

- dur：调用中断时长
- callid：调用中断者的 ID，比如针对线程表里面的 id
- cat：调用栈数据类型（取值范围：irq，softirq...）
- name：调用中断的名称
- depth：中断调用的深度
- parent_id：父调用中断的 id
- spanId：分布式调用中断关联关系

### js_config 表

#### 表结构

| Columns Name          | SQL TYPE |
| --------------------- | -------- |
| pid                   | INT      |
| type                  | INT      |
| interval              | INT      |
| capture_numeric_value | INT      |
| trace_allocation      | INT      |
| enable_cpu_profiler   | INT      |
| cpu_profiler_interval | INT      |

#### 表描述

记录 arkTs 数据采集的相关配置。

#### 相关字段描述

- 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 表

#### 表结构

| Columns Name   | SQL TYPE |
| -------------- | -------- |
| function_id    | INT      |
| function_index | INT      |
| script_id      | INT      |
| url_index      | INT      |
| line_number    | INT      |
| column_number  | INT      |
| hit_count      | INT      |
| children       | INT      |
| parent_id      | INT      |

#### 表描述

记录 cpu profiler 中 node 节点的数据。

#### 相关字段描述

- 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 号。

### js_cpu_profiler_sample 表

#### 表结构

| Columns Name | SQL TYPE |
| ------------ | -------- |
| id           | INT      |
| function_id  | INT      |
| start_time   | INT      |
| end_time     | INT      |
| dur          | INT      |

#### 表描述

记录了 cpu profiler 中 sample 节点的数据。

#### 相关字段描述

- id: ts 内部 ID 号。
- function_id: 函数的 ID 号。
- start_time: 数据上报的起始时间。
- end_time: 数据上报的终止时间。
- dur: 数据上报的间隔时间。

### js_heap_edges 表

#### 表结构

| Columns Name  | SQL TYPE |
| ------------- | -------- |
| file_id       | INT      |
| edge_index    | INT      |
| type          | INT      |
| name_or_index | INT      |
| to_node       | INT      |
| from_node_id  | INT      |
| to_node_id    | INT      |

#### 表描述

记录 js 内存数据类对象对应的成员的信息。

#### 相关字段描述

- file_id：文件 ID
- edge_index：成员的索引号
- type：成员的类型，取值范围为 js_heap_info 表中的 edge_types
- name_or_index：数据名称，取值为 js_heap_string 表中的下标索引
- to_node：此成员指向的类对象在 nodes 数组中的索引
- from_node_id：类对象 ID，该类对象指向此成员数据
- to_node_id：此成员指向到的类对象 nodes 数组中的 ID

### js_heap_files 表

#### 表结构

| Columns Name | SQL TYPE |
| ------------ | -------- |
| id           | INT      |
| file_name    | TEXT     |
| start_time   | INT      |
| end_time     | INT      |
| pid          | INT      |

#### 表描述

记录了 js 内存数据的文件名称和时间。

#### 相关字段描述

- id：文件 ID
- file_name：文件名称
- start_time：数据抓取的起始时间
- end_time：数据抓取的终止时间
- pid：进程号

### js_heap_info 表

#### 表结构

| Columns Name | SQL TYPE |
| ------------ | -------- |
| file_id      | INT      |
| key          | TEXT     |
| type         | INT      |
| int_value    | INT      |
| str_value    | TEXT     |

#### 表描述

记录了 js 内存数据类型，如 nodes 和 edges 的字段类型和数据总数。

#### 相关字段描述

- file_id：文件 ID
- key：类型名称
- type：数据类型索引
- int_value：int 类型的数据值，如 count 类型数据
- str_value：string 类型的数据值，如 typename

### js_heap_location 表

#### 表结构

| Columns Name | SQL TYPE |
| ------------ | -------- |
| file_id      | INT      |
| object_index | INT      |
| script_id    | INT      |
| line         | INT      |
| column       | INT      |

#### 表描述

记录了 js 内存 location 节点相关数据，此表目前无抓取到的数据。

#### 相关字段描述

- file_id：文件 ID
- object_index：与 location 关联的类对象的索引，取值为 js_heap_nodes 的下标索引
- script_id：关联到的类对象所在文件的绝对路径 ID
- line：在类对象所在的文件中的行号
- column：在类对象所在的文件中的列号

### js_heap_nodes 表

#### 表结构

| Columns Name  | SQL TYPE |
| ------------- | -------- |
| file_id       | INT      |
| node_index    | TEXT     |
| type          | INT      |
| name          | INT      |
| id            | TEXT     |
| self_size     | INT      |
| edge_count    | INT      |
| trace_node_id | INT      |
| detachedness  | INT      |

#### 表描述

记录了 js 内存数据中类对象的数据。

#### 相关字段描述

- file_id：文件 ID
- node_index：类对象的索引
- type：类对象的类型
- name：类对象的名称
- id：类对象的唯一 ID
- self_size：该类对象所有成员的大小（以字节为单位）
- edge_count：该类对象指向的类成员的个数
- trace_node_id：该类对象关联到 js_heap_trace_node 表中的调用栈 ID
- detachedness：是否可以从 window 全局对象访问此节点，0 表示是，1 表示否

### js_heap_sample 表

#### 表结构

| Columns Name     | SQL TYPE |
| ---------------- | -------- |
| file_id          | INT      |
| timestamp_us     | INT      |
| last_assigned_id | INT      |

#### 表描述

记录了 timeline 模式下的时间轴信息。

#### 相关字段描述

- file_id：文件 ID
- timestamp_us：时间信息
- last_assigned_id：当前时间点的 id

### js_heap_string 表

#### 表结构

| Columns Name | SQL TYPE |
| ------------ | -------- |
| file_id      | INT      |
| file_index   | INT      |
| string       | TEXT     |

#### 表描述

记录了 js 内存数据中的字符串。

#### 相关字段描述

- file_id：文件 ID
- file_index：索引
- string：对应的字符串信息

### js_heap_trace_function_info 表

#### 表结构

| Columns Name   | SQL TYPE |
| -------------- | -------- |
| file_id        | INT      |
| function_index | INT      |
| function_id    | INT      |
| name           | INT      |
| script_name    | INT      |
| script_id      | INT      |
| line           | INT      |
| column         | INT      |

#### 表描述

记录了 timeline 模式下的调用栈的每个函数信息。

#### 相关字段描述

- file_id：文件 ID
- function_index：函数索引
- function_id：函数 ID
- name：函数名称
- script_name：关联到的类对象所在文件的绝对路径名称
- script_id：关联到的类对象所在文件的绝对路径 ID
- line：在类对象所在的文件中的行号
- column：在类对象所在的文件中的列号

### js_heap_trace_node 表

#### 表结构

| Columns Name        | SQL TYPE |
| ------------------- | -------- |
| file_id             | INT      |
| id                  | INT      |
| function_info_index | INT      |
| count               | INT      |
| size                | INT      |
| parent_id           | INT      |

#### 表描述

记录了 timeline 模式下的调用栈的信息。

#### 相关字段描述

- file_id：文件 ID
- id：调用栈节点索引
- function_info_index：函数信息索引
- count：调用栈个数
- size：调用栈大小
- parent_id：调用栈父节点

### app_startup 表

#### 表结构

| Columns Name | SQL TYPE |
| ------------ | -------- |
| call_id      | INT      |
| ipid         | INT      |
| tid          | INT      |
| start_time   | INT      |
| end_time     | INT      |
| start_name   | INT      |
| packed_name  | INT      |

#### 表描述

记录了应用启动的相关信息。

#### 相关字段描述

- call_id：调用者的 ID，比如针对线程表里面的 id
- ipid：内部进程号
- tid：内部线程号
- start_time：阶段开始时间
- end_time：阶段结束时间
- start_name：阶段名称
- packed_name：应用名称

### static_intialize 表

#### 表结构

| Columns Name | SQL TYPE |
| ------------ | -------- |
| call_id      | INT      |
| ipid         | INT      |
| tid          | INT      |
| start_time   | INT      |
| end_time     | INT      |
| so_name      | INT      |
| depth        | INT      |

#### 表描述

记录了 so 初始化的相关信息。

#### 相关字段描述

- call_id：调用者的 ID，比如针对线程表里面的 id
- ipid：内部进程号
- tid：内部线程号
- start_time：阶段开始时间
- end_time：阶段结束时间
- so_name：so 文件名称
- depth：泳道图的深度

### live_process 表

#### 表结构

| Columns Name      | SQL TYPE |
| ----------------- | -------- |
| ts                | INT      |
| dur               | INT      |
| cpu_time          | INT      |
| process_id        | INT      |
| process_name      | TEXT     |
| parent_process_id | INT      |
| uid               | INT      |
| user_name         | TEXT     |
| cpu_usage         | REAL     |
| pss_info          | INT      |
| thread_num        | INT      |
| disk_writes       | INT      |
| disk_reads        | INT      |

#### 表描述

记录了一些实时的进程中执行的一些数据（Monitor）。

#### 主要字段描述

- process_id：进程 id
- process_name：进程名
- parent_process_id：父进程的 id
- uid：用户 id
- user_name：用户名
- cpu_usage：cpu 使用率
- pss_info：进程信息
- thread_num：线程数量
- disk_writes：磁盘写量
- disk_reads：磁盘读量

### log 表

#### 表结构

| Columns Name | SQL TYPE |
| ------------ | -------- |
| seq          | INT      |
| ts           | INT      |
| pid          | INT      |
| tid          | INT      |
| level        | TEXT     |
| tag          | TEXT     |
| context      | TEXT     |
| origints     | INT      |

#### 表描述

记录日志信息。

#### 关键字段描述

- Seq：日志序号，保证日志解析的准确性
- Ts：打印日志时间
- Pid：日志的进程号
- Tid：日志的线程号
- Level：日志级别
- Tag：日志标签
- Context：日志内容

### measure 表

#### 表结构

| Columns Name | SQL TYPE |
| ------------ | -------- |
| type         | TEXT     |
| ts           | INT      |
| dur          | INT      |
| value        | INT      |
| filter_id    | INT      |

#### 表描述

记录所有的计量值。

#### 关键字段描述

- type：固定字段（measure）
- ts：事件时间
- dur：该值持续的时长
- value：数值
- filter_id：对应 filter 表中的 ID

### measure_filter 表

#### 表结构

| Columns Name      | SQL TYPE |
| ----------------- | -------- |
| id                | INT      |
| type              | TEXT     |
| name              | TEXT     |
| source_arg_set_id | INT      |

#### 表描述

记录一个递增的 filterid 队列，所有其他的 filter 类型在获取过程中，均从此数据列表中获取下一个可用的 filter_id 并做记录。

#### 字段详细描述

过滤分类（type），过滤名称（key2），数据 ID(key1)。  
数据 ID 在 process_measure_filter, sys_event_filter 中作为 id。

### meta 表

#### 表结构

| Columns Name | SQL TYPE |
| ------------ | -------- |
| name         | TEXT     |
| value        | TEXT     |

#### 表描述

此表记录了数据解析或导出时的一些现场数据，比如使用的 TraceStreamer 版本， 工具的发布时间，数据解析的时间，数据的持续时长，以及原始数据的格式。

#### 主要字段描述

- Name：指定元数据的 key
- Value：指定元数据的 value

### native_hook 表

#### 表结构

| Columns Name     | SQL TYPE |
| ---------------- | -------- |
| id               | INT      |
| callChainId      | INT      |
| ipid             | INT      |
| itid             | INT      |
| event_type       | TEXT     |
| sub_type_id      | NUM      |
| start_ts         | INT      |
| end_ts           | INT      |
| dur              | INT      |
| addr             | INT      |
| heap_size        | INT      |
| all_heap_size    | INT      |
| current_size_dur | INT      |
| last_lib_id      | INT      |

#### 表描述

记录 native_hook 抓取的某个进程的堆内存，内存映射相关数据。

#### 关键字段描述

- callChainId：唯一标识一条 native_hook 数据
- event_type：事件类型取值范围（AllocEvent,FreeEvent,MmapEvent, MunmapEvent）
- sub_type_id：子事件类型(只有 sub_type 字段为 MmapEvent 时，该字段才会有值)
- start_ts：申请内存开始时间
- end_ts：释放内存时间
- Dur：申请内存活跃时间
- Addr：申请内存地址
- mem_size：申请或释放内存大小
- all_mem_size：从采集数据开始到当前时刻，申请并活跃的内存总量。 event_type 为 AllocEvent 或者 FreeEvent 时，表示活跃的堆内存总量。当 event_type 为 MmapEvent 或者 MunmapEvent 时，表示活跃的映射内存总量
- current_size_dur：表示当前活跃内存总量的持续时间
- last_lib_id：函数调用栈他最后一个函数所属的文件路径，除了文件名中带 musl 和 libc++

### native_hook_frame 表

#### 表结构

| Columns Name  | SQL TYPE |
| ------------- | -------- |
| id            | INT      |
| callchain_id  | INT      |
| depth         | INT      |
| symbol_id     | INT      |
| file_id       | INT      |
| offset        | INT      |
| symbol_offset | INT      |

#### 表描述

记录了内存的申请和释放的堆栈。

#### 相关字段描述

- callchain_id：标识一组调用堆栈
- depth：调用栈深度
- symbol_id：函数名
- file_id：函数所属文件

### native_hook_statistic 表

#### 表结构

| Columns Name  | SQL TYPE |
| ------------- | -------- |
| id            | INT      |
| callchain_id  | INT      |
| ipid          | INT      |
| ts            | INT      |
| type          | INT      |
| apply_count   | INT      |
| release_count | INT      |
| apply_size    | INT      |
| release_size  | INT      |

#### 表描述

该表记录了内存申请/释放的统计信息。

#### 关键字段描述

- callchain_id：内存分配的回调链 id
- ipid：进程 id
- ts：统计数据上报时间
- type：事件类型，0 代表 malloc 事件，1 代表 mmap 事件
- apply_count：当前调用栈内存分配总次数
- release_count：当前调用栈内存释放总次数
- apply_size：当前调用栈累计分配总大小
- release_size：当前调用栈累计释放总大小

### network 表

#### 表结构

| Columns Name   | SQL TYPE |
| -------------- | -------- |
| ts             | INT      |
| dur            | INT      |
| tx             | INT      |
| rx             | INT      |
| tx_speed       | REAL     |
| rx_speed       | REAL     |
| packet_in      | INT      |
| packet_in_sec  | REAL     |
| packet_out     | INT      |
| packet_out_sec | REAL     |
| net_type       | TEXT     |

#### 表描述

记录了网络数据传输相关的信息。

#### 主要字段描述

- tv_sec：时间，秒为单位
- tv_nsec：时间，纳秒为单位
- tx_bytes：网络数据的写入量
- rx_bytes：网络数据的读取量

### paged_memory_sample 表

#### 表结构

| Columns Name | SQL TYPE |
| ------------ | -------- |
| id           | INT      |
| callchain_id | INT      |
| type         | INT      |
| ipid         | INT      |
| start_ts     | INT      |
| end_ts       | INT      |
| dur          | INT      |
| size         | INT      |
| addr         | TEXT     |
| itid         | INT      |

#### 表描述

记录了网络数据传输相关的信息。

#### 主要字段描述

- callchain_id： 取值相同的一组数据，表示一个完整的调用栈
- type：事件类型
- ipid：TS 内部进程号
- start_ts：开始时间
- end_ts：结束时间
- dur：持续时间
- size：操作页数
- itid：TS 内部线程号

### perf_callchain 表

#### 表结构

| Columns Name  | SQL TYPE |
| ------------- | -------- |
| id            | INT      |
| callchain_id  | INT      |
| depth         | INT      |
| vaddr_in_file | INT      |
| file_id       | INT      |
| symbol_id     | INT      |
| name          | TEXT     |

#### 表描述

记录了 Hiperf 采样数据的调用栈信息。

#### 主要字段描述

- callchain_id：标识一组调用堆栈
- depth：调用栈深度
- vaddr_in_file：函数在文件中的虚拟地址
- file_id：与 PerfFiles 中的 file_id 字段相关联
- symbol_id：与 PerfFiles 中的 symbol_id 相关联
- name：函数名

### perf_files 表

#### 表结构

| Columns Name | SQL TYPE |
| ------------ | -------- |
| id           | INT      |
| file_id      | INT      |
| serial_id    | INT      |
| symbol       | TEXT     |
| path         | TEXT     |

#### 表描述

记录 Hiperf 工具采集到的函数符号表和文件名。

#### 主要字段描述

- file_id：文件编号
- serial_id：一个文件中可能有多个函数，serial_id 表示函数的编号
- symbol：函数名
- path：文件路径

### perf_report 表

#### 表结构

| Columns Name | SQL TYPE |
| ------------ | -------- |
| id           | INT      |
| report_type  | TEXT     |
| report_value | TEXT     |

#### 表描述

记录 Hiperf 工具采集数据时的配置信息。包括：抓取的事件类型，抓取数据的命令， 抓数据时指定的进程名称。

#### 主要字段描述

- report_type：数据类型。取值只有三种类型：config_name（事件类型）, workload（抓取的进程名）, cmdline（抓取命令）
- report_value：对应类型的取值

### perf_sample 表

#### 表结构

| Columns Name    | SQL TYPE |
| --------------- | -------- |
| id              | INT      |
| callchain_id    | INT      |
| timestamp       | INT      |
| thread_id       | INT      |
| event_count     | INT      |
| event_type_id   | INT      |
| timestamp_trace | INT      |
| cpu_id          | INT      |
| thread_state    | TEXT     |

#### 表描述

记录 Hiperf 工具的采样信息。

#### 主要字段描述

- timestamp：未进行时钟源同步的时间戳
- thread_id：线程号
- event_count：采样统计
- event_type_id：事件类型编号。与 PerfReport 表的 id 字段相关联
- timestamp_trace：时钟源同步后的时间戳
- cpu_id：cpu 核编号
- thread_state：线程状态。采样对应 Sched_Waking 事件时，为 Runing;对应 Sched_Switch 事件时，为 Suspend。其余事件类型，为“-”

### perf_thread 表

#### 表结构

| Columns Name | SQL TYPE |
| ------------ | -------- |
| id           | INT      |
| thread_id    | INT      |
| process_id   | INT      |
| thread_name  | TEXT     |

#### 表描述

记录 Hiperf 工具采集到的进程和线程数据。

#### 主要字段描述

- thread_id：线程号
- process_id：进程号
- thread_name：线程名

### process 表

#### 表结构

| Columns Name | SQL TYPE |
| ------------ | -------- |
| id           | INT      |
| ipid         | INT      |
| type         | TEXT     |
| pid          | INT      |
| name         | TEXT     |
| start_ts     | INT      |
| switch_count | INT      |
| thread_count | INT      |
| slice_count  | INT      |
| mem_count    | INT      |

#### 表描述

记录了进程相关数据。

#### 关键字段描述

- id：进程在数据库重新重新定义的 id，从 0 开始序列增长
- ipid：TS 内部进程 id
- type：固定取值：process
- pid：进程的真实 id
- name：进程名字
- start_ts：开始时间
- switch_count：统计内部有多少个线程有切换
- thread_count：统计其线程个数
- slice_count：进程内有多个线程有 slice 数据
- mem_count：进程是否有内存数据

### process_filter 表

#### 表结构

| Columns Name | SQL TYPE |
| ------------ | -------- |
| id           | INT      |
| type         | TEXT     |
| name         | TEXT     |
| ipid         | INT      |

#### 表描述

将进程 ID 作为 key1，进程的内存，界面刷新，屏幕亮度等信息作为 key2，唯一确定一个 filter_id, filter_id 同时被记录在 filter 表中。

#### 主要字段描述

- id：进程 id
- type：固定取值：process_filter
- name：进程名
- ipid：该进程表中的 id 与 process 表中的 id 相关联

### process_measure 表

#### 表结构

| Columns Name | SQL TYPE |
| ------------ | -------- |
| type         | TEXT     |
| ts           | INT      |
| value        | NUM      |
| filter_id    | INT      |

#### 表描述

保存进程的内存，堆栈值等所有计量值信息。

#### 字段详细描述

- ts：事件时间
- value：数值
- filter_id：对应 process_measure_filter 表中的 ID

### process_measure_filter 表

#### 表结构

| Columns Name | SQL TYPE |
| ------------ | -------- |
| id           | INT      |
| type         | TEXT     |
| name         | TEXT     |
| ipid         | INT      |

#### 表描述

将进程 ID 作为 key1，进程的内存，界面刷新，屏幕亮度等信息作为 key2，唯一确定一个 filter_id, filter_id 同时被记录在 measure_filter 表中。

#### 字段详细描述

- type：固定取值：process_measure_filter
- name：cpu 状态名
- ipid：进程内部编号

### raw 表

#### 表结构

| Columns Name | SQL TYPE |
| ------------ | -------- |
| id           | INT      |
| type         | TEXT     |
| ts           | INT      |
| name         | TEXT     |
| cpu          | INT      |
| itid         | INT      |

#### 表描述

记录了系统中的 waking、wakup、cpu_idel、cpu_frequency 数据。

#### 相关字段描述

- type：固定字段（raw）
- name：调度名称（取值：cpu_idle，sched_wakeup，sched_waking）
- cpu：事件发生在哪个 CPU
- itid：时间对应哪个 utid

### sched_slice 表

#### 表结构

| Columns Name | SQL TYPE |
| ------------ | -------- |
| id           | INT      |
| type         | TEXT     |
| ts           | INT      |
| dur          | INT      |
| ts_end       | INT      |
| cpu          | INT      |
| itid         | INT      |
| end_state    | TEXT     |
| priority     | INT      |

#### 表描述

此数据结构主要作为 ThreadState 的上下文使用，这张表是 sched_switch 事件的原始记录。

#### 主要字段描述

- ts：事件发生事件
- type：固定字段（sched_slice）
- dur：状态持续时长
- ts_end：状态结束时长
- cpu：事件发生在哪个 cpu
- itid：事件对应哪个 utid
- end_state：线程的终结状态

### smaps 表

#### 表结构

| Columns Name  | SQL TYPE |
| ------------- | -------- |
| id            | INT      |
| timestamp     | INT      |
| start_addr    | TEXT     |
| end_addr      | TEXT     |
| dirty         | INT      |
| swapper       | INT      |
| resident_size | INT      |
| pss           | INT      |
| virtaul_size  | INT      |
| reside        | REAL     |
| protection_id | INT      |
| path_id       | INT      |

#### 表描述

记录进程的内存消耗的相关信息采样。

#### 主要字段描述

- id：状态持续时长
- timestamp：事件发生事件
- start_addr：内存段地址的起始位置
- end_addr：内存段地址的结束位置
- dirty：其他进程共享的被写的页的大小 + 已被改写的私有页面的大小
- swapper：存在于交换分区的数据大小
- resident_size：实际分配的内存大小
- pss：平摊计算后的实际物理使用内存
- virtaul_size：虚拟内存空间的大小
- reside：实际分配的内存大小与虚拟内存空间的大小的比
- protection_id：内存段的权限 id 与表 data_dict 的 id 字段相关联
- path_id：如果区域是从文件映射的，则这是文件的名称对应的 id 序号与表 data_dict 的 id 字段相关联

### stat 表

#### 表结构

| Columns Name | SQL TYPE |
| ------------ | -------- |
| event_name   | TEXT     |
| stat_type    | TEXT     |
| count        | INT      |
| serverity    | TEXT     |
| source       | TEXT     |

#### 表描述

此结果用来统计数据解析中各类数据的数据条数，数据和合法性，数据的匹配程度（begin-end），数据的损失等，查看此结构对应的表，可对数据源有基本的了解。

#### 主要字段描述

- event_name：数据类型
- stat_type：数据状态
- count：数据条数
- severity：严重级别
- source：数据来源

### symbols 表

#### 表结构

| Columns Name | SQL TYPE |
| ------------ | -------- |
| id           | INT      |
| funcname     | TEXT     |
| addr         | INT      |

#### 表描述

此表记录了被调用函数与其地址的映射关系。

#### 相关字段描述

- funcname：系统调用名称
- adr：系统调用地址

### syscall 表

#### 表结构

| Columns Name | SQL TYPE |
| ------------ | -------- |
| syscall_num  | INT      |
| type         | TEXT     |
| ipid         | INT      |
| ts           | INT      |
| ret          | INT      |

#### 表描述

记录用户空间函数与内核空间函数相互调用记录。

#### 相关字段描述

- syscall_num：系统调用的序号
- type：固定取值：enter 或者 exit
- ipid：线程所属的进程 ID
- ts：时间戳
- ret：返回值，在 type 为 exit 时有效

### sys_event_filter 表

#### 表结构

| Columns Name | SQL TYPE |
| ------------ | -------- |
| id           | INT      |
| type         | TEXT     |
| name         | TEXT     |

#### 表描述

记录所有的 filter。

#### 相关字段描述

- type：文件类型
- name：文件名

### sys_mem_measure 表

#### 表结构

| Columns Name | SQL TYPE |
| ------------ | -------- |
| type         | TEXT     |
| ts           | INT      |
| value        | INT      |
| filter_id    | INT      |

#### 表描述

记录系统内存与系统虚拟内存。

#### 相关字段描述

- ts：事件时间
- value：数值
- filter_id：对应 filter 表中的 ID

### thread 表

#### 表结构

| Columns Name   | SQL TYPE |
| -------------- | -------- |
| id             | INT      |
| itid           | INT      |
| type           | TEXT     |
| tid            | INT      |
| name           | TEXT     |
| start_ts       | INT      |
| end_ts         | INT      |
| ipid           | INT      |
| is_main_thread | INT      |
| switch_count   | INT      |

#### 表描述

记录了线程相关数据。

#### 字段详细描述

- id：线程在数据库重新重新定义的 id，从 0 开始序列增长
- itid：TS 内部线程 id
- type：固定字段（thread）
- tid：线程号
- name：线程名
- start_ts：开始时间
- end_ts：结束时间
- ipid：线程所属的进程 id, 关联 process 表中的 ID
- is_main_thread：是否主线程，主线程即该线程实际就是进程本身
- switch_count：当前线程的切换次数

### thread_filter 表

#### 表结构

| Columns Name | SQL TYPE |
| ------------ | -------- |
| id           | INT      |
| type         | TEXT     |
| name         | TEXT     |
| itid         | INT      |

#### 表描述

将线程 ID 作为 key1，线程的内存，界面刷新，屏幕亮度等信息作为 key2，唯一确定一个 filter_id, filter_id 同时被记录在 filter 表中。

#### 主要字段描述

- id：线程 id
- type：线程类型
- name：线程名称
- itid：该表中的 tid 与 thread 表中的 tid 相关联

### thread_state 表

#### 表结构

| Columns Name | SQL TYPE |
| ------------ | -------- |
| id           | INT      |
| type         | TEXT     |
| ts           | INT      |
| dur          | INT      |
| cpu          | INT      |
| itid         | INT      |
| tid          | INT      |
| pid          | INT      |
| state        | TEXT     |

#### 表描述

记录了线程状态相关的数据。

#### 字段详细描述

- id：线程状态在数据库中的 id，从 0 开始序列增长
- ts：该线程状态的起始时间
- dur：该线程状态的持续时间
- cpu：该线程在哪个 cpu 上执行（针对 running 状态的线程）
- itid：该状态所属的线程 id, 关联线程表中的 id
- tid：线程号
- pid：进程号
- state：线程实际的的状态值

```
'R', Runnable状态
"S", interruptible sleep
"D", uninterruptible sleep
"D-IO", uninterruptible io
"D-NIO", uninterruptible nio
"Runing", Runing状态
"T", Task stoped.
"t"  Traced.
"X", ExitedDead
"Z", Zombie
"P", Parked
"I", Task_Dead
"DK",
"DK-IO",
"DK-NIO",
"TK", TracedKill
"R+", WakeKill
"R+", TaskNew
"R-B", Task runnable binder.
```

### clock_snapshot 表

#### 表结构

| Columns Name | SQL TYPE |
| ------------ | -------- |
| clock_id     | INT      |
| ts           | INT      |
| clock_name   | TEXT     |

#### 表描述

时钟号和时间，时钟名的映射表。

#### 关键字段描述

- clock_id：时钟号
- ts：时钟快照报的时间
- clock_name：时钟号对应的时钟名字  
  时钟快照是用来对齐不同时钟号的时间
  比如，时钟号 1 的时间 100，和时钟号 2 的时间 200 对齐
  则时钟号为 2 的 250，转换为时钟号 1 的时间后，为 150

### datasource_clockid 表

#### 表结构

| Columns Name     | SQL TYPE |
| ---------------- | -------- |
| data_source_name | TEXT     |
| clock_id         | INT      |

#### 表描述

数据源和时钟号的映射表。

#### 关键字段描述

- data_source_name：数据源的名称，和数据源的插件名保持一致
- clock_id：时钟号，对应 clock_snapshot 中的时钟号  
  这个表是用来告诉 IDE，不同的事件源的事件，原始时钟号是多少，在数据库中保存的事件，通常是转换为 boottime 后的时间，但有些情况下，IDE 仍然需要知道原始的时钟号是怎样的

### frame_slice 表

### 表结构

| Columns Name | SQL TYPE |
| ------------ | -------- |
| ts           | INT      |
| vsync        | INT      |
| ipid         | INT      |
| itid         | INT      |
| callstack_id | INT      |
| dur          | INT      |
| src          | TEXT     |
| dst          | INT      |
| type         | INT      |
| flag         | INT      |
| depth        | INT      |
| frame_no     | INT      |

#### 表描述

应用的实际渲染帧和期望渲染帧的开始时间，持续时长，以及 RenderService 和 App 之间的关联关系。

#### 关键字段描述

- callstack_id：该帧数据对应着 callstack 表的调用栈所在的行数
- dur：该帧渲染时长（当数据不完整时，改行数据为空）
- src：该帧是被哪一帧（该表中对应的行数）触发的，有多个值时，用逗号分割
- dst：该帧对应的渲染帧是哪一行
- type: 0 说明该行数据是实际渲染帧， 1 说明该行数据是期望渲染帧
- flag: 空时，为不完整的数据；0 表示实际渲染帧不卡帧， 1 表示实际渲染帧卡帧(expectEndTime < actualEndTime 为异常)， 2 表示数据不需要绘制（没有 frameNum 信息），3 表示 rs 进程与 app 进程起止异常(|expRsStartTime - expUiEndTime| < 1ms 正常，否则异常。这里使用期待帧的时间差做判断，给实际帧打标签)
- depth：预留
- frame_no：预留

### frame_maps 表

### 表结构

| Columns Name | SQL TYPE |
| ------------ | -------- |
| ts           | INT      |
| src_row      | INT      |
| dst_row      | INT      |

#### 表描述

该表记录了 app 到 RenderService 的帧的映射关系，同 frame_slice 表中的 src 映射到 dst 的关系。

#### 关键字段描述

- src_row：frame_slice 表中 app 的帧所在的行
- dst_row：frame_slice 表中 RenderService 的帧所在的行

### gpu_slice 表

### 表结构

| Columns Name | SQL TYPE |
| ------------ | -------- |
| frame_row    | INT      |
| dur          | INT      |

#### 表描述

该表记录了每一帧数据在 GPU 上的渲染时长。

#### 关键字段描述

- frame_row：frame_slice 表中渲染帧所在的行
- dur：帧渲染时长

### trace_range 表

#### 表结构

| Columns Name | SQL TYPE |
| ------------ | -------- |
| start_ts     | INT      |
| end_ts       | INT      |

#### 表描述

该表记录了解析开始时间以及结束时间。

#### 关键字段描述

- start_ts：trace 的开始时间，纳秒为单位
- end_ts：trace 的结束时间，纳秒为单位

### task_pool 表

#### 表结构

| Columns Name        | SQL TYPE |
| ------------------- | -------- |
| id                  | INT      |
| allocation_task_row | INT      |
| execute_task_row    | INT      |
| return_task_row     | INT      |
| allocation_itid     | INT      |
| execute_itid        | INT      |
| return_itid         | INT      |
| execute_id          | INT      |
| priority            | INT      |
| execute_state       | INT      |
| return_state        | INT      |
| timeout_row         | INT      |

#### 表描述

该表记录了任务池相关数据，与 callstack 表关联。

#### 关键字段描述

- allocation_task_row：与 callstack 表 id 号相关联
- execute_task_row：与 callstack 表 id 号相关联
- return_task_row：与 callstack 表 id 号相关联
- allocation_itid：任务分发的 itid
- execute_itid：任务执行的 itid
- return_itid：任务返回的 itid
- execute_id：任务执行 id
- priority：任务分发独有的，优先级{HIGH : 0，MEDIUM : 1，LOW : 2}
- execute_state：任务执行独有的执行状态{NOT_FOUND : 0，WAITING : 1，RUNNING : 2，CANCELED : 3}
- return_state：任务返回独有的任务返回状态[IsCanceled DeserializeFailed Successful Unsuccessful]
- timeout_row：任务执行超时时更新此列，将对应的 callstack 表行号存于对应的任务行

### animation 表

#### 表结构

| Columns Name | SQL TYPE |
| ------------ | -------- |
| id           | INT      |
| input_time   | INT      |
| start_point  | INT      |
| end_point    | INT      |

#### 表描述

该表记录动效的响应时延和完成时延等信息。

#### 关键字段描述

- input_time：输入时间点
- start_point：开始时间点
- end_point：结束时间点

### dynamic_frame 表

#### 表结构

| Columns Name | SQL TYPE |
| ------------ | -------- |
| id           | INT      |
| x            | INT      |
| y            | INT      |
| width        | INT      |
| height       | INT      |
| alpha        | TEXT     |
| name         | INT      |
| end_time     | INT      |

#### 表描述

该表记录动效帧的坐标、分辨率、结束时间等信息。

#### 关键字段描述

- x：坐标 x
- y：坐标 y
- width：宽
- height：高
- alpha：透明度
- name：当前动效帧名字
- end_time：结束时间

### device_info 表

#### 表结构

| Columns Name        | SQL TYPE |
| ------------------- | -------- |
| id                  | INT      |
| physical_width      | INT      |
| physical_height     | INT      |
| physical_frame_rate | INT      |

#### 表描述

该表记录设备分辨率和帧率等信息。

#### 关键字段描述

- physical_width：设备宽
- physical_height：设备高
- physical_frame_rate：设备帧率

### device_state 表

#### 表结构

| Columns Name     | SQL TYPE |
| ---------------- | -------- |
| id               | INT      |
| brightness       | INT      |
| bt_state         | INT      |
| location         | INT      |
| wifi             | INT      |
| stream_default   | INT      |
| voice_call       | INT      |
| music            | INT      |
| stream_ring      | INT      |
| media            | INT      |
| voice_assistant  | INT      |
| system           | INT      |
| alarm            | INT      |
| notification     | INT      |
| bt_sco           | INT      |
| enforced_audible | INT      |
| stream_dtmf      | INT      |
| stream_tts       | INT      |
| accessibility    | INT      |
| recording        | INT      |
| stream_all       | INT      |

#### 表描述

该表记录设备屏幕亮度，蓝牙，位置，wifi，音乐，媒体等信息。

#### 关键字段描述

- brightness：屏幕亮度
- bt_state：蓝牙状态
- location：位置信息
- wifi：无线网络状态
- voice_call：语音通话
- music：音乐播放
- media：多媒体
- voice_assistant：语音助手
- system：系统
- alarm：闹钟
- notification：消息通知
- bt_sco：蓝牙语音
- accessibility：访问权限
- recording：录音

### trace_config 表

#### 表结构

| Columns Name | SQL TYPE |
| ------------ | -------- |
| id           | INT      |
| trace_source | INT      |
| key          | INT      |
| value        | INT      |

#### 表描述

该表记录 trace 数据源，proto 的事件-plugin 与其 process_name（目前只有 HisysEvent 事件在用）。

#### 关键字段描述

- trace_source：事件源
- key：事件需要关注的信息名
- value：事件需要关注的信息名对应的信息值

### memory_ashmem 表

#### 表结构

| Columns Name   | SQL TYPE |
| -------------- | -------- |
| id             | INT      |
| ts             | INT      |
| ipid           | INT      |
| adj            | INT      |
| fd             | INT      |
| ashmem_name_id | INT      |
| size           | INT      |
| pss            | INT      |
| ashmem_id      | INT      |
| time           | INT      |
| ref_count      | INT      |
| purged         | INT      |
| flag           | INT      |

#### 表描述

该表记录 trace 数据源，proto 的事件-plugin 与其 process_name（目前只有 HisysEvent 事件在用）。

#### 关键字段描述

- ts：时间戳
- ipid：内部进程号
- fd：共享内存文件描述符
- ashmem_name_id：共享内存名
- size：共享内存大小
- pss：PSS 内存大小
- ashmem_id：共享内存 ID
- ref_count：引用计数
- flag：去重标记，0 表示正常，1 表示进程内部重复数据，2 表示进程间重复数据

### memory_dma 表

#### 表结构

| Columns Name     | SQL TYPE |
| ---------------- | -------- |
| id               | INT      |
| ts               | INT      |
| ipid             | INT      |
| fd               | INT      |
| size             | INT      |
| ino              | INT      |
| exp_pid          | INT      |
| exp_task_comm_id | INT      |
| buf_name_id      | INT      |
| exp_name_id      | INT      |
| flag             | INT      |

#### 表描述

该表记录 trace 数据源，proto 的事件-plugin 与其 process_name（目前只有 HisysEvent 事件在用）。

#### 关键字段描述

- ts：时间戳
- ipid：内部进程号
- fd：dma 内存文件描述符
- size：dma 内存大小
- exp_pid：申请者的进程号
- buf_name_id：dma 内存名
- exp_name_id：申请者进程名
- flag：去重标记，0 表示正常，1 表示进程内部重复数据，2 表示进程间重复数据

### memory_process_gpu 表

#### 表结构

| Columns Name  | SQL TYPE |
| ------------- | -------- |
| id            | INT      |
| ts            | INT      |
| gpu_name_id   | INT      |
| all_gpu_size  | INT      |
| addr          | TEXT     |
| ipid          | INT      |
| itid          | INT      |
| used_gpu_size | INT      |

#### 表描述

该表记录 trace 数据源，proto 的事件-plugin 与其 process_name（目前只有 HisysEvent 事件在用）。

#### 关键字段描述

- ts：时间戳
- gpu_name_id：gpu 内存名称
- all_gpu_size：进程占用 gpu 总大小
- addr：gpu 内存地址
- ipid：内部进程号
- itid：内部线程号
- used_gpu_size：已使用的 gpu 大小

### memory_window_gpu 表

#### 表结构

| Columns Name     | SQL TYPE |
| ---------------- | -------- |
| id               | INT      |
| ts               | INT      |
| window_name_id   | INT      |
| window_id        | INT      |
| module_name_id   | INT      |
| category_name_id | INT      |
| size             | INT      |
| count            | INT      |
| purgeable_size   | INT      |

#### 表描述

该表记录 trace 数据源，proto 的事件-plugin 与其 process_name（目前只有 HisysEvent 事件在用）。

#### 关键字段描述

- ts：时间戳
- window_name_id：窗口名
- window_id：窗口 id
- module_name_id：模块名
- category_name_id：目录名
- size：内存大小
- count：内存申请个数

### static_initalize 表

#### 表结构

| Columns Name | SQL TYPE |
| ------------ | -------- |
| id           | INT      |
| ipid         | INT      |
| tid          | INT      |
| call_id      | INT      |
| start_time   | INT      |
| end_time     | INT      |
| so_name      | TEXT     |
| depth        | INT      |

#### 表描述

该表记录了 so 初始化相关数据。

#### 关键字段描述

- ipid：内部进程号
- tid：内部线程号
- call_id：调用者的 ID，对应线程表里面的 itid
- start_time：阶段开始时间
- end_time：阶段结束时间
- so_name：so 文件名称
- depth：泳道图的深度