GetAlertHistory

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:

https://gpn.webservice.gomez.com/AlertManagementService20/AlertManagementWS.asmx/GetAlertHistory?username=string&password=string&monitorType=string&startTime=string&endTime=string

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

  • username—The account username
  • password—The 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’, ‘PP_MONITOR’,’ LM_MONITOR’, ‘LM_TRANSACTION’, ‘PP_TRANSACTION’, ‘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>

Note

If the request time frame (from startTime to endTime) is older than 33 days, data may not be returned, because data older than 33 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="http://gomeznetworks.com/webservices/"
                      xmlns:xsd="http://www.w3.org/2001/XMLSchema"
                      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
        <status>FAILED</status>
        <errorMessage>Invalid Account Specified</errorMessage>
</alertHistoryResponse>

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

<alertHistoryResponse xmlns="http://gomeznetworks.com/webservices/"
                      xmlns:xsd="http://www.w3.org/2001/XMLSchema"
                      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
      <status>SUCCESS</status>
       <alertSummary progression="Condition Improved"
         alertState="GOOD"
         alertType="Page Response Time"
         alertId="2005"
         monitorId="213307"
         messageId="148">
          <messagePayload>
           <GPN_MESSAGE xmlns:xsd="http://www.w3.org/2001/XMLSchema"
            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
             <msgType>GPN_ALERT_MESSAGE</msgType>
              <reportHost>TPNQA</reportHost>
              <snmp>
               <baseoid>1.3.6.1.4.1.6311.1.1.2.1</baseoid>
               <trapoid>1.3.6.1.4.1.6311.1.1.2.1.2.9.0</trapoid>
              </snmp>
              <alert>
                 <alertId>2005</alertId>
                 <time>Apr 13 2012 02:48PM</time>
                 <GMTtime>Apr 13 2012 06:48PM</GMTtime>
                 <status>GOOD</status>
                 <nodeThreshold>1</nodeThreshold>
                 <nodeActual>0</nodeActual>
                 <isPercent>1</isPercent>
                 <isAllSites>0</isAllSites>
                 <persistentInterval>15</persistentInterval>
                 <progressionState>Condition Improved</progressionState>
                 <responseTime>
                   <baselineRange>1</baselineRange>
                   <localRange>5</localRange>
                   <WarningThreshold>1100</WarningThreshold>
                   <SevereThreshold>2200</SevereThreshold>
                   <isMetricPercent>0</isMetricPercent>
                   <isHardLimit>0</isHardLimit>
                   <atWarning>0</atWarning>
                   <atSevere>0</atSevere>
                 </responseTime>
               </alert>
               <account>
                 <acctId>1085</acctId>
                 <acctName>Alert Regression 1</acctName>
               </account>
               <monitor xsi:type="UTAPayload">
                 <monid>213307</monid>
                 <mondesc>Jason_Demo - IE Agent</mondesc>
                 <class>TRANSACTION</class>
                 <freq>900</freq>
                 <compflg>1</compflg>
                </monitor>
                <pageInfo>
                  <pageSeqNum>0</pageSeqNum>
                  <pageDesc>planes - Google Search</pageDesc>
                  <pageUrl>http://www.google.com/</pageUrl>
                </pageInfo>
               </GPN_MESSAGE>
              </messagePayload>
       </alertSummary>
</alertHistoryResponse>

Output

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 Dynatrace Synthetic Monitoring message ID    
monitorId Dynatrace Synthetic Monitoring 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>