Browser monitors in private locations

Private browser monitors are the perfect solution for testing your enterprise applications from inside your private network infrastructure.

Private browser monitors are available with Dynatrace version 1.170+ and ActiveGate version 1.169+. To start executing browser monitors from private locations, you must reinstall the ActiveGate. It's not sufficient to modify the settings in the file.

What are browser monitors?

It's either single-URL browser monitor testing the availability of a single page of your website or web application, or browser clickpath simulating the sequence of interactions.

What is a private synthetic location?

A location in your private network infrastructure where you install a synthetic-enabled Environment ActiveGate. With browser monitors executed on this ActiveGate, you can check the availability of internal resources that are inaccessible from outside your network.

Before you begin

  • The private browser monitors are executed on a clean installed synthetic-enabled Environment ActiveGate version 1.169+. 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 will disable all other ActiveGate features, including communication with OneAgents.
  • You need to make sure the Environment ActiveGate can connect to other Dynatrace components, as well as the resource you want to test.
  • Private browser monitors can be executed on an Environment ActiveGate installed on Ubuntu Server 16.04, Red Hat Enterprise Linux 7, or CentOS 7. Since ActiveGate version 1.173 you can also run private browser monitors on Windows Server 2016.
  • Make sure your hardware is strong enough to run private browser monitors. Synthetic-enabled Environment ActiveGate is more demanding in terms of hardware requirements. See ActiveGate hardware and system requirements.


  • You can create maximum of 100 private locations for a tenant and maximum of 200 locations can be assigned to an individual synthetic browser monitor.
  • In Dynatrace Managed offline deployments, you won't be able to save screenshots.

Setting up browser monitors in private locations

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.

ActiveGate Chromium
1.169+ 73

Step 2. Install a synthetic-enabled Environment ActiveGate.

Install a clean synthetic-enabled Environment ActiveGate and add it to a private synthetic location. For more information, see Installing synthetic-enabled ActiveGate. You must perform a clean ActiveGate installation in Synthetic monitoring mode to use it for private browser monitors.

Step 3. Create a browser monitor

Create a single-URL browser monitor or a clickpath and assign it to a private location you've just created.

Questions and answers