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.

Private Synthetic location settings

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.

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.

For charting and alerting, you can use our new metrics for capacity usage by each monitor type to get an accurate view of location health—be sure to split these metrics by location (see Location details below).

Status icon Description

Green icon

The capacity usage of each type of synthetic monitor is below 80%, which is desirable.

Yellow icon

This icon can mean any of the following:

  • The capacity usage of a least one type of synthetic monitor is more than 80%.
  • There is no failover because:
    • Failure of any ActiveGate or Synthetic engine can cause usage requirements to exceed maximum capacity.
    • There is only one ActiveGate assigned to the location.

Red icon

  • Capacity usage of at least one type of synthetic monitor is greater than 90% or not all synthetic monitors assigned to this location are being executed. Note that some monitor executions may be dropped when there is a brief spike in capacity usage for a monitor type, as when several monitors are updated at the same time.
  • This icon is also displayed when all ActiveGates or all Synthetic engines at the location are down.

If a location is down or if a Synthetic engine/ActiveGate is offline, synthetic monitors assigned to that location will not be executed.

Grey icon

There is no data, as when ActiveGates are lower than version 1.217 and capacity usage data cannot be gathered.

Location details

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.

Private location details

Metrics for the health status of each monitor type are available for charting and alerting. For example, choose the following metrics in the Metrics browser or the Data explorer:

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

Private location capacity usage

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.

    Banner notification

From the main settings page listing all your private Synthetic locations, you can select multiple locations for bulk management of outage handling.

  1. Select the check box next to each location you want to manage.

  2. Select Edit in the lower-left corner of the page.

    Bulk edit locations

  3. Select the appropriate outage handling check box.

  4. Enable/disable the toggle below. This will overwrite the corresponding setting for the selected locations.

    Bulk edit location outage handling

  5. Save changes.