Browser monitors in private locations

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

This is an EAP feature available since Dynatrace version 1.162 and ActiveGate version 1.161. Register for the EAP to participate.

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.

Technical requirements for EAP

As this is an Early Access Program feature, we deliver it with some initial limitations and requirements that will be lifted once the feature becomes generally available.

  • The private browser monitors are executed on an Environment ActiveGate version 1.161 or later that is used exclusively for this task. Follow the procedure below and install a synthetic-enabled ActiveGate to participate in the EAP. If you want to use an existing ActiveGate machine, uninstall it first.
  • In the initial stages of the EAP, you have to configure ActiveGate manually so that it's exclusively running private browser monitors. This step is only an initial EAP requirement that won't be required as of version 1.165.
  • 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 EAP is currently available only on an Environment ActiveGate installed on Ubuntu 16.04 LTS. Future updates will add support for Red Hat Enterprise Linux and Windows Server.
  • During the EAP, you have to manually manage the dependencies and proper versions of ActiveGate and Chromium. This is only required for the EAP and will be managed automatically when the feature goes GA. See the table below to learn the supported pairs of ActiveGate and Chromium.
ActiveGate Chromium
1.161 69
1.163 71
1.165 72


  • You can create maximum of 200 private locations and maximum of 200 locations can be assigned to an individual synthetic browser monitor.
  • Private Browser Monitors EAP doesn't support a proxy. You must be able to establish a direct communication between both, the ActiveGate and the resource you want to test and between the ActiveGate and the Server. This limitation will be removed as of ActiveGate version 1.167.
  • In Dynatrace Managed offline deployments, you won't be able to save screenshots.

Hardware requirements

The Environment ActiveGate running browser monitors should meet the following hardware requirements depending on the number of tests executed per hour. The table below presents current limits of tests run from a single location and you won't be able to run more by scaling up the machine.

XS (2 vCPU) S (4 vCPU) M (8 vCPU) L (16 vCPU)
Min free disk 20 GB 25GB 30GB 40GB
Min RAM 4GB 8GB 16GB 32GB
Min free RAM 3GB 5GB 8GB 12GB
Max number of tests/h1 300 650 1200 2200

1 As determined in our internal tests. The actual value may vary, depending on the complexity of your monitors.


  1. Register for the EAP and wait for an email from Dynatrace confirming that you can proceed with the installation.

  2. Install private browser monitors engine dependencies:

sudo apt-get -y install zip xvfb x11-xkb-utils xfonts-100dpi xfonts-75dpi xfonts-scalable
  1. Install Chromium dependencies:
sudo apt-get -y install libasound2 libatk-bridge2.0-0 libatk1.0-0 libc6:amd64 libcairo2 libcups2 libgdk-pixbuf2.0-0 libgtk-3-0 libnspr4 libnss3 libxss1 xdg-utils
  1. Download and install Chromium.
  • Download deb packages and save them to a convenient place. These are safe and verified packages hosted by Dynatrace.
  • Install downloaded packages. Go to the directory where you saved the packages and run the following command:
    sudo dpkg -i chromium-browser_69.0.3497.81-0ubuntu0.16.04.1_amd64.deb chromium-codecs-ffmpeg-extra_69.0.3497.81-0ubuntu0.16.04.1_amd64.deb
  1. Optional Install non-latin TrueType fonts:
sudo apt-get install xfonts-cyrillic fonts-arphic-uming ttf-wqy-zenhei fonts-wqy-microhei ttf-wqy-microhei ttf-wqy-zenhei xfonts-wqy fonts-hosny-amiri
  1. Install Environment ActiveGate.

    • Select Deployment status from the navigation menu and click Install ActiveGate.
    • Click the Linux button.
    • Switch Enable synthetic monitoring to the On position.Enable synthetic monitoring
    • Download and install ActiveGate. For more information, see Install an Environment ActiveGate
  2. Add a private synthetic location.

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

Now you can add your private browser monitor executed from your new private synthetic location based on the EAP-enabled ActiveGate.


The ActiveGate installation failed due to missing dependencies

In such case, you must uninstall ActiveGate, satisfy the dependencies and run the installation again. For information, see Uninstall ActiveGate.