Synthetic Troubleshooting Map

[HannahM]

Summary

The Synthetic Troubleshooting Map is a centralized guide for diagnosing and resolving common issues in Dynatrace Synthetic Monitoring.
It brings together troubleshooting articles, how‑to guides, and reference material for:

• Browser Monitors
• HTTP Monitors
• Network Availability Monitors (NAM)
• Synthetic locations, including private Synthetic locations

Use this map to quickly navigate to the most relevant troubleshooting content based on the type of Synthetic monitor or issue you’re investigating.

• Summary
• Getting Started with Synthetic Monitoring
• General Troubleshooting
• Browser Monitor Troubleshooting
• HTTP MonitorTroubleshooting
• Network Availability Monitor (NAM) Troubleshooting
• Private Synthetic Location Troubleshooting
• How To Guides
• General
• Browser Monitors
• Http Monitors
• Architecture, Features, and Reference Material

 

Getting Started with Synthetic Monitoring

If you’re new to Synthetic Monitoring, start here to understand core concepts and setup steps.

• Synthetic Monitoring documentation index page
• Create an HTTP monitor
• Create a single-URL browser monitor
• Record a browser clickpath
• Create a NAM Monitor SaaS  Managed
• Create a private Synthetic location
• 🎥 Getting Started Videos
• Containerized, auto-scalable private Synthetic locations on Kubernetes
• List of Terminology for Synthetic Monitoring

These resources provide the foundation needed before diving into troubleshooting scenarios

General Troubleshooting

• Firewall Constraints and allowlisting for Synthetic Monitoring includes no data shown

• Incorrect value returned for Synthetic Monitors isEnabled property

Browser Monitor Troubleshooting

Use this section when troubleshooting Synthetic Browser Monitors, including clickpaths and single‑URL tests.

• Synthetic Browser Monitor Error Codes
• Browser monitors: Missing XHR actions for third-party iframes
• Browser monitors: Can't see screenshots in results
• Browser monitors: Issues with Content Security Policy
• Browser monitors: Unable to block specific requests (owing to limitations on the length of regular e...
• Browser monitors: 401 failures on challenge-response pages
• Browser monitors: window.dispatchEvent and window.addEventListener functions in application code
• Browser Monitors: Automatically assigned applications
• How to check Synthetic Monitor Websocket errors in logs
• Basic Commands for Synthetic
• Synthetic Recorder Extension blocked in incognito mode when ExtensionInstallForcelist is used

This section focuses on issues encountered during real‑browser execution and Chromium‑based testing.

HTTP Monitor Troubleshooting

This section covers troubleshooting for Synthetic HTTP Monitors, including API and endpoint testing.

• Troubleshooting HTTP Monitor Error/ Health Status Codes

Network Availability Monitor (NAM) Troubleshooting

• Validation errors while creating NAM monitors via UI on Managed

Private Synthetic Location Troubleshooting

Issues related to private Synthetic locations and Synthetic ActiveGates are covered here.

• Missing Synthetic screenshots. Information and how to troubleshoot...
• Useful Synthetic ActiveGate logs
• Why does Chromium show as failed or skipped in Deployment Status when it is up to date?
• Why did the Synthetic Module on a Synthetic ActiveGate fail to update? Showing Failed or Skipped
• Why is my Synthetic ActiveGate shutting down?
• Private Synthetic locations: ActiveGate installation/update failed because of missing dependencies
• Can't create dir /snap/chromium/x1/Documents error in vuc-browser.debug log

How To Guides

Practical, step‑by‑step instructions for configuring Synthetic monitors, written for common real‑world use cases.

General

• How to TAG Synthetic Monitors with the location name

Browser Monitors

General

• How to record or playback a Browser Monitor without Incognito mode
• How to check the IP used for a Browser Monitor execution
• How can I find which ActiveGate my Browser Monitor execution ran on?
• How to create Browser Monitor that does not ignore certificate errors
• How to interact with trusted events in a Browser Clickpath Monitor
• Browser Monitors: How to enable 3rd Party cookies

• How to increase wait times of Browser Clickpath events beyond 60 seconds

• How to ignore background XHRs in Browser Clickpath monitors

Scripting

• How to get a OTP from an API and use it in a Browser Monitor
• How to perform a right-click in a Browser Clickpath Synthetic Monitor
• How to perform a keypress in a Browser Clickpath Synthetic Monitor
• How to perform mouseover event on browser click path synthetic monitor.
• How to perform DoubleClick event on browser click path synthetic monitor.
• How to perform a click event using Javascript on browser clickpath synthetic monitors
• How to add an XPath locator in a Browser Clickpath Monitor script
• How to tab out of a field in a Browser Clickpath Monitor
• How to add conditional JavaScript code to close the intermittent popup on Browser click path monitor...
• How to implement the File Upload action on Browser click path monitor with help of JavaScript Event(...
• How to implement the File Download action on Browser click path monitor with help of JavaScript Even...
• How to inspect and add the shadow DOM elements into synthetic script events.
• How to add the DOM selector on Browser click path monitors with the Dynamic iframes scenarios
• How to perform Dynamic Date Selection with help of JavaScript Event on browser click path synthetic ...
• Browser Monitors: how to check if an input form field on the page has a value or if it is empty
• How to perform Location dropdown(auto complete Address) with help of JavaScript Event on browser cli...
• PRO TIP - Validating and checking PDF content in synthetic
• Javascript Snippets for Browser Monitor Scripts

Http Monitors

General

• How can I find which ActiveGate my HTTP Monitor execution ran on?
  How to retrieve HTML Monitor execution details for executions other than the latest successful and f...

Scripting

• HTTP Monitors: How to sign a request for AWS Signature Version 4
• Sample Post Execution script JavaScript Code to retrieve the 'Set-Cookie' header on Synthetic HTTP m...
• How to add SOAP request on synthetic HTTP monitor
• AES Encryption and Decryption in Synthetic HTTP Monitor using Crypto JS library

Architecture, Features, and Reference Material

For deeper understanding, this map also links to reference content covering:

• Supported authentication methods in Synthetic Monitoring
• Pre- and post-execution scripts for HTTP monitors
• Browser clickpath events
• Synthetic alerting overview
• Network Availability Monitoring (NAM)
• Managed deployment scenarios
• Set up a proxy for private synthetic monitoring 

This section is especially relevant for Managed deployments and restricted network environments.

[AntonPineiro]

Nice summary, bookmark it!

[Esam_Eid]

Amazing!!!

[AntonioSousa]

Excellent!!!

[jcorreaalvarez]

Amazing Hanna ! Wonderful !Thanks!!!

[AurelienGravier]

This is absolutely awesome, thank you Hanna!💪

[stefanie_pachne]

Awesome Hannah, thank you very much!

[Mizső]

Great collection! Thank you so much! I am starting to distribute it to my clients!

[uros_djukic1]

Great and thanks as usual Hannah ! 

[Rodrigo__ACE_BR]

Amazing summary! Thanks for sharing with us!