Using a script to simulate end-user transactions

BMC Synthetic End User Experience Monitoring uses prerecorded .ltz scripts to simulate end-user transactions, and BMC provides some basic scripts. You can create realistic and customizable scripts through an external scripting tool, and then upload the scripts through the BMC Application Management Console. The scripts require a compatible execution module. For details about supported scripting environments, see System-requirements-for-BMC-Synthetic-Transaction-Execution-Adapter.

Note

When executing scripts, TEA agents require the same user privileges as a real user would. For example: if you would normally require administrator-level privileges to access the monitored application, the TEA agent requires the same level of privileges to run a script on that application.

The following topics are presented:

Provided scripts

The following scripts are provided out-of-the-box and cannot be deleted:

Script name

Description

FtpPinger.ltz

Checks the availability of an FTP server by connecting to it and retrieving the current directory of the server. The script requires the following parameters:

  • Host - (required) Host that is monitored.
  • Port - FTP port. Default is 21.
  • User - User name for authentication on the server.
  • Password - Password for user validation on the server.
  • Timer Name - Name of the FTP ping timer.

Pinger.ltz

Checks the availability of a specific host by sending it an Internet Control Message Protocol (ICMP) echo request via TCP/IP. The script requires the following parameters:

  • Host - (required) Host that is monitored.
  • Ping Timeout - Timeout value for the ping in seconds.
  • Number of Pings - Number of pings to be sent.
  • Data Size - Size of the data package to be sent in bytes.
  • Timer Name - Name of the IMCP ping timer.

URLChecker.ltz

Checks a URL by downloading its page and embedded objects and verifying the title and content. The script requires the following parameters:

  • URL - (required) The URL being monitored.
  • HTTP Proxy host - Proxy host to URL if required.
  • HTTP Proxy port - Proxy port to URL if required.
  • Use HTTP 1.0 through proxy connections - Indicates whether to use HTTP 1.0 when connecting to Web sites by using a proxy server. Some proxies have problems using HTTP 1.1. If you are experiencing difficulties, try selecting this.
  • Bypass proxy server for local addresses - If you select this, the browser-level functions bypass proxies to hosts that do not contain a period in their names.
  • Do not use proxy server for - List of host names and IP addresses that you do not want routed through the proxy. Host names are separated by spaces. The list can include wildcards.
  • Verify if the title is - String to be used for title verification.
  • Raise error if the title is - An error is raised if the title contains this string.
  • Verify if the content contains - String to be used for content verification.
  • Raise error if the content contains - An error is raised if the title contains this string.
  • Suppress domains - List of domains (separated by spaces) from which files may not be requested. Wildcards cannot be used. For example, if you enter mydomain.com company.com, all host names that include these strings are suppressed. This is useful for suppressing embedded objects.
  • Link Checking - Select to check all links on the monitored page.
  • Detailed Page Timers - Select to enable detailed page timers

To view the list of available scripts

  1. On the BMC Application Management Console, click the Synthetic tab, then click the Scripts menu.
    A list of available scripts is displayed.
  2. To modify the display, you can perform any of the following actions:
    • To sort the list based on a specific column, click the relevant column heading. To sort in reverse order, click the column heading again.
    • To filter the list, start typing a value in the box under the File Name column heading.

To upload a custom script

  1. On the BMC Application Management Console, click the Synthetic tab, then click the Scripts menu.
  2. Below the list of scripts, click Add.
  3. Browse and select a script (.ltz) file.
    You can add up to ten scripts to the list before uploading. After uploading, you can add more scripts.
  4. Click Upload.

To delete a script from the list

  1. On the BMC Application Management Console, click the Synthetic tab, then click the Scripts menu.
  2. From the shortcut menu of the specific script, select DeleteScript.
  3. Click OK in the confirmation message.

Related topic

Examining-and-retaining-Execution-Plan-results-files

 

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*