Installing synthetic-enabled ActiveGate

With Dynatrace Synthetic, you can run your monitors from a private synthetic location, which is a location in your private network infrastructure where you install a synthetic-enabled ActiveGate.

With monitors executed on such an 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.

Private browser monitors

To run browser monitors from a private location, you must first satisfy the engine dependencies, before you install the ActiveGate. See Browser monitors in private locations for detailed instructions.

Install synthetic-enabled ActiveGate

A synthetic-enabled ActiveGate is used exclusively to run synthetic monitors. A clean ActiveGate installation set to Synthetic monitoring will disable all other ActiveGate features, including communication with OneAgents.

Note that you can't execute synthetic monitors using an ActiveGate that's configured for multi-environment support.

From the navigation menu, click Deployment status and click Install ActiveGate. Select the operating system.

Follow the instructions for your ActiveGate version:

  1. For What's the purpose of this ActiveGate?, select Run synthetic monitors from a private location.
  2. Download the installer.
  3. Install ActiveGate using the instructions displayed in the web UI. Make sure you use the exact command displayed in the Dynatrace web UI.

Add a private location

  1. In the Dynatrace web UI, go to Settings > Web & mobile monitoring > Private synthetic 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.
  7. Click Save.

Now, when you create your HTTP or browser monitor, simply select the location you've just created from the list of all available locations.


  • For ActiveGate version 1.163 and earlier, only two ActiveGates should 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, but we recommend a minimum of 25GB of free disk space and 8GB RAM because of the enhancements planned for future releases.
  • You can assign Cluster ActiveGate to a private locations since Dynatrace Managed version 1.176.