Provision a single step browser test (ProvisionTests)

For this use case, you want to define a browser test that contains a single test step defined by a single URL. The URL references either a single web page or an application that handles all HTTP requests to that URL. This use case does not require the creation of a GSL script via the Recorder.

At a high level, first decide the IP version that the test will use (IPv4_only, IPv6_only, or IPv6_preferred). Determine which Backbone nodes (also called sites) are available to your account and that support the chosen IP version preference. Next, decide whether the test is to run on all the available sites or only a subset of those sites. The web service provides a method to get the list of available sites for the account and indicates, for each site whether IP version 6 is supported.

Additionally, you can set the following parameters on the browser test:

  • [test] name

  • agentType

  • summaryFlag

  • includeRenderTimeFlag

  • expirationDate

  • folder

  • frequencyInMins

  • monitorStatus

  • folderStatus

The provisioning request may contain zero to many single step browser test definitions and zero to many multistep browser test definitions.

The provisioning response shows whether processing was completely successful and provides that information both at the level of the entire request and at the level of each browser test definition submitted to the system.

Sample request

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:prov="http://www.gomeznetworks.com/schemas/provisioning">
   <soapenv:Header/>
   <soapenv:Body>
      <prov:ProvisionTestsRequest>
         <prov:Credentials>
            <prov:UserName>MyUser</prov:UserName>
            <prov:Password>MyPassword</prov:Password>
         </prov:Credentials>
         <prov:SingleStepMonitors>
            <prov:SingleStepMonitor name="Provision Single Step Monitor 002"
                                    folder="Dynatrace Testing"
                                    agentType="FF"
                                    summaryFlag="Off"
                                    includeRenderTimeFlag="Off"
                                    frequencyInMins="60"
                                    expirationDate="2012-08-01T10:10:10"
                                    ipVersion="IPv4_only"
                                    monitorStatus="Active"
                                    folderStatus="Active">
               <prov:MonitorSites>
                  <prov:MonitorSite siteId="884" />
               </prov:MonitorSites>
               <prov:URL>http://www.dynatrace.com</prov:URL>
            </prov:SingleStepMonitor>
         </prov:SingleStepMonitors>
         <prov:MultiStepMonitors>
            <prov:MultiStepMonitor name="Provision Multi Step Monitor 002"
                                   folder="Dynatrace Testing"
                                   agentType="IE"
                                   summaryFlag="Off"
                                   includeRenderTimeFlag="Off"
                                   frequencyInMins="60"
                                   expirationDate="2012-08-01T10:10:10"
                                   ipVersion="IPv4_only"
                                   monitorStatus="Active"
                                   folderStatus="Active"
                                   scriptId="258244">
               <prov:MonitorSites>
                  <prov:MonitorSite siteId="886"/>
               </prov:MonitorSites>
            </prov:MultiStepMonitor>
         </prov:MultiStepMonitors>
      </prov:ProvisionTestsRequest>
   </soapenv:Body>
</soapenv:Envelope>

Sample response

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
               xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
               xmlns:xsd="http://www.w3.org/2001/XMLSchema">
   <soap:Body>
      <ProvisionTestsResponse xmlns="http://www.gomeznetworks.com/schemas/provisioning">
         <ResponseStatus>SUCCESS</ResponseStatus>
         <MonitorOrderResponses>
            <MonitorOrderResponse name="Test 08-14-2012 MyUser 002"
                                  monitorId="293256"
                                  monitorStatus="Active"
                                  orderStatus="SUCCESS">
               <Message>Successfully provisioned monitor: AccountName =
                        My Account Name, MonitorName = Test 08-14-2012 MyUser 002,
                        MonitorId =293256</Message>
            </MonitorOrderResponse>
         </MonitorOrderResponses>
      </ProvisionTestsResponse>
   </soap:Body>
</soap:Envelope>