Settings API - Outage handling schema table

  • Published Dec 05, 2023

Outage handling (builtin:synthetic.http.outage-handling)

Dynatrace can generate problems for both global outages and/or local outages based on the availability of either all configured locations or only individual locations over consecutive runs.

Schema IDSchema groupsScope
builtin:synthetic.http.outage-handling
  • group:web-and-mobile-monitoring
  • group:web-and-mobile-monitoring.http-monitor-default-settings
HTTP_CHECK - HTTP monitor
environment
GETManagedhttps://{your-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:synthetic.http.outage-handling
SaaShttps://{your-environment-id}.live.dynatrace.com/api/v2/settings/schemas/builtin:synthetic.http.outage-handling
Environment ActiveGatehttps://{your-activegate-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:synthetic.http.outage-handling

Authentication

To execute this request, you need an access token with Read settings (settings.read) scope. To learn how to obtain and use it, see Tokens and authentication.

Parameters

PropertyTypeDescriptionRequired
Generate a problem and send an alert when the monitor is unavailable at all configured locations.
globalOutages		boolean-required
Alert if all locations are unable to access my web application
globalConsecutiveOutageCountThreshold		integer-required
Generate a problem and send an alert when the monitor is unavailable for one or more consecutive runs at any location.
localOutages		boolean-required
Alert if at least
localLocationOutageCountThreshold		integer-required
are unable to access my web application
localConsecutiveOutageCountThreshold		integer-required