Create a private synthetic location

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 from a private location, you can bring the testing capabilities available in public locations right into your own environment. With private locations you can:

  • measure internal web page performance and availability
  • measure complex internal applications with clickpath monitors
  • measure external resources with synthetic monitors run from internal locations
  • monitor APIs, both internal and external

Private synthetic locations are supported by all types of Dynatrace synthetic monitors.

System and hardware requirements for private locations

Make sure the machine you'll use for running private synthetic monitors complies with system and hardware requirements for private synthetic locations. Note that synthetic-enabled ActiveGate has more demanding hardware and system requirements than a regular Environment or Cluster ActiveGate.

Before you begin

  • You can't execute synthetic monitors using an ActiveGate that's configured for multi-environment support.
  • You can create a private location using a clean installed synthetic-enabled Environment ActiveGate version 1.169+ or Cluster ActiveGate with Dynatrace Managed version 1.176+. If you want to use an existing ActiveGate machine, uninstall it first.
  • The synthetic-enabled ActiveGate is used exclusively to run synthetic monitors. The clean ActiveGate installation set to Synthetic monitoring disables all other ActiveGate features, including communication with OneAgents.
  • You need to make sure the ActiveGate can connect to other Dynatrace components, as well as the resource you want to test. See Setting up proxy for private synthetic monitoring.
  • Only IPv4 and DNS UDP are supported for network configuration.
  • In Dynatrace Managed offline deployments, you won't be able to save screenshots.

Install synthetic-enabled ActiveGate

Step 1. Install dependencies (Linux only)

On Linux, you have to manually manage the dependencies and proper versions of ActiveGate and Chromium required by the browser monitors engine. On Windows, Chromium is bundled with the ActiveGate installed in the synthetic mode.

Step 2. Install 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.

From the navigation menu, go to Deployment status > Install ActiveGate. Then select the operating system. For more information, see Install an Environment ActiveGate.

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.

Create a private monitor

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 more information, see Create an HTTP monitor, Create a single-URL browser monitor, or Record a browser clickpath.