Troubleshoot the Synthetic Private Agent

This page provides troubleshooting instructions for some commonly experienced issues.

Authentication Errors

If you get authorization errors and do not see your private location in the Synthetic Job Editor, try the following:

Check the log files for errors: C:\appdynamics\synthetic-agent\log
Confirm that your account and location information is correct in the configuration file: C:\appdynamics\synthetic-agent\synthetic-driver\conf\synthetic-driver.yml

Update Account and Location Information

If you had to correct your account and location information, stop and restart the Synthetic Private Agent:

Stop the Synthetic Private Agent by double-clicking the desktop shortcut Stop Agent.
Restart the Synthetic Private Agent double-clicking the desktop shortcut Start Agent.

Administration Privilege Issues

If you have difficulty running the installer as a domain user with administrator privileges, create a local user account with administrative privileges and try again.

Anti-Virus Software Issues

See Using Anti-Virus Software for instructions on how to avoid anti-virus software scanning the Synthetic Private Agent files.

Add Users to Group Policy

If you encounter the following error message:

Users do not have allow logon permissions. Please add 'Users' to 'Allow log on locally' group policy. This is required because agent_user is a non administrator and is used to execute measurements.

Open a PowerShell console.
From the console, open the Local Group Policy Editor:
```
> gedit.msc
```
POWERSHELL
Navigate to Computer Configuration -> Windows Settings -> Security Settings -> Local Policies -> User Rights Assignment.
Double-click the policy Allow log on locally.
Click Add User or Group.
From the Select Users or Groups dialog, enter Users as the object name.
Click Object Types to open the Object Types dialog.
Check the Groups checkbox.
Click OK to close the Object Types dialog.
Click OK to close the Select Users or Groups dialog.
From the Allow log on locally Properties dialog, click Apply to save your changes.
Click OK to close the Allow log on locally Properties dialog.
Close the Local Group Policy Editor.

Synthetic Job Times Out for Internet Explorer 11

If you notice synthetic jobs running in Internet Explorer (IE) 11 in private agent locations are timing out, you may need to change the Protected Mode settings of IE 11 on the machine hosting your Synthetic Private Agent.

To diagnose and fix the potential issue with the Protected Mode settings:

From the Synthetic Jobs page, edit the job that is timing out to determine the private agent location.
Log on to the machine hosting the Synthetic Private Agent running in that private agent location.
Open the log file C:\appdynamics\synthetic-agent\log\connector.log.

If you see error messages similar to the one below, this verifies that you will have to update the Protected Mode settings for each of the four zones in IE 11.

CRITICAL 2018-06-25 15:13:26,019  ad.script.webdriver  measurementID=e325b030-c017-4155-bfd7-19729b9ca3f1~8a0a5b3b-98a1-45e8-8746-9bxxxxx
      Failed to create WD Driver: unable to start remote browser: Message: Unable to create new remote session. desired capabilities = Capabilities [\{ensureCleanSession=true, appdynamicsCapability=\{flushSessions=true, outputDir=C:\appdynamics\synthetic-agent\measurements\1e0b7a1b-bffc-471d-8815-1e40fxxxxx\results, commandWebhook=http://localhost:8888/v1/webdriver/action, testId=e325b030-c017-4155-bfd7-19729b9ca3f1~8a0a5b3b-98a1-45e8-8746-9bf5xxxx}, acceptSslCerts=true, name=e325b030-c017-4155-bfd7-19729b9ca3f1~8a0a5b3b-98a1-45e8-8746-9bxxxxxx, browserName=internet explorer, initialBrowserUrl=about:blank, javascriptEnabled=true, version=, platform=WINDOWS}], required capabilities = Capabilities [\{}]

Launch IE 11.
From IE 11, navigate to > Internet options.
Select the Security tab and then make sure that each zone (Internet, Local intranet, Trusted Sites, and Restricted Sites) has the same setting for the Enabled Protected Mode checkbox shown below. For example, you can either check the box and enable protected mode for each zone or uncheck the protected mode to disable protected mode for each zone.
Restart IE 11.
From your Controller, verify that the problematic synthetic job is no longer timing out for IE 11. You can trigger the job to run by editing and saving changes for the job.