Submit a ticketCall us

WebinarWebinar: A checklist for planning your Network Performance Monitor (NPM) upgrade

Are you ready for your next upgrade? To help you plan smoothly, join this webcast to learn more about, SolarWinds® Orion® Installer, SolarWinds Upgrade Advisor, Upgrades Guides, Training Videos, and other resources available. We’ll share key upgrade planning considerations, lessons learned from customers with practical advice from SolarWinds Product Experts. We’ll also give practical tips to identify the estimated time needed and resources, how to prepare the business and IT staff for changes, ways to plan for required system changes, and more.

Register now.

Home > Success Center > Web Performance Monitor (WPM) > WPM Documentation > Web Performance Monitor Administrator Guide > Troubleshooting WPM

Troubleshooting WPM

Updated November 7, 2018

This section contains details about WPM issues you may encounter that prevent you from creating or playing back a recording. It includes known issues and workarounds that may help you get back on track. See also:

Installation

If upgrading from WPM 2.2.1, you may be prompted to install Microsoft .NET Framework 3.5 so the Orion Installer can remove WPM 2.2.1. Download .NET Framework 3.5 from the Microsoft Downloads site (© 2018 Microsoft Corp., available at https://www.microsoft.com/en-us/download/details.aspx?id=21, obtained on May 10, 2018) and run the Orion Installer again.

JavaScript-related messages

You may encounter the following JavaScript issues while performing actions in the recorder:

  • JavaScript menu items are not recognized.
  • Clicks on <div> structures are not recognized.
  • OnMouseOver events are not recognized.

Press Ctrl+Shift while performing the problem action. This adds additional data to the recording that may allow access to the problematic element.

To avoid slow playback, use Ctrl+Shift only to record the actions that are causing problems.

"Object doesn't support property or method 'createEventObject'" message

Use X/Y mode to recreate a recording if the WPM Player can't find a web item on a page, or if you receive this message when for recordings that involve Java Applets, JavaScript frameworks (AngularJS, KnockoutJS, and so on), Flash, Silverlight, and sometimes SharePoint. See Error: Object doesn't support property or method 'createEventObject'.

Keyboard shortcuts do not work

Use mouse clicks instead of keyboard navigation in the webpage.

Links do not work during recording

Try to find an alternative method. For example, if the Compose email link on a page does not work, perhaps the same action can be accomplished by clicking the Inbox button.

Recorder is unresponsive

Restart the WPM Recorder program and recreate your recording.

"You must be a WPM Administrator" message

You may receive this message when creating a recording if you inherited Admin permissions as part of an Active Directory (AD) group. To resolve this issue, add the AD account as a user in the Orion Web Console. You can also check the PermissionValue in the [Solarwinds_APM].[dbo].[SEUM_WebUserPermissions] table. See also Troubleshooting Orion AD Issues .

WPM cannot include a certificate in a recording because the private key cannot be exported

To include a certificate in a recording, WPM exports that certificate with private key. If WPM cannot export the key, this message appears:

WPM cannot include the selected certificate in the recording because the private key cannot be exported. Import the certificate locally with a private key that can be exported or install the certificate on all computers where that recording will be played.

To make the primary key exportable for the certificate on the WPM recorder machine, install the website certificate on the machine where you are running the WPM recorder. For details, visit the SolarWinds Success Center and see this article: WPM cannot include the selected certificate in the recording because the private key cannot be exported. See also Client certificates in WPM recordings.

Troubleshoot X,Y Capture Mode

Use this checklist to help diagnose common problems with X,Y Capture Mode:

  • If using proxy with authentication, ensure the credentials to the proxy are properly captured in the recording and/or the player is configured to use Active Directory accounts.
  • Add steps to a recording to better identify the action on which the playback failed. By doing this, you break down the transaction to multiple steps so you can examine the screenshots to find the action that caused an issue.
  • Run the transaction in the recorder and ensure that all necessary items load during playback. The object to be clicked must be in place and active before the click action is executed.
  • If page content loads slowly, insert a Wait action before the XY action. This will allow the content to load completely before executing the XY action.
  • Try to re-record the recording on the same machine where the player is installed.
  • If playback fails on the Image Match action, try the following:
  • Examine the screenshot page to see if the image is present on the page.
  • Ensure that the same version of Internet Explorer is used during both recording and playback.
  • Image Matching may be affected by font smoothing settings. Do not use Image Matching on plain text; use the Match Content action.

    Image Matching on animated objects is not supported.

Player cannot play a transaction due to SEUM-User account permissions

When the WPM Player simulates an end user playing back transactions recordings, it employs an SEUM-User account for each WPM worker process. If you cannot playback a transaction from the Player's location, it may be because a SEUM-User account does not have permission for required resources, including logging into the local machine.

The original name for WPM was Synthetic End User Monitor (SEUM), a term that is still used in reference to user accounts. You may also see it in directory names and system messages.

Player symptoms include:

  • Cannot play any transaction from some location, with the transaction in Unknown status.
  • Transaction works fine in the recorder but doesn’t work in the player.
  • Transactions fails to play due to WPM worker process errors on the player's server.
  • Transaction bounces between Up and Down status.

Recorder symptoms include:

  • Transition plays on the recorder (located on the same machine where Player is) but fails when played directly in player.
  • When recording with WPM, the website's Windows authentication works. But when deployed, it does not and the page returns "not authorized" page.

A log entry similar to this one appears in the AgentWorker logs:

LogAgentWorker_610x355.png

The WPM Player cannot play the transaction because the SEUM-User utilized for playback does not have permission for required resources, including logging in to the local machine.

To resolve this issue, add all SEUM-User accounts to the local Administrators group on the Player server. See Set permissions for SEUM-User accounts.

Here are some additional tips:

  • When using Group Policy Objects (GPO) in an environment, adjust Local Security Policies to grant permission to Allow log on locally for all SEUM-User accounts on the local machine. Otherwise, changes in the user configuration on the local computer are overwritten with every GPO update.
  • When GPO is applied, it often prevents WPM services from using the SEUM-User accounts for certain tasks, such as creating WPM worker processes. Pay attention to which GPO is used and modify it for WPM requirements.
  • If adding SEUM-Users to the local Administrators group still doesn’t help in your environment, set up domain users for playback instead of local users.

Disabling Windows authentication for players

If you encounter authentication problems when playing back recordings, check if the recorded web site uses Windows authentication for its login process. Some systems are set up to pass-through Windows credentials without prompting for a username and password. If you create a recording on such a computer, the username and password required for the website is not saved with the recording. This may result in an authentication problem when the recording is played back on a different computer.

To ensure that the recorder always asks for a username and password for websites protected by Windows authentication:

OrionWPMAGWindowsAuthentication_295x378.png

  1. Log into the computer that hosts recorder with a local user account instead of a domain account.
  2. Open Internet Explorer and click Settings > Internet options.
  3. Switch to the Advanced tab, clear the Enable Integrated Windows Authentication check box, and save your changes.
  4. Restart Internet Explorer.

WPM transactions fail to play — ERROR LOGON TYPE NOT GRANTED - Logon Failure

To support WPM, a WPM worker process plays steps of transaction recordings, collects statistics and screenshots, and returns playback results to the WPM Player.

If the player service cannot start the WPM worker processes, you may receive the following message:

ERROR_LOGON_TYPE_NOT_GRANTED - Logon failure: the user has not been granted the requested logon type at this computer. This message may appear if the security policy was changed that limited the "log on locally" permissions.

To troubleshoot this issue:

  1. Check if the SEUM-User account has permissions to log on locally.
  2. If the user does not have permission, change the limitations for user accounts.

It is also important to check that the player service is running as "Local System" rather than logging in to a specific user account.

For more information, refer to:

Element not found during playback

If an element was not found during playback, recreate both the recording and the transaction.

WPM Player drops queued items

The SEUM agent has an internal queue that it uses for transaction playback requests that cannot be immediately executed because there are no free WPM worker processes. If the number of items in the queue is close to the number of transactions assigned to the Player, it usually means that the Player is close to its capacity and is not able to play transactions fast enough. If a transaction is in the queue and a new playback request for the same transaction arrives, it is dropped because the queue cannot contain duplicate requests.

If the number of dropped requests increases significantly, it usually means that the player is not able to play transactions as fast as they are requested. You should remove some transactions from the player.

If SolarWinds SAM is also installed, use the SolarWinds Web Performance Monitor (WPM).apm-template to assess the status and overall performance of the WPM Player installed on the Orion server by using Windows Performance Counters.

Internal WPM Player database exceeds capacity

Depending on the number and complexity of assigned transactions, the size of the internal WPM Player database that stores playback requests, results, and screenshots can grow rather large. This file is located at C:\Program Files (x86)\SolarWinds\Orion\SEUM\Data\AgentStorage.s3db.

If the file grows too large, (for example, over 2 GB), playback results may not be downloaded properly if a slow network connection exists between the Orion server and the WPM Player. The file will continue to grow because results are generated faster than they are downloaded from Player. If SolarWinds SAM is also installed, use the SolarWinds Web Performance Monitor (WPM).apm-template to track the size of the internal WPM Player database.

WPM Player does not work after Windows 10 upgrade

After upgrading a remote machine to Windows 10 v.1607 or later, the WPM Playback service may not start. A "Player could not be registered — Please check firewall settings" message may appear even if the firewall is completely disabled. You may be prompted to authenticate certificates even though recordings include embedded application certificates. This issue can occur if a Windows 10 upgrade overwrites existing registry entries and prevents the WPM Playback service from starting.

  1. First, verify the following conditions:
  • SEUM-User accounts exist on the target machine.
  • The target machine is part of a domain that supports Active Domain accounts.
  • The WPM Player is configured to use Active Domain accounts.
  1. Back up all player and recorder configuration files with a *.config suffix in these default folders:
  • C:\Program Files (x86)\SolarWinds\Orion\SEUM\Player
  • C:\Program Files (x86)\SolarWinds\Orion\SEUM\Recorder
  1. Upgrade players and restore the *.config files if necessary.

 

Additional troubleshooting resources for playback

Collect WPM Player diagnostic logs

Before contacting SolarWinds Support to troubleshoot failed playback, follow these steps to collect WPM Player logs.

Skip any files currently in use by WPM if prompted.

  1. If possible, unmanage all transactions at the WPM Player location (on the Orion server, an Additional Polling Engine, or a remote computer hosting a WPM Player) or move transactions to a new location that has no transactions.
  2. To simplify diagnostics, clear all files and subdirectories from the WPM log directory: C:\ProgramData\Solarwinds\Logs\SEUM.
  3. If the transaction is assigned to the Orion server or an APE assigned as a WPM location:
    1. Run the application from the player location by right-clicking and selecting Run as administrator.

    2. In the WPM section, set the DEBUG logger level for:

      • Agent Worker

      • Agent Worker – Browser

      • Agent Worker – Player

    3. Use these settings for loggers:

      • File size: 50 MB

      • # of files: 50

    4. Click Apply.

  4. If the transaction is assigned to a WPM Player machine:
    1. Run the C:\Program Files (x86)\SolarWinds\Orion\SEUM\Recorder\LogAdjuster.exe application from the player location by right-clicking on it and selecting Run as administrator.
    2. In the WPM section, set the DEBUG logger level for:
      • Agent Worker
      • Agent Worker – Browser
      • Agent Worker – Player
    3. Click Apply.
    4. Create a backup of the following file: C:\Program Files\(x86)\SolarWinds\Orion\SEUM\Player\SolarWinds.SEUM.Agent.Worker.exe.config
    5. Run Notepad.exe as an administrator and open C:\Program Files\(x86)\SolarWinds\Orion\SEUM\Player\SolarWinds.SEUM.Agent.Worker.exe.config
    6. Edit these logger attributes:
      • Set maxSizeRollBackups to 50.
      • Set maximumFileSize to 50 MB
    7. Save the .config file.
  5. Wait an hour or as much time as needed for the transaction to fail.
  6. Verify the following logs are in DEBUG:
    • C:\ProgramData\Solarwinds\Logs\SEUM\AgentWorker.logs
  7. Run WPM Diagnostics from the Windows Start Menu or run C:\Program Files (x86)\SolarWinds\Orion\SEUM\SolarwindsDiagnostics.exe to collect diagnostics to send to SolarWinds Support.
  8. Turn off DEBUG in LogAdjuster.exe for WPM by clicking Reset to default and then Apply.
  9. Export the recording you are having trouble with.
  10. Send a ZIP file with the following items to SolarWinds Support:
    • WPM Diagnostic logs
    • The recording you are having trouble with.
    • The password used for the recording, if applicable.
    • A screenshot of the Transaction Details view in the Orion Web Console.

Monitor the AgentService.log file with SolarWinds SAM

If SolarWinds SAM is also installed, you can use the SolarWinds Web Performance Monitor (WPM).apm-template to track returned values for the AgentService.log, related to a WPM Player, including:

  • Total – This component monitor returns the total number of errors in the log file. The value returned should be as low as possible.
  • New – This component monitor returns the number of newly found error strings.
  • Last_Message – This component monitor returns the last error message and its position in the log file.

You must specify the correct arguments (including the path to the AgentService.log file) for this monitored component in the Script Arguments field. The default monitored path is: C:\Program Files (x86)\SolarWinds\Orion\SEUM\AgentService.log.

 

video-large.gifvideo-small.gif
Check out this video about using the Active Diagnostics feature to troubleshoot and fix Orion Platform issues.

Last modified

Tags

Classifications

Public