• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 # trace.h
2 
3 
4 ## 概述
5 
6 HiTraceMeter模块打点接口定义,通过这些接口实现性能打点相关功能。
7 
8 使用示例:
9 
10 同步时间片跟踪事件:
11 
12 
13 ```
14 OH_HiTrace_StartTrace("hitraceTest");
15 OH_HiTrace_FinishTrace();
16 ```
17 
18 结果输出:
19 
20 
21 ```
22 <...>-1668 (----—) [003] .... 135.059377: tracing_mark_write: B|1668|H:hitraceTest
23 <...>-1668 (----—) [003] .... 135.059415: tracing_mark_write: E|1668|
24 ```
25 
26 异步时间片跟踪事件:
27 
28 
29 ```
30 OH_HiTrace_StartAsyncTrace("hitraceTest", 123);
31 OH_HiTrace_FinishAsyncTrace("hitraceTest", 123);
32 ```
33 
34 结果输出:
35 
36 
37 ```
38 <...>-2477 (----—) [001] .... 396.427165: tracing_mark_write: S|2477|H:hitraceTest 123
39 <...>-2477 (----—) [001] .... 396.427196: tracing_mark_write: F|2477|H:hitraceTest 123
40 ```
41 
42 整数值跟踪事件:
43 
44 
45 ```
46 OH_HiTrace_CountTrace("hitraceTest", 500);
47 ```
48 
49 结果输出:
50 
51 
52 ```
53 <...>-2638 (----—) [002] .... 458.904382: tracing_mark_write: C|2638|H:hitraceTest 500
54 ```
55 
56 **起始版本:**
57 
58 10
59 
60 **相关模块:**
61 
62 [Hitrace](_hitrace.md)
63 
64 
65 ## 汇总
66 
67 
68 ### 函数
69 
70 | 名称 | 描述 |
71 | -------- | -------- |
72 | [OH_HiTrace_StartTrace](_hitrace.md#oh_hitrace_starttrace) (const char \*name) | 标记一个同步跟踪耗时任务的开始。 |
73 | [OH_HiTrace_FinishTrace](_hitrace.md#oh_hitrace_finishtrace) (void) | 标记一个同步跟踪耗时任务的结束。 |
74 | [OH_HiTrace_StartAsyncTrace](_hitrace.md#oh_hitrace_startasynctrace) (const char \*name, int32_t taskId) | 标记一个异步跟踪耗时任务的开始。 |
75 | [OH_HiTrace_FinishAsyncTrace](_hitrace.md#oh_hitrace_finishasynctrace) (const char \*name, int32_t taskId) | 标记一个异步跟踪耗时任务的结束。 |
76 | [OH_HiTrace_CountTrace](_hitrace.md#oh_hitrace_counttrace) (const char \*name, int64_t count) | 用于跟踪给定整数变量名和整数值。 |
77