Synthetic Classic has reached end of support and is no longer available. Existing Synthetic Classic customers have been upgraded to the all-in-one Dynatrace software intelligence platform.

GetAlertHistory (2.0)

This web method retrieves the alert history for all Backbone monitors of a specific type within a specified time range.

Request parameters

To call this web service from your browser, submit the following HTTP Get Request:

In the URL above, specify the following parameters (listed and described below):

  • username — The Synthetic Classic account username
  • password — The Synthetic Classic account password
  • monitorType — Specifies the class of Backbone monitor data to retrieve. Specify one of the following values:
Value Description
ALL To return information for all monitor types ('MONITOR', 'BROWSER TRANSACTION')
BROWSERTX To return information for BROWSERTX tests only
  • startTime — Start time for the request window in format <YYYY-MM-DD hh:mm:ss>
  • endTime — End time for the request window in format <YYYY-MM-DD hh:mm:ss>

If the request time frame (from startTime to endTime) is older than 45 days, data may not be returned, because data older than 45 days may not exist.

Validation criteria

This web service uses the following criteria to validate the incoming request:

  • username is valid for an active account.
  • password is valid for the specified username.
  • monitorType specifies a valid monitor class.
  • startTime has a valid date/time format.
  • endTime has a valid date/time format.
  • The size of the request time frame (difference between startTime and endTime) must be less than or equal to 24 hours.

Response XML

This web service method returns information according to its operation status.

If the web service operation fails, the FAILED status and an error message are returned in the following XML format:

<alertHistoryResponse xmlns=""
        <errorMessage>Invalid Account Specified</errorMessage>

If the web service operation succeeds, the information requested is returned in the following XML format:

<alertHistoryResponse xmlns=""
       <alertSummary progression="Condition Improved"
         alertType="Page Response Time"
           <GPN_MESSAGE xmlns:xsd=""
                 <time>Apr 13 2012 02:48PM</time>
                 <GMTtime>Apr 13 2012 06:48PM</GMTtime>
                 <progressionState>Condition Improved</progressionState>
                 <acctName>Alert Regression 1</acctName>
               <monitor xsi:type="UTAPayload">
                 <mondesc>Jason_Demo - IE Agent</mondesc>
                  <pageDesc>planes - Google Search</pageDesc>


The following table summarizes the main elements, attributes, and possible attribute values in the XML response returned by this web service. See the Alert Management WSDL for the complete definition of this XML response.

XML Elements & Attributes Description Parent Element Child Elements
<alertHistoryResponse> Top-level container of the XML response of this web service none <status> <errorMessage> <alertSummary>
<status> {SUCCESS | FAILED} <alertHistoryResponse> none
<errorMessage> Detailed error message if status="FAILED" <alertHistoryResponse> none
<alertSummary> Container for alert summary information and alert payload <alertHistoryResponse> <messagePayload>
messageId Synthetic Classic message ID
monitorId Synthetic Classic monitor ID
alertId The following integral values are possible for the different alert types:
  • 1 — Page Host (BROWSERTX)
  • 2 — Page Inaccessible (BROWSERTX)
  • 3 — Page Object (BROWSERTX)
  • 4 — Transaction Failure (BROWSERTX)
  • 5 — Response Time (BROWSERTX)
  • 6 — Content Match (BROWSERTX)
  • 7 — Byte Limit (BROWSERTX)
  • 2004 — Page Transaction Failure (BROWSERTX)
  • 2005 — Page Response Time (BROWSERTX)
alertType The following values correspond to alertId values:
  • Page Host Failure (alertId=1)
  • Page Inaccessible Failure (alertId=2)
  • Page Object Failure (alertId=3)
  • Transaction Failure (alertId=4)
  • Response Time Failure (alertId=5)
  • Content Match Failure (alertId=6)
  • Byte Limit Failure (alertId=7)
  • Page Transaction Failure (alertId=2004)
  • Page Response Time Failure (alertId=2005)
alertState The following values for the current state of the alert are possible:
  • Good — No user-specified criteria has been violated.
  • Bad — Indicates a violation of user-specified non-response-time criteria.
  • Warning — Indicates a violation of user-specified response time criteria.
  • Severe — Indicates a violation of user-specified response time criteria.
progression The following values for progression are possible:
  • Initial — First alert sent in alertState.
  • Sample — Sample alert sent from the Portal.
  • Reminder — Alert sent repeatedly.
  • All Sites — alertState has been reached at all sites.
  • Condition Improved — alertState has changed from an alertable to a non-alertable state.
<messagePayload> Container for actual alert payload See Request Parameters for the complete schema definition of this element and its child elements and attributes. <alertSummary>