custom-collector
Launch an external collector to gather
custom interval and counter statistics for your target in parallel with the
VTune
.
Profiler
GUI Equivalent
Configure Analysis
window >
WHAT
pane
Syntax
-custom-collector=
<string>
Arguments
- <string>
- Command line launching an external collection tool.
Actions Modified
Description
Your custom collector can be an application you analyze with the
VTune
or a collector that can be launched with the
Profiler
VTune
.
Profiler
Use the
-custom-collector
option to specify an external collector
other than a target analysis application.
When you start a collection, the
VTune
does the following:
Profiler
- Launches the target application in the suspended mode.
- Launches the custom collector in the attach (or system-wide) mode.
- Switches the application to the active mode and starts profiling.
If your custom collector cannot be launched in the attach mode, the
collection may produce incomplete data.
You can later import custom collection data (time intervals and counters) in
a
CSV format to
the
VTune
result.
Profiler
Example
This example runs Hotspots analysis in the default
user-mode sampling
mode and also launches an external script collecting custom statistics for the specified application:
Windows:
vtune -collect hotspots -custom-collector="python.exe C:\work\custom_collector.py" -- notepad.exeLinux:
vtune -collect hotspots -custom-collector="python /home/my_collectors/custom_collector.py" -- my_appThis example runs
VTune
event-based sampling collector and also uses an external system collector to identify product environment variables:
Profiler
Windows:
vtune -collect-with runsa -custom-collector="set | find \"AMPLXE\"" -- notepad.exe Linux:
vtune -collect-with runsa -custom-collector="set | find \"AMPLXE\"" -- my_app