CreateAlertConfiguration (3.0)

This POST web method can create a configured test level transaction failure and/or test level response time alert on a specified Backbone monitor.

Request parameters

To call this web service, submit the following HTTP POST request:

  • SOAP endpoint: https://gpn.webservice.gomez.com/AlertManagementService30/AlertManagementWS.asmx
  • OPERATION: CreateAlertConfiguration
  • SOAP ACTION: http://www.gomeznetworks.com/webservices/CreateAlertConfiguration
  • Context
  • Credentials, as defined in the following table.
Parameter Description
UserName Dynatrace Synthetic Classic username.
Password Dynatrace Synthetic Classic password.
apitoken Dynatrace Synthetic Classic API token used in lieu of username/password.
monitorAlertConfiguration/monid Monitor ID of the monitor to be configured. Alerts are configured for one monitor at a time.

Alert configurations

There are two types of alert configurations: Transaction Failure alert and Response Time alert. Either or both types can be configured.

Transaction Failure alerts

alertConfigurations/TransactionAlert

Parameter Description and values
isEnabled TRUE to enable alert. FALSE to disable alert.
persistenceIntervalInMin Set the frequency of reminders, in minutes. Values: 0, 5, 10, 15, 30, 60, 120, 360, 720.
consecErrThreshold Select the minimum number of consecutive errors that trigger an alert. Values: 1, 2, 3, 4, 5.
retryOnError TRUE to enable Retry on Error. FALSE to disable.
siteThreshold/type Values: ABSOLUTE or PERCENT
  • PERCENT – The minimum Percent of Nodes must experience the error to trigger an alert.
  • ABSOLUTE – The minimum Number of Nodes that must experience the error to trigger an alert.
siteThreshold/value Percent of Nodes or Number of Nodes.

targetLevels/targets – zero to many

Parameter Description and values
alertLevel Alert level for the alert destination. Values: FAILED, IMPROVED.
alertDestination Name of the alert destination.
sendReminder TRUE to enable reminders. FALSE to disable reminders. Ignored for Improved alert level.

Response Time alerts

Response Time alerts are provided as two types: Dynamic and Static. Only one may be selected per call.

alertConfigurations/DynamicResponseTimeAlert

Parameter Description and values
isEnabled TRUE to enable alert. FALSE to disable alert.
persistenceIntervalInMin Set the frequency of reminders, in minutes. Values: 0, 5, 10, 15, 30, 60, 120, 360, 720.
consecErrThreshold Select the minimum number of consecutive errors that trigger an alert. Values: 1, 2, 3, 4, 5.
baselineResponseRangeInDays Length of historical window, in days. Values: 1, 2, 3, 4, 5, 6, 7.
localResponseRangeInMinutes Length of current window. Values: 5, 10, 15, 30, and 60 to 1440 in 60-minute increments.
siteThreshold/type Values: ABSOLUTE or PERCENT.
  • PERCENT – The minimum Percent of Nodes must experience the error to trigger an alert.
  • ABSOLUTE – The minimum Number of Nodes that must experience the error to trigger an alert.
siteThreshold/value Percent of nodes or number of nodes.
warningThreshold/type The alert status is based on the difference between the current average and the historical average. You can configure the Warning thresholds as an absolute number of seconds or as a percentage. Values: ABSOLUTE or PERCENT.
warningThreshold/value Percent or number of seconds.
severeThreshold/type The alert status is based on the difference between the current average and the historical average. You can configure the Severe thresholds as an absolute number of seconds or as a percentage. Values: ABSOLUTE or PERCENT.
severeThreshold/value Percent or number of seconds.

targetLevels/targets – zero to many

Parameter Description and values
alertLevel Alert level for the alert destination. Values: FAILED, WARNING, IMPROVED.
alertDestination Name of the alert destination.
sendReminder TRUE to enable reminders. FALSE to disable reminders. IGNORED for Improved alert level

alertConfigurations/StaticResponseTimeAlert

Parameter Description and values
isEnabled TRUE to enable alert. FALSE to disable alert.
persistenceIntervalInMin Set the frequency of reminders, in minutes. Values: 0, 5, 10, 15, 30, 60, 120, 360, 720.
consecErrThreshold Select the minimum number of consecutive errors that trigger an alert. Values: 1, 2, 3, 4, 5.
warningThresholdInMS Time in milliseconds for Warning threshold.
severeThresholdInMS Time in milliseconds for Severe threshold.
siteThreshold/type Values: ABSOLUTE or PERCENT.
  • PERCENT – The minimum Percent of Nodes that must experience the error to trigger an alert.
  • ABSOLUTE – The minimum Number of Nodes that must experience the error to trigger an alert.
siteThreshold/value Percent or number of nodes.

targetLevels/targets - zero to many

Parameter Description and values
alertLevel Alert level for the alert destination. Values: FAILED, WARNING, IMPROVED.
alertDestination Name of the alert destination.
sendReminder TRUE to enable reminders. FALSE to disable reminders. IGNORED for Improved alert level.

Sample request

Sample Response