The collector command collects performance data for analysis by the Performance Analyzer. It is valid only in native mode.
This section lists the collector commands and provides details about them.
Specify the mode for archiving an experiment when it terminates.
Control the collection of samples when dbx stops the target process.
Stop data collection and close the current experiment.
Enable the collector and open a new experiment .
Enable or disable collection of heap tracing data.
Specify hardware counter profiling settings.
Limit the amount of profiling data recorded.
Stop collecting performance data but leave experiment open.
Specify settings for collecting callstack profiling data.
Start performance data collection after pause.
Specify sampling settings.
Show current collector settings.
Inquire status about current experiment.
Experiment file control and settings.
Specify settings for collecting thread synchronization wait tracing data.
Specify settings for collecting thread analyzer data.
Report the version of libcollector.so that would be used to collect data.
where:
To start collecting data, type collector enable.
To stop data collection, type collector disable.
The collector archive command specifies the archiving mode to be used when the experiment terminates.
By default, normal archiving is used. For no archiving, specify off. To copy load objects into the experiment for portability, specify copy.
The collector dbxsample command specifies whether to record a sample when the process is stopped by dbx.
By default, a sample is collected when the process is stopped by dbx. To indicate not to collect a sample at this time, specify off.
The collector disable command causes the data collection to stop and the current experiment to be closed.
The collector enable command enables the collector and opens a new experiment.
The collector heaptrace command specifies options for collecting heap tracing (memory allocation) data.
By default, heap tracing data is not collected. To collect this data, specify on.
The collector hwprofile command specifies options for collecting hardware-counter overflow profiling data.
By default, hardware-counter overflow profile data is not collected. To collect this data, specify on.
Print out the list of available counters.
By default, hardware-counter overflow profile data is not collected. To collect this data, specify on. You can set the resolution of the counters to high or low. If you do not specify a resolution, it is set to normal. These options are similar to the collect command options. See the collect(1) man page for more information.
Add additional counters for hardware counter overflow profiles.
Specify hardware counter names and intervals.
where:
name is the name of a hardware counter.
interval is the collection interval in milliseconds.
name2 is the name of a second hardware counter.
interval2 is the collection interval in milliseconds.
Hardware counters are system-specific, so the choice of counters available depends on the system you are using. Many systems do not support hardware-counter overflow profiling. On these machines, the feature is disabled.
The collector limit command specifies the experiment file size limit.
collector limit value | unlimited | none
where:
value, in megabytes, limits the amount of profiling data recorded and must be a positive number. When the limit is reached, no more profiling data is recorded but the experiment remains open and sample points continue to be recorded. By default, there is no limit on the amount of data recorded.
If you have set a limit, specify unlimited or none to remove the limit.
The collector pause command causes the data collection to stop but leaves the current experiment open. Sample points are not recorded while the Collector is paused. A sample is generated prior to a pause, and another sample is generated immediately following a resume. Data collection can be resumed with the collector resume command.
The collector profile command specifies options for collecting profile data.
Specify the profile data collection mode.
Specify profile timer period, fixed or floating point, with an optional trailing m for milliseconds or u for microseconds.
The collector resume command causes the data collection to resume after a pause created by the collector pause command (see collector pause Command).
The collector sample command specifies the sampling mode and the sampling interval.
Specify sampling mode.
Specify sampling interval in seconds.
Record a sample with an optional name.
where:
seconds is the length of the sampling interval.
name is the name of the sample.
The collector show command shows the settings of one or more categories of options.
Show all settings
Show all settings
Show archive setting
Show duration setting
Show hardware counter data settings
Show heap tracing data settings
Show experiment size limits
Show pause and resume signal
Show call stack profiling settings
Show sample settings
Show sample signal
Show store settings
Show thread synchronization wait tracing settings
Show thread analyzer data settings
The collector status command inquires about the status of the current experiment. It returns the working directory and the experiment name.
The collector store command specifies the directory and file name where an experiment is stored.
collector store {–directory pathname | –filename filename | –group string}
where:
pathname is the pathname of the directory where an experiment is to be stored.
filename is the name of the experiment file.
string is the name of an experiment group.
The collector synctrace command specifies options for collecting synchronization wait tracing data.
By default, thread synchronization wait tracing data is not collected. To collect this data, specify on.
Specify threshold in microseconds. The default value is 1000. If calibrate is specified, the threshold value will be calculated automatically.
where:
microseconds is the threshold below which synchronization wait events are discarded.
The collector tha command specifies options for collecting thread analyzer data.
By default, thread analyzer data is not collected. To collect this data, specify on.
The collector version command reports the version of libcollector.so that would be used to collect data.
collector version