Setting global preferences

Use the Global Preferences screen to set defaults for recording, playing back, and saving scripts.

To display the Global Preferences screen:

  • Select Global Preferences from the File menu.
  • In the Getting Started list on the Welcome screen, click Configure Global Preferences.

Recording tab

The Recording tab includes options for selecting the default recording mode and for applying custom profiles to Desktop Browser and Mobile Device scripts.s

Record mode

The script type you select here will be selected by default when you click Record.

Global preferences - record mode

  • Recording Profile – Select Desktop or Mobile as the type of script you normally record.

  • Recording Options

    • Keystrokes or FormFill – By default, the Recorder will capture each keystroke, creating Type actions. To capture the value in a field instead of individual keystrokes, select FormFill to create FormFill actions wherever possible.

    • HTTP Capture – 

      The HTTP Capture option creates static requests for any objects generated through a particular plugin on the page, for example Flash or Silverlight. The option is OFF by default because when Enable Flash Playback or Enable Silverlight Playback is selected in the playback settings, HTTP Capture is redundant.

    • Scroll Capture – To record the actions for scrolling a page, select On for the Scroll Capture option. It is Off by default.

Desktop profile

Use these fields to define the default profiles for Desktop Browser scripts.

Global preferences - desktop browser scripts

  • User AgentPlayback Agent Default is entered in the field. To select a different user agent, click Change To and select the agent from the list.
    Desktop profile - select a User Agent

  • Headers – To add a header, click the add icon to the right of the Headers field, then enter a name and value in the fields. Repeat if necessary.

  • Concurrent connections per host (max) – Enter the maximum number of simultaneous HTTP connections allowed to connect to a single host.

  • Simultaneous HTTP requests (max) – Enter the maximum number of total requests allowed to execute at the same time.

Mobile profile

Use these fields to define the default profiles for scripts.

Global preferences - Mobile profile

  • Device Name – Enter the name by which to identify the device. To select the device through the Device Manager, click Select device.

  • User AgentPlayback Agent Default is entered in the field. When you specify a device in the Device Name field, the compatible user agent for the device is entered automatically.

  • Headers – To add a header, click the add icon to the right of the Headers field, then enter a name and value in the fields. Repeat as necessary.

  • Screen width and Screen height – If you have already selected a device, the default dimensions are entered in these fields. To change the dimensions, enter the width and height in pixels.

  • Device Pixel Ratio – The device pixel ratio is the ratio between logical pixels and physical pixels. It determines how a device's screen resolution is interpreted by the CSS. The device pixel ratio makes it possible to render a web page at an appropriate size regardless of the device's actual screen size. For example, if the logical resolution is 360 x 640 but a device's actual screen resolution is 720 x 1280, the device pixel ratio must be set to 2 to scale the logical resolution to the physical resolution: (720/2) x (1280/2) = 360 x 640.
    The Device Pixel Ratio is specified automatically for most devices. If necessary, however, you can change the value in this field.

  • Concurrent connections per host (max) – Enter the maximum number of simultaneous HTTP connections allowed to connect to a single host. A default value of 6 is entered automatically for Mobile Device profiles.

  • Simultaneous HTTP requests (max) – Enter the maximum number of total requests allowed to execute at the same time. A default value of 18 is entered automatically for Mobile Device profiles.

Load a profile

You can import a .gprof file you had previously saved to use as the default Desktop or Mobile profile.

  1. Click Load to open the Load Profile dialog box.

  2. Navigate to and select the .gprof file for the profile.
    Make sure the saved profile matches the selected profile type. For example, only load a mobile device profile into the Mobile Device screen.

  3. Click Open.

For information about saving a profile, see Modifying script settings.

Playback tab

The Playback tab contains options for setting default local playback agents and for enabling script playback features.

Local playback

Global preferences - -local playback

  • Playback Agent Desktop – Select Internet Explorer, Firefox, or Chrome. The browser version used by the playback agent is indicated in the options label.

  • Default Mobile Playback Agent – This option is displayed for information only. The default playback agent for mobile scripts cannot be changed.

Script playback

Global preferences - script playback

  • Enable Flash Playback

    This option is available for Desktop Browser scripts only.

    If your script has steps that include Flash content, you can enable Flash. Flash playback is enabled by default.

    If you do not select this option, the playback may only call for the basic Flash objects to be downloaded. If you do select the option, additional objects are called by Flash to provide you with a more comprehensive view of the load. In a Flex environment, it is almost always true that more objects will be called.

    If a site auto-executes Flash as part of the onLoad event, it usually causes a large increase in the payload. If you enable Flash playback, the Recorder shows the performance impact of the auto-execute and provides you with accurate statistics for the true payload, not only the initial objects.

    Interactions with Flash features (for example, muting the sound) are not recorded. For more information, see Recording and playing back Flash objects.
     

  • Enable Silverlight Playback

    This option is available for Desktop Browser scripts only.

    If your script has steps that include Silverlight content, you can enable Silverlight.

    If you do not select this option, the playback may only call for the basic Silverlight objects to be downloaded. If you do select the option, additional objects are called by Silverlight to provide you with a more comprehensive view of the load.

    Interactions with Silverlight features are not recorded.
     

  • Enable SPDY

    Select this option to use the SPDY transfer protocol during script playback. For example, you can create separate scripts that record the same actions with SPDY enabled and disabled, to compare performance in each situation.

    When you play back the script with SPDY support enabled, the results views include SPDY data. Support is disabled by default.

    This option is not available for the IE agent.
     

  • Include client (non-network) time in results

    To view client (non-network) time, select this option to include it in the results. If you select this option, the waterfall chart displays this non-network time as gaps in the chart.

    When you select this option and play the script using the Firefox, Chrome, or Mobile playback agent, the waterfall chart displays the W3C navigation time metrics.
     

  • IP mode

    For Desktop Browser scripts, you can select to play back the script using IPv4 only, IPv6 only, or IPv4/IPv6 Mixed (play back on IPv6 if available, otherwise on IPv4).

    For Mobile Device scripts, only IPv4 is supported. Selecting an IP mode has no effect on these scripts.

Save tab

Use the options on the Save tab to set defaults for saving scripts locally and for uploading scripts to the Dynatrace Portal.

Global preferences - save

  • Local Save As format – Select whether to save each script as a GSL or a JSON file.

  • Default GPN/Dynatrace Username and Password – Enter the username and password you use to log in, so you do not have to log in when you upload scripts. You will also be logged in automatically, if necessary, when you open a script.

Update tab

By default, the Automatically check for updates preference is enabled, so you will see a message when Recorder updates are available for download. If desired, clear the check box to disable this feature.

Global preferences - updates