Use this configuration to specify a particular process to attach to and analyze with the Intel® VTune™ Amplifier on the host (local) system.
When you run an analysis, the VTune Amplifier attaches to the process and starts collecting data. To detach from the process, click the
button on the
command toolbar. The process will keep running but the analysis will be stopped.
To access the configuration, open the Analysis Target window, choose the local target system on the left and select the Attach to Process target type from the drop-down menu on the right.
Basic Options
|
Use This |
To Do This |
|---|---|
|
Process name |
Identify the executable to analyze by its name. |
|
PID |
Identify the executable to analyze by its process ID (PID). |
|
Managed code profiling mode menu |
Select a profiling mode for managed code. Managed mode attributes data to managed source and only collects managed portion. Native mode collects everything but does not attribute data to managed source. Mixed mode collects everything and attributes data to managed source where appropriate. |
|
Automatically resume collection after (sec) |
Specify the time that should elapse before the data collection is resumed. When this options is used, the collection starts in the paused mode automatically. |
|
Automatically stop collection after (sec) |
Set the duration of data collection in seconds starting from the target run. This is useful if you want to exclude some post-processing activities from the analysis results. |
Advanced Options
Use the Advanced section to provide more details on your target configuration.
|
Use This |
To Do This |
|---|---|
|
Analyze child processes check box |
Collect data on processes launched by the target process. Use this option when profiling an application with the script. |
|
Modify button |
Click the Modify button to open the Per-process Configuration dialog box and specify child processes to analyze. For example, if your target application calls shell or makes processes, you can choose to exclude them from analysis and focus only on the processes you develop. This option is not applicable to hardware event-based analysis types. |
|
Duration time estimate menu |
Estimate the application duration time. This value affects the size of collected data. For long running targets, sampling interval is increased to reduce the result size. For hardware event-based sampling analysis types, the VTune Amplifier uses this estimate to apply a multiplier to the configured sample after value. |
|
Analyze system-wide check box |
Enable analyzing all processes running on the system. When disabled, only the target process is analyzed. |
|
Collection data limit spin box |
Limit the amount of the raw data to be collected. Use this option to start analyzing the beginning of the target execution when the amount of collected data is very large and takes long to process. Outcome: VTune Amplifier suspends data collection when the specified limit is reached.
NoteThe size of data stored in the result directory may not exactly match the specified limit due to the following reasons: |
|
Slow frames threshold, frames/s |
Specify a threshold to separate Slow and Good frames. Frame rates lower than this threshold are marked as Slow. This threshold needs to be smaller than the Fast frames threshold. |
|
Fast frames threshold, frames/s |
Specify a threshold to separate Good and Fast frames. Frame rates higher than this threshold are marked as Fast. This threshold needs to be larger than the Slow frames threshold. |
|
CPU mask |
Specify CPU(s) to collect data on (for example: 2-8,10,12-14). This option is applicable to hardware event-based analysis types only. |
|
Custom collector |
Provide a command line for launching an external collection tool, if any. You can later import the custom collection data (time intervals and counters) in a CSV format to a VTune Amplifier result. Click the Modify button to add a path to your external collector. |
|
Analyze KVM guest OS check box |
Enable KVM guest system profiling. For proper kernel symbol resolution, make sure to specify:
|
|
Result location options |
Select where you want to store your result file. By default, the result is stored in the project directory. |
Support Limitations
-
For driverless event-based sampling data collection, VTune Amplifier supports local and remote Launch Application, Attach to Process and Profile System target types but their support fully depends on the Linux Perf profiling credentials specified in the /proc/sys/kernel/perf_event_paranoid file and managed by the administrator of your system using root privileges. For more information see the perf_event related configuration files topic at http://man7.org/linux/man-pages/man2/perf_event_open.2.html. By default, only profiling of user processes at the both user and kernel spaces is permitted.