This web method retrieves the alert history for all MBG monitors of a specific type within a specified time range.
To call this web service from your browser, submit the following HTTP Get Request:
In the URL above, specify the following parameters:
username—The DPN account username
password—The DPN account password
monitorType—Specifies the class of MBG monitor data to retrieve. Specify one of the following values:
To return information for all monitor types (‘PRIVATEPEER’, ‘MOBILE’)
To return information for PRIVATEPEER tests only
To return information for MOBILE 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 33 days, data may not be returned, because data older than 33 days may not exist.
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 MBG 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.
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:
If the web service operation succeeds, the information requested is returned in the following XML format:
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
Top-level container of the XML response of this web service
Detailed error message if status=”FAILED”
Container for alert summary information and alert payload
DPN message ID
MBG monitor ID
The following integral values are possible for the different alert types:
102—Response Time Failure
The following values correspond to alertId values:
Transaction Failure (alertId=101)
Response Time Failure (alertId=102)
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.
The following values for progression are possible:
Initial—First alert sent in alertState.
Reminder—Alert sent repeatedly.
Condition Improved—alertState has changed from an alertable to a non-alertable state.