Manage private Synthetic locations
Add a private Synthetic location as well as analyze and manage capacity usage in the Private synthetic locations global settings page (select the Private synthetic locations settings page from search results).Early Adopter Synthetic-enabled ActiveGate version 1.217+ Dynatrace version 1.218+
Overall location status
Private Synthetic locations in your environment are listed with green, yellow, red, or gray indicators of overall capacity usage status. You can see the type and number of synthetic monitors as well as the number of Synthetic-enabled ActiveGates assigned to each location.
Select the monitor type (HTTP or Browser) to see the list of synthetic monitors of that type at that location.
You can select multiple locations for bulk management of outage handling. Select the check box next to each location you want to manage.
The colored status indicator for each location shows if it's overloaded in terms of capacity usage, enabling you make educated decisions about adding more ActiveGates in order to run additional monitors. (Also check system and hardware requirements for private Synthetic locations.)
For usage calculations on each ActiveGate, Dynatrace allocates CPU and RAM resources for running each type of monitor. Resource allocation per monitor type is resolved into the maximum number of simultaneous monitor executions that may take place at any given point in time. Actual capacity usage calculation per monitor type (see Location details below) is based on the number of concurrently executed monitors compared to the maximum allowed simultaneous executions over the preceding 30 minutes.
For example, an ActiveGate might support two simultaneous browser monitor executions at a given point. However, depending on the duration of the monitors being executed, this could equate to more than two monitors being executed within a given timeframe. For example, one 55-second monitor and three 10-second monitors could be executed within a single minute with no more than two simultaneous executions at any given point.
Metrics for capacity usage per monitor type provide an accurate view of Synthetic location health and can be used for charting and alerting—be sure to split these metrics by location (see Location details below).
The capacity usage of each type of synthetic monitor is below 80%, which is desirable.
This icon can mean any of the following:
If a location is down or if a Synthetic engine/ActiveGate is offline, synthetic monitors assigned to that location will not be executed.
There is no data, as when ActiveGates are lower than version 1.217 and capacity usage data cannot be gathered.
Select a location to see the breakdown of its overall status into capacity usage per monitor type. For each of these monitor types, you can see the number of monitors and hourly scheduled executions as well the capacity use percentage.
- HTTP monitors
- High-resource HTTP monitors
- Browser monitors
You cannot see usage data per monitor type when all ActiveGates or Synthetic engines at a location are down.
The ActiveGates assigned to the location are listed and displayed in red when a Synthetic engine or an ActiveGate itself is offline; the Status column displays a corresponding message. You can add or delete ActiveGates from here. Note that the Add ActiveGate button is disabled when there are no unassigned ActiveGates available—you can check for this in Deployment status.
- Synthetic - HTTP - Engine Utilization
- Synthetic - HTTP High Resource - Engine Utilization
- Synthetic - Browser - Engine Utilization We strongly recommend splitting these metrics by location to get an accurate view of location health.
You may Enable auto-update of Chromium at the location level, that is, for all ActiveGates assigned to a private location. This setting only applies to Linux-based ActiveGates; on Windows-based ActiveGates, Chromium is always updated during Synthetic engine updates.
As we recommend using the latest supported Chromium version for the smooth and secure execution of browser monitors from your private location, the Chromium auto-update toggle is turned on by default for locations with Linux-based ActiveGates. If your location has only Windows-based ActiveGates, the toggle is turned on but grayed out; Chromium is always automatically updated on Windows-based ActiveGates.
Note that Chromium auto-update takes place during manual as well as automatic ActiveGate and Synthetic engine updates. If you don't want Chromium to be updated automatically, for example, to use a specific version of Chromium or if you have offline environments, turn off the toggle before triggering an ActiveGate update.
- We strongly recommend that all ActiveGates per location be updated to the same version.
- The minimum ActiveGate version for which Chromium can be auto-updated is 1.223.
Successful Chromium auto-update requires access to repositories for Chromium dependencies. You will see a message if Chromium auto-update fails for this or other reasons—we recommend either meeting the requirements for auto-update (such as access to repositories) or disabling Chromium auto-update for your private location.
If you disable Chromium auto-update, you can install Chromium and other dependencies manually (Linux only).
Location outage handling
For each location, enable the corresponding switches generate problems when a location or any of its ActiveGates/Synthetic engines are unavailable:
You can generate a problem with the entire location is unavailable (all assigned ActiveGates or Synthetic engines are offline).
You can generate a problem when any single ActiveGate or Synthetic engine assigned to the location is offline.
For example, if your location has two ActiveGates and you enable both problem switches, you will see three problems when your location is unavailable, one for the entire location and one for each ActiveGate that's offline.
Additionally, you can opt to view a banner notification at the top of the Dynatrace web UI when either the entire location or any individual ActiveGate/Synthetic engine is unavailable.
From the main settings page listing all your private Synthetic locations, you can select multiple locations for bulk management of outage handling.
Select the check box next to each location you want to manage.
Select Edit in the lower-left corner of the page.
Select the appropriate outage handling check box.
Enable/disable the toggle below. This will overwrite the corresponding setting for the selected locations.