Google Git
Sign in
android/platform/system/extras/android17-release/./simpleperf
tree: ceef8fe638bee8ffbd806471308fff78e7afb14f
  1. app_api/
  2. demo/
  3. doc/
  4. fuzzer_scripts/
  5. include/
  6. nonlinux_support/
  7. runtest/
  8. rust/
  9. scripts/
  10. simpleperf_app_runner/
  11. testdata/
  12. .clang-format ⇨ ../.clang-format-2
  13. CtsSimpleperfTestCases_testdata ⇨ testdata/
  14. .gitignore
  15. AddrFilter.cpp
  16. AddrFilter.h
  17. AddrFilter_test.cpp
  18. Android.bp
  19. branch_list.proto
  20. BranchListFile.cpp
  21. BranchListFile.h
  22. BranchListFile_test.cpp
  23. build_id.h
  24. callchain.h
  25. CallChainJoiner.cpp
  26. CallChainJoiner.h
  27. CallChainJoiner_test.cpp
  28. cmd_api.cpp
  29. cmd_api_impl.h
  30. cmd_api_test.cpp
  31. cmd_boot_record.cpp
  32. cmd_boot_record_test.cpp
  33. cmd_debug_unwind.cpp
  34. cmd_debug_unwind_test.cpp
  35. cmd_dumprecord.cpp
  36. cmd_dumprecord_test.cpp
  37. cmd_help.cpp
  38. cmd_inject.cpp
  39. cmd_inject_test.cpp
  40. cmd_kmem.cpp
  41. cmd_kmem_test.cpp
  42. cmd_list.cpp
  43. cmd_list_test.cpp
  44. cmd_merge.cpp
  45. cmd_merge_test.cpp
  46. cmd_monitor.cpp
  47. cmd_monitor_test.cpp
  48. cmd_record.cpp
  49. cmd_record_impl.h
  50. cmd_record_test.cpp
  51. cmd_report.cpp
  52. cmd_report_sample.cpp
  53. cmd_report_sample.proto
  54. cmd_report_sample_test.cpp
  55. cmd_report_test.cpp
  56. cmd_stat.cpp
  57. cmd_stat_impl.h
  58. cmd_stat_test.cpp
  59. cmd_trace_sched.cpp
  60. cmd_trace_sched_test.cpp
  61. command.cpp
  62. command.h
  63. command_test.cpp
  64. cpu_hotplug_test.cpp
  65. dso.cpp
  66. dso.h
  67. dso_test.cpp
  68. environment.cpp
  69. environment.h
  70. environment_test.cpp
  71. ETMConstants.h
  72. ETMDecoder.cpp
  73. ETMDecoder.h
  74. ETMRecorder.cpp
  75. ETMRecorder.h
  76. ETMRecorder_test.cpp
  77. event_attr.cpp
  78. event_attr.h
  79. event_fd.cpp
  80. event_fd.h
  81. event_selection_set.cpp
  82. event_selection_set.h
  83. event_selection_set_test.cpp
  84. event_table.json
  85. event_table_generator.py
  86. event_table_json_generator.py
  87. event_type.cpp
  88. event_type.h
  89. get_test_data.h
  90. gtest_main.cpp
  91. IOEventLoop.cpp
  92. IOEventLoop.h
  93. IOEventLoop_test.cpp
  94. JITDebugReader.cpp
  95. JITDebugReader.h
  96. JITDebugReader_impl.h
  97. JITDebugReader_test.cpp
  98. kallsyms.cpp
  99. kallsyms.h
  100. kallsyms_test.cpp
  101. libsimpleperf_report_fuzzer.cpp
  102. main.cpp
  103. MapRecordReader.cpp
  104. MapRecordReader.h
  105. MapRecordReader_test.cpp
  106. NOTICE
  107. OfflineUnwinder.cpp
  108. OfflineUnwinder.h
  109. OfflineUnwinder_impl.h
  110. OfflineUnwinder_test.cpp
  111. OWNERS
  112. perf_event.h
  113. perf_regs.cpp
  114. perf_regs.h
  115. perf_regs_test.cpp
  116. ProbeEvents.cpp
  117. ProbeEvents.h
  118. ProbeEvents_test.cpp
  119. profcollect.cpp
  120. read_apk.cpp
  121. read_apk.h
  122. read_apk_test.cpp
  123. read_dex_file.cpp
  124. read_dex_file.h
  125. read_dex_file_test.cpp
  126. read_elf.cpp
  127. read_elf.h
  128. read_elf_test.cpp
  129. read_symbol_map.cpp
  130. read_symbol_map.h
  131. read_symbol_map_test.cpp
  132. README.md
  133. record.cpp
  134. record.h
  135. record_equal_test.h
  136. record_file.h
  137. record_file.proto
  138. record_file_format.h
  139. record_file_reader.cpp
  140. record_file_test.cpp
  141. record_file_writer.cpp
  142. record_lib_interface.cpp
  143. record_lib_test.cpp
  144. record_test.cpp
  145. RecordFilter.cpp
  146. RecordFilter.h
  147. RecordFilter_test.cpp
  148. RecordReadThread.cpp
  149. RecordReadThread.h
  150. RecordReadThread_test.cpp
  151. RegEx.cpp
  152. RegEx.h
  153. RegEx_test.cpp
  154. report_lib_interface.cpp
  155. report_utils.cpp
  156. report_utils.h
  157. report_utils_interface.cpp
  158. report_utils_test.cpp
  159. sample_tree.h
  160. sample_tree_test.cpp
  161. SampleComparator.h
  162. SampleDisplayer.h
  163. simpleperf.rc
  164. simpleperf_dict.dict
  165. simpleperf_writer_fuzzer.cpp
  166. SPEDecoder.cpp
  167. SPEDecoder.h
  168. SPERecorder.cpp
  169. SPERecorder.h
  170. TEST_MAPPING
  171. test_util.cpp
  172. test_util.h
  173. thread_tree.cpp
  174. thread_tree.h
  175. thread_tree_test.cpp
  176. tracing.cpp
  177. tracing.h
  178. tracing_test.cpp
  179. utils.cpp
  180. utils.h
  181. utils_test.cpp
  182. workload.cpp
  183. workload.h
  184. workload_test.cpp
  185. ZstdUtil.cpp
  186. ZstdUtil.h
  187. ZstdUtil_test.cpp
simpleperf/README.md

Simpleperf

Android Studio includes a graphical front end to Simpleperf, documented in Inspect CPU activity with CPU Profiler. Most users will prefer to use that instead of using Simpleperf directly.

If you prefer to use the command line, Simpleperf is a versatile command-line CPU profiling tool included in the NDK for Mac, Linux, and Windows.

This file contains documentation for simpleperf maintainers.

There is also user documentation.

Updating the prebuilts in system/extras/simpleperf

Find the latest green build of simpleperf targets in ab/git_main-without-vendor. Once you have the build id (a 7-digit number) and the build is complete, run the update script from within the system/extras/simpleperf directory:

$ ./scripts/update.py --build <build id>

This will create a new change that you can repo upload, then approve and submit as normal.

For testing, we usually only run python host tests as below:

$ ./scripts/test/test.py --only-host-test

To test all scripts, please use python 3.8+ and install below packages:

$ pip install bokeh jinja2 pandas protobuf textable

Updating the prebuilts in prebuilts/simpleperf (for NDK)

Find the latest green build of simpleperf targets in ab/git_main-without-vendor.

$ git clone https://googleplex-android.googlesource.com/platform/prebuilts/simpleperf
$ cd simpleperf
$ ./update --build <build id>

Then manually edit ChangeLog or use Gemini to generate it. This will create a new change that we can upload for review.

$ git push origin HEAD:refs/for/main

For testing, we need to test if the scripts run on Darwin/Linux/Windows for different Android versions in 4 steps:

  1. Test on Android emulators running on a Linux x86_64 host, for Android version N to current.
$ ./test/test.py -d <devices> -r 3

The scripts support Android >= N. But it's easier to test old versions on emulators. So we only test Android N on emulators.

Currently, the tests have problems in clean up. So tests on emulators may fail and take too long to run. And there are a few known failed cases. Hopefully they will be fixed soon.

  1. Test on Android devices connected to a Linux x86_64 host, for Android version O to current.
$ ./test/test.py -d <devices> -r 3
  1. Test on an Android device connected to a Darwin x86_64 host, for one of Android version O to current.
$ ./test/test.py -d <devices> -r 1
  1. Test on an Android device connected to a Windows x86_64 host, for one of Android version O to current.
$ ./test/test.py -d <devices> -r 1

To check simpleperf contents released in NDK, we can build the NDK package in an NDK branch.

$ repo init -u persistent-https://android.git.corp.google.com/platform/manifest -b master-ndk
$ repo sync
$ ndk/checkbuild.py --package --system linux --module simpleperf

The NDK package is generated in the out/ directory.

After merging the prebuilt update, the CL can be cherry-picked to NDK release branches.