mirror of
https://github.com/projectacrn/acrn-hypervisor.git
synced 2025-07-04 19:17:34 +00:00
DM:tools: add README.rst for acrntrace
Reviewed-by: Zhao Yakui <yakui.zhao@intel.com> Signed-off-by: Yan, Like <like.yan@intel.com> Acked-by: Eddie Dong <eddie.dong@intel.com>
This commit is contained in:
parent
c756280279
commit
9f12816451
49
tools/acrntrace/README.rst
Normal file
49
tools/acrntrace/README.rst
Normal file
@ -0,0 +1,49 @@
|
|||||||
|
acrntrace
|
||||||
|
#########
|
||||||
|
|
||||||
|
DESCRIPTION
|
||||||
|
###########
|
||||||
|
acrntrace: is a tool running on SOS, to capture trace data.
|
||||||
|
scripts directory includes scripts to analyze the trace data.
|
||||||
|
|
||||||
|
USAGE
|
||||||
|
#####
|
||||||
|
Capture trace data on SOS
|
||||||
|
|
||||||
|
1) Launch acrntrace
|
||||||
|
Capture buffered trace data:
|
||||||
|
# acrntrace
|
||||||
|
or clear buffer before tracing start:
|
||||||
|
# acrntrace -c
|
||||||
|
Trace files are created under /tmp/acrntrace/, directory name with time
|
||||||
|
string eg: 20171115-101605
|
||||||
|
2) To stop acrntrace
|
||||||
|
# q <enter>
|
||||||
|
3) Copy the trace data to linux pc
|
||||||
|
# scp -r /tmp/acrntrace/20171115-101605/ xxx@10.239.142.239:/home/xxxx/t
|
||||||
|
race_data
|
||||||
|
|
||||||
|
Analyze the trace data on Linux PC
|
||||||
|
|
||||||
|
1) Run the python script to analyze the vm_exits:
|
||||||
|
# acrnalyze.py -i /home/xxxx/trace_data/20171115-101605/0 -o /home/xxxx/trac
|
||||||
|
e_data/20171115-101605/cpu0 --vm_exit
|
||||||
|
- "--vm_exit" specify the analysis to do, currently, only vm_exit analysis
|
||||||
|
is supported.
|
||||||
|
- A preprocess would be taken out to make the trace data start and end with
|
||||||
|
an VM_ENTER, and a copy of original data file is saved with suffix ".orig";
|
||||||
|
- Analysis report would be given on the std output and in a csv file with
|
||||||
|
name specified via "-o outpu_file";
|
||||||
|
Script usage:
|
||||||
|
[Usage] acrnalyze.py [options] [value] ...
|
||||||
|
[options]
|
||||||
|
-h: print this message
|
||||||
|
-i, --ifile=[string]: input file
|
||||||
|
-o, --ofile=[string]: output file
|
||||||
|
--vm_exit: to generate vm_exit report
|
||||||
|
|
||||||
|
The scripts require bash and python2.
|
||||||
|
|
||||||
|
BUILD
|
||||||
|
#####
|
||||||
|
# make
|
Loading…
Reference in New Issue
Block a user