Showing results for 
Show  only  | Search instead for 
Did you mean: 
Dynatrace Contributor
Dynatrace Contributor

Information about the Synthetic Screenshots:


  • Reference screenshots are taken when the monitor is created or edited, and subsequently, every 24 hours from a random monitoring location.
  • Screenshot retention is based on execution retention. They are considered part of the execution data for the execution when they were taken. The default retention time for screenshots is 35 days, however, it can be less in some Managed Environments depending on their storage settings.
  • Screenshots are captured at the end of each script event, even those without timings.
  • If your Synthetic monitor has never been successful or has not been successful in the last 35 days, you will not have any "expected" screenshots. 
  • Success (expected) screenshots are only taken on the first execution, so if your monitor is always successful and has no screenshots, it is possibly always on a re-run.
  • You can verify the origin of a screenshot by following these steps:
    1. Navigate to the Synthetic dashboard and click on "Analyze executions."
    2. Select the specific execution you're interested in from the list.
    3. Above the screenshot, you will find a label displaying the date and location, indicating, "Screenshot from <date> in <location>."
    4. Click on this link, and you will be instantly directed to the execution where the screenshot was taken or attempted to be taken. Example:


Screenshot Storage:

  • SaaS: Screenshots are stored in Amazon S3.
  • Managed: Clusters installed after version 1.216 store screenshots on the cluster, in Cassandra. For clusters installed before this version, screenshots are stored in Amazon S3. To modify the storage setup to cluster-based, create a support ticket.



  • Confirm that the executions are not always re-runs. Go to the Synthetic, click on “Analyze executions”, and in the execution time, select different timings and confirm the “Execution type” is standard (and not re-run) for some of the executions.

Dynatrace SaaS (Private Locations - Stores screenshots in S3):

Dynatrace Managed (Public Locations):

Note: Cluster-side screenshot storage is the default for newly created Managed Clusters since version 1.216.

  • Make sure the endpoint below is allowed to receive data on your Cluster ActiveGate: /beacon/synthetic/screenshot/[uuid] - Where uuid is the Environment ID.

Dynatrace SaaS and Managed (Private Locations):

How to identify issues in the logs:

  • In the browser_#.log file (/var/tmp/dynatrace/synthetic or %PROGRAMDATA%\dynatrace\synthetic):

Look for any errors related to "SCREENSHOT" or "SCREENCAP." These errors are related to taking and storing the screenshots locally on the Virtual User Controller (VUC).

  • In the vuc-browser.log file. (/var/log/dynatrace/synthetic/ or <LOG>/synthetic/log or %PROGRAMDATA%\dynatrace\synthetic\log):

Check for "[SCREENCAP]" errors. These errors occur when uploading the images from the VUC to either S3 or the cluster.

Known issues/errors:


ERROR AwsS3CloudFileManager: [SCREENCAP] Exception caught while uploading file /var/tmp/dynatrace/synthetic/screenshots/ AmazonS3Exception: Forbidden (Service: Amazon S3; Status Code: 403; Error Code: 403 Forbidden…)
ERROR AwsS3CloudFileManager: [SCREENCAP] Exception caught while uploading file /var/tmp/dynatrace/synthetic/screenshots/image.jpeg AmazonS3Exception: URLBlockedServers (Service: Amazon S3; Status Code: 403; Error Code: 403 URLBlockedServers)

Possible solutions:

1 - Proxy needed between the AG and Amazon S3:

Add the proxy connection details to the [synthetic] section of the ActiveGate file (which are located in the ActiveGate configuration directory)


proxy-server=<proxy between AG and S3>

2 - Proxy not needed:

Add "proxy-non-proxy-hosts" to specify a list of hosts that require communication without proxy.

More information:

3 - Need to separate the S3 and Monitor proxy settings:

Since release 1.227 you can selectively enable proxy for Monitors or S3, by adding the following flags to VUC (default path /var/lib/dynatrace/synthetic/config/


Restart vuc.service/ Dynatrace Synthetic service after this update.

ERROR AwsS3CloudFileManager: [SCREENCAP] Exception caught while uploading file /var/tmp/dynatrace/synthetic/screenshots/ SunCertPathBuilderException: unable to find valid certification path to requested target.

- It usually means that there is a certificate issue when ActiveGate is trying to connect to Dynatrace.

Possible solution:

ERROR AwsS3CloudFileManager: [SCREENCAP] Exception caught while uploading file C:\\ProgramData\\dynatrace\\synthetic\\temp\\synthetic\\screenshots\\image.jpeg to S3 bucket... Proxy Authentication Required (Service: Amazon S3; Status Code: 407; Error Code: 407 Proxy Authentication Required; Request ID: null; S3 Extended Request ID: null; Proxy: <yourproxy>)

- Proxy credentials are needed.

Possible solution:



After saving it, the proxy password will be encrypted. You can then restart the Dynatrace Gateway and Dynatrace Synthetic services.

Version history
Last update:
‎24 May 2024 03:54 PM
Updated by:
DynaMight Legend
DynaMight Legend

Thank you for sharing this @Dyna_Patrick 

DynaMight Guru
DynaMight Guru

Thank you😁