Duration

The Duration column in the legend provides the wall clock time from the moment the sampling starts to the moment it is stopped. This includes any pauses when samples are not collected. If an Activity is started with the Start with data collection paused option (or -start-paused option in the command-line interface) enabled, samples are not collected until the resume instruction is given through either a ResumeAPI() or by clicking the Pause/Resume button to resume sampling.

You can specify the Duration for an Activity in the Configure Sampling Activity dialog box.

By default, the duration is 0 seconds. This setting runs the Activity infinitely. When using the default duration, you need to explicitly stop the Activity. If you enable calibration for event-based sampling, you need to set the duration to another value.

Considerations for Setting the Duration

The Duration of an Activity is affected by the following factors:

To specify the Duration:

  1. Right-click Activity in the Tuning Browser and select Modify Activity.

  2. Select Modify the selected Activity and click OK.
    The Configure Sampling Activity dialog box appears.

  3. Enter the Duration for the Activity.

To specify the Duration from the command line:

use -d | -duration <#>.

Command-line example:

>vtl activity -d 15 -c sampling run

This example creates and runs an Activity with the sampling collector for 15 seconds.

note

Other Sampling Configuration Options