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 a simple procedure below to participate in the EAP. If you want to use an existing ActiveGate machine, uninstall it first.
  • For ActiveGate version 1.161 and 1.163, you have to configure ActiveGate manually so that it's exclusively running private browser monitors. This step isn't 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 Server 16.04, Red Hat Enterprise Linux 7 (ActiveGate version 1.165 and later), or CentOS 7 (ActiveGate version 1.165). Future updates will add support for Windows Server 2016.
  • 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 71
1.167 71

Limitations

  • 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.

Setting up browser monitors in private locations

During the EAP, you have to manually manage the dependencies and proper versions of ActiveGate and Chromium required by the browser monitors engine. This is only required for the EAP and will be managed automatically when the feature goes GA.

To start executing browser monitors from a private location:

  1. Register for the EAP and wait for an email from Dynatrace confirming that you can proceed with the installation.
  2. Install all the required dependencies. Depending on your operating system, follow the steps for Ubuntu or Red Hat/CentOS.
  3. Install synthetic-enabled ActiveGate and add it to your private synthetic location.

Installing dependencies on Ubuntu Server 16.04

  1. Install private browser monitors engine dependencies:
sudo apt-get update && 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.
    curl https://s3.amazonaws.com/synthetic-packages/Chromium/deb/chromium-browser_69-ubuntu.16.04.1_amd64.deb --output chromium-browser_69-ubuntu.16.04.1_amd64.deb
    curl https://s3.amazonaws.com/synthetic-packages/Chromium/deb/chromium-codecs-ffmpeg-extra_69-ubuntu.16.04.1_amd64.deb --output chromium-codecs-ffmpeg-extra_69-ubuntu.16.04.1_amd64.deb
    
  • Install downloaded packages. Go to the directory where you saved the packages and run the following command:
    sudo dpkg -i chromium-browser_69-ubuntu.16.04.1_amd64.deb chromium-codecs-ffmpeg-extra_69-ubuntu.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

Installing dependencies on Red Hat Enterprise Linux 7 or CentOS 7

  1. Set up repositories
  1. Install private browser monitors engine dependencies
sudo yum install -y zip xorg-x11-server-Xvfb xorg-x11-xkb-utils xorg-x11-server-utils xorg-x11-fonts-100dpi xorg-x11-fonts-75dpi xorg-x11-fonts-Type1 curl
  1. Download and install Chromium
  • Download rpm packages and save them to a convenient place. These are safe and verified packages hosted by Dynatrace.
    curl https://s3.amazonaws.com/synthetic-packages/Chromium/rpm/chromium-71.el7.x86_64.rpm --output chromium-71.el7.x86_64.rpm
    curl https://s3.amazonaws.com/synthetic-packages/Chromium/rpm/chromium-common-71.el7.x86_64.rpm --output chromium-common-71.el7.x86_64.rpm
    curl https://s3.amazonaws.com/synthetic-packages/Chromium/rpm/chromium-libs-71.el7.x86_64.rpm --output chromium-libs-71.el7.x86_64.rpm
    curl https://s3.amazonaws.com/synthetic-packages/Chromium/rpm/chromium-libs-media-71.el7.x86_64.rpm --output chromium-libs-media-71.el7.x86_64.rpm
    
  • Install downloaded packages. Go to the directory where you saved the packages and run the following command:
    sudo yum install -y chromium-71.el7.x86_64.rpm chromium-common-71.el7.x86_64.rpm chromium-libs-71.el7.x86_64.rpm chromium-libs-media-71.el7.x86_64.rpm
    

Installing synthetic-enabled Environment ActiveGate.

Install a synthetic-enabled Environment ActiveGate and add it to a private synthetic location. For more information, see Installing synthetic-enabled ActiveGate.

Troubleshooting

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.