Installing synthetic-enabled ActiveGate

With Dynatrace Synthetic, you can run your monitors from a private synthetic location, that is a location in your private network infrastructure where you install a synthetic-enabled Environment ActiveGate. With monitors executed on this ActiveGate, you can check the availability of internal resources that are inaccessible from outside your network. Follow the steps below to install a synthetic-enabled ActiveGate and configure your private synthetic location.

Since ActiveGate version 1.165, the HTTP monitors-based synthetic monitoring is available on all supported Linux distributions and Windows Server 2016. See Supported technologies and versions.

Install synthetic-enabled ActiveGate

We recommend that you use the synthetic-enabled ActiveGate exclusively to run synthetic monitors. The clean ActiveGate installation that's set to Synthetic monitoring will disable all other ActiveGate features, including routing of OneAgent traffic. You can however enable select features using the file. For more information on ActiveGate use cases, see When do I need to install an ActiveGate?.

If your synthetic-enabled ActiveGate stops routing OneAgent traffic after the update to version 1.165, edit the file and set the MSGrouter=true property in the [collector] section.

From the navigation menu, click Deployment status.

Click Install ActiveGate.

Select the operating system. For ActiveGate version 1.165 and later, select Windows or Linux. For earlier releases, you can only install a synthetic-enabled ActiveGate on Linux.

Select Synthetic monitoring.
Enable synthetic monitoring
Install ActiveGate following the on-screen instructions. For more information, see Install an Environment ActiveGate.

Add a private synthetic location

  1. In Dynatrace, go to Settings > Web & mobile monitoring > Private monitoring locations.
  2. Click Create location.
  3. Give your location a custom Name, for example Boston office, 3rd floor.
  4. Map it from an existing geographic location or add a new one. This is defined by Region, City, and Geographic coordinates.
  5. Add the synthetic-enabled ActiveGate you've just installed to the location.
  6. Click Add.

Now you can start to run your monitors from a private synthetic location.


  • version 1.163 and earlier Only two ActiveGates can be assigned to a single location for load balancing and fail-over
  • Only IPv4 and DNS UDP are supported for network configuration.
  • Minimum hardware requirements are the same as for other clean ActiveGate installations, however we recommend minimum 25 GB of free disk space and 8GB RAM because of the enhancements planned for future releases.