Documentation forWeb Performance Monitor

Configure Web Transaction Recorders on remote systems

After deploying Web Transaction Recorders to remote systems, you can configure them to communicate with the Orion server so recordings are immediately available for use in WPM. Additional options for setting up recorders are covered in the following sections:

Connect a Web Transaction Recorder to the Orion server

To configure a recorder to communicate directly with the Orion server:

  1. To start the Web Transaction Recorder on a Windows system.
    1. Click Start.
    2. Type WPM.
    3. Click WPM Recorder.

      On Windows systems, you can also open the recorder in File Explorer. Navigate to C:\Program Files (x86)\SolarWinds\Orion\SEUM\Recorder, and double-click TransactionRecorder.exe.

    To start the recorder on a macOS system, open it from the Launchpad.

  2. Open the options menu and click Orion server configuration.

  3. Provide details about the Orion server and the Orion account to be used to create recordings.
    • IP or hostname
    • Username
    • Password
  4. (Optional) Select the "Remember my configuration" check box.
  5. Click Configure to save your settings.
  6. (Optional) Configure the recorder for Pingdom, as described next. You can also:

To support Image Matching on Windows systems, set Display settings for "Scale and layout" on the remote system at the default value: 100%.

Connect a Web Transaction Recorder to your Pingdom account

Integration with Pingdom is not available in FIPS-enabled environments.

Starting in WPM 2020.2, you can create recordings that can be used as Transaction Checks in SolarWinds Pingdom. To support this integration, connect the Web Transaction Recorder to your Pingdom account with a Pingdom API token with read-write access.

Not using Pingdom yet? Click here to start your 14-day free trial.

  1. Log into your Pingdom account to generate an API token.
    1. Navigate to https://my.solarwinds.cloud/ and click Pingdom.
    2. Enter your Pingdom credentials and click Login.
    3. Click Integrations > The Pingdom API.
    4. Click Add API token.
    5. Enter a name, select Read-Write access, and then click Generate token.
    6. When the token appears, click Copy to add the token to the Windows Clipboard.

      Pingdom doesn't store API tokens. Copy the token immediately, or store it in a secure location for later use.

  2. Launch the Web Transaction Recorder on the host system.
  3. Open the options menu and click Pingdom configuration.
  4. In the Pingdom API Token field, click Ctrl+V to paste the token into the field.
  5. Click Save.


    The link at the bottom of the window displays a green check mark.

Install client certificates

The Web Transaction Recorder does not save client certificates in recordings; instead, details about certificates (for example, name and issuer) are saved in the authentication binding associated with recordings. To support playback that involve client certificates, you'll need to install certificates on the remote system that hosts the recorder, as well as remote systems where transactions created from the recording will be played back.

Client certificates are not checked if FIPS mode is enabled.

Install a client certificate into the personal certificate store for each SEUM-User account used by the WPM Player service to play transactions on remote systems. SolarWinds recommends installing certificates with a Group Policy Object (GPO), and then using domain accounts for playback. You can also install certificates individually, as described here.

To import certificates on a Windows system:

  1. Download or copy the certificate file to the remote system that hosts the Web Transaction Recorder.
  2. In the Microsoft Management Console (MMC), use the Certificate Import Wizard to add the certificate to the Personal store. For reference, see Distribute Certificates to Client Computers by Using Group Policy (© 2020 Microsoft Corp., available at docs.microsoft.com, obtained on March 29, 2020).

See the following WPM Administrator Guide topics to learn more:

To import certificates on a macOS system, see Add certificates to a keychain using Keychain Access on Mac (© 2020 Apple Corp., available at support.apple.com, obtained on November 23, 2020).

Configure Web Transaction Recorders for proxy servers

There are several ways to configure Web Transaction Recorders hosted on remote systems to use proxy servers, including:

If FIPS mode is enabled, consider adding wait times to steps that traverse proxy servers within recordings, to allow extra time for authentication and/or navigation.

To set up remote systems to support transaction playback on proxy servers, see Configure remote systems that host WPM Players. To learn how WPM handles proxy server authentication, see the WPM Administrator Guide.

To update the Web Transaction Recorder .config file: 

  1. Log into the remote system.
  2. Close the Web Transaction Recorder, if running.

    If FIPS mode is enabled, you don't need to update the .config file. Adjust Internet Properties (Windows) or network settings (macOS) instead.

  3. Open the WPM Recorder.exe.config file in a text editor.
    • In Windows, the default file location is: C:\Program Files (x86)\SolarWinds\Orion\SEUM\Recorder
    • In macOS, the default file location is /Contents/Resources/
  4. Scroll down to the proxyUrl section and add the proxy server address (for example, 192.168.1.2:12345).
  5. Save changes to the config file.
  6. Restart the Web Transaction Recorder application.
  7. Depending on the type of remove system involved, configure Internet Properties (for Windows) or System Preferences (macOS), as described next.

To adjust Internet Properties for proxy servers on a remote Windows system:

  1. Close the Web Transaction Recorder, if running.
  2. Open the Internet Properties tool from the Windows Start menu.
    1. Click Start.
    2. Type Internet Prop.
    3. Click Internet Properties.

      These changes impact how the system communicates via network for all processes, including the WPM Player service.

  3. Switch to the Connections tab and click LAN settings.
  4. In the Local Area Network (LAN) Settings dialog box:
    1. Select the "Use a proxy server for your LAN" option.
    2. Enter the Address and Port for the proxy server.
    3. Enable the "Bypass proxy server for local addresses" option so WPM can communicate with probes.
    4. Click OK.
  5. Click OK again to close the Internet Properties tool.
  6. Restart the remote system to apply the new settings.

To update settings for proxy servers on a macOS system:

  1. Close the Web Transaction Recorder, if running.
  2. Go to System Preferences, type proxies in the search bar, and then press Enter.
  3. Select the Web Proxy (HTTP) option, and then provide Address and Port details.
  4. Select the Secure Web Proxy (HTTPS) option, and then provide Address and Port details.
  5. Click OK to save your changes.

    These changes impact how the system communicates via network for all processes.

  6. In the Network dialog box:
    1. Click Apply.
    2. Turn off the network device being used to connect to your network or the Internet.

      If logged in via RDP, your session will end.

    3. Turn the network device back on.
  7. Restart the Web Transaction Recorder.

Remove the Orion server or Pingdom configuration from a Web Transaction Recorder

Links at the bottom of the Web Transaction Recorder window indicate how it's currently configured, as shown here:

To remove an existing Orion server or Pingdom configuration:

  • Click the related link at the bottom of the recorder: either Orion server or Pingdom.
  • When a dialog box appears, click Remove configuration, as shown in this example: