Merge 8be8abebf3 into d68f223dde

doc/tutorials/debug.rst

@@ -159,6 +159,16 @@ reason and times of each vm_exit after we have done some operations.
 
       vmexit summary information
 
+4. Use the command to get a summary of cpu usage in cpu-sharing case::
+
+      # acrnalyze.py -i /home/trace/acrntrace/20231122-054116/0 -o cpu_usage --cpu_usage
+
+   .. figure:: images/debug_image29.png
+      :align: center
+
+      cpu usage summary information
+
+
 Using Self-Defined Trace Event ID to Analyze Trace
 ==================================================
 

misc/debug_tools/acrn_trace/README.rst

@@ -75,6 +75,7 @@ Options:
 -f, --frequency=unsigned_int      TSC frequency in MHz
 --vm_exit                         generate a vm_exit report
 --irq                             generate an IRQ-related report
+--cpu_usage                       generate a cpu_usage report
 
 .. note:: The tool depends on TSC frequency to do time-based analysis. Be sure
    to configure the right TSC frequency that ACRN runs on. TSC frequency can be
@@ -140,6 +141,8 @@ data to your development computer (Linux system), and run the analysis tool.
    - The analysis report is written to stdout, or to a CSV file if
      a file name is specified using ``-o filename``.
    - The scripts require Python3.
+   - If want to analyze cpu usage of each VM in cpu-sharing case, use ``--cpu_usage``
+     to replace.
 
 Build and Install
 *****************