1mprof-report(1) General Commands Manual mprof-report(1)
2
6 mprof-report - report generator for Mono's log profiler
7
9 mprof-report [option]... file.mlpd
10
12 mprof-report is the report generator for Mono's log profiler. It reads
13 the MLPD log files produced by the log profiler and generates a report
14 based on the options passed to it. The output is based on individual
15 reports which can be turned on or off. By default, all reports are
16 generated in summary form (i.e., non-verbose output).
17 mprof-report can read both normal and gzip(1)-compressed log files
19 transparently.
20 For information about how to use the log profiler with a program, see
22 the mono-profilers(1) page, under the LOG PROFILER section.
23
25 The following options are available:
26 --help Displays usage instructions.
28 --out=file
30 Write the report output to file instead of standard output.
31 --traces
33 Show backtraces in reports when available.
34 --maxframes=num
36 Limit backtraces to num frames.
37 --reports=reports
39 Generate only the specified reports. reports is a comma-sepa‐
40 rated list of reports. See the REPORTS section.
41 --method-sort=mode
43 Sort methods according to mode, which can be one of:
44 total (default)
46 Sort by the total amount of time spent in a method and
47 its callees.
48 self Sort by the amount of time spent only within a method
50 itself.
51 calls Sort by the total amount of calls made to a method.
53 --alloc-sort=mode
55 Sort allocations according to mode, which can be one of:
56 bytes (default)
58 Sort by the amount of heap bytes occupied by all allo‐
59 cated objects of a type.
60 count Sort by the total amount of allocations of a type.
62 --counters-sort=mode
64 Sort counters according to mode. This alters how the counters
65 report is presented. It can be one of:
66 time (default)
68 Present a list of samples, each containing a list of
69 counter name-value pairs.
70 category
72 Present a list of counter names, each containing a list
73 of sampled values.
74 This option has no effect unless --verbose is passed.
76 --track=objects
78 Track what happens to the specified objects. objects is a comma-
79 separated list of object addresses.
80 --find=spec
82 Find and track what happens to objects matching spec, which can
83 have one of these forms:
84 S:minimum_size
86 Look for objects that are at least minimum_size bytes in
87 size.
88 T:name_fragment
90 Look for objects whose type name contain name_fragment.
91 Both an S and T spec can be given by passing the option twice.
93 --thread=tid
95 Consider only events from the thread with ID tid.
96 --time=span
98 Consider only events occurring in the specified time span. span
99 must be of the form from-to where from and to are seconds since
100 the program started.
101 --verbose
103 Print verbose output.
104 --debug
106 Print extremely detailed debug output. Most users should not use
107 this option.
108
110 The following reports are available:
111 header Program startup and profiler version and operational informa‐
113 tion.
114 jit JIT compiler statistics.
116 gc Garbage collection and handle statistics.
118 sample Flat statistical sampling profile.
120 alloc Per-class GC allocation statistics and backtraces.
122 call Method call statistics and backtraces.
124 metadata
126 Loaded images and assemblies.
127 exception
129 Exception statistics and backtraces.
130 monitor
132 Monitor lock statistics and backtraces.
133 thread Managed thread names.
135 domain Loaded application domains.
137 context
139 Loaded remoting contexts.
140 heapshot
142 Heap snapshot information.
143 counters
145 Performance counter samples.
146
148 mono(1), mono-profilers(1)
149 mprof-report(1)