Page tree

Skip to end of metadata
Go to start of metadata

To run synthetic functionality on an application, you need to turn Synthetic on for the application and then configure the application accordingly.  To turn Synthetic on for an application, on the Edit Application page, set the Synthetic field for the application to ON.

Warning

If you set the Synthetic field to OFF, all synthetic configurations for the application, including all Execution Plans, are deleted.

To run synthetic functionality, you also must make sure the current status is set to Active.

Synthetic configuration includes the following:

  • Global SLA—Service Level Agreement that applies to all Execution Plans defined for this application
  • Execution Plans—Plans for running predefined scripts to simulate use of the application

An Execution Plan provides the interface for a script and its execution. Through an Execution Plan, you specify configuration values for the script, indicate on which locations the script runs, and define the run schedule.

BMC Synthetic Transaction Execution Adapter (TEA) Agents can process up to 120 Execution Plans each.

This topic contains the following procedures:

To define a Global SLA for your application

Note

You can also add custom SLA levels for individual execution plans. See To edit the Custom SLA for an Execution Plan for more details.

  1. On the TrueSight console, from the navigation page, select  Configuration > Applications .
  2. Click the action menu of the relevant application and select Edit.
  3. Click the Synthetic tab. 
     
  4. Click the  icon to open the Global SLA settings.
  5. For each metric, set the following options:
    • Minor Threshold and Critical Threshold  —Levels indicating when an event is triggered
      Default values are 10% for Minor and 20% for Critical.
    • Send Notification —Level of event that triggers a notification. The following options are available:
      • Never - An event is generated and the applications color indication is affected, but no notification is sent.
      • When minor or critical threshold is breached - An event is generated and notification is sent.
      • When critical threshold is breached -  An event is generated and the applications color indication is affected, but notification is sent only for critical events.
    • Transaction Latency —(Performance only) Threshold beyond which the latency triggers an event
      Default is 2000 milliseconds. 
    For more details about the specific metrics see Monitoring synthetic transactions by location and Monitoring synthetic transactions by execution.
  6. Click Save. 

Enabling and disabling synthetic SLA events

If you do not want SLA-based events to be generated, you can disable them. To do this, from the TrueSight Operations Management menu, select Configuration > Synthetic Metric Rules and scroll down to the bottom of the page to the Synthetic SLA section, and click the SLA Events switch to turn it off. The switch effects all applications.


If you have synthetic SLA events disabled, and you want to turn them on, you can use the same SLA Events switch.

Notes

  • SLA events are disabled by default in new installations.
  • SLA events remain enabled by default in upgrades from previous versions of TrueSight Operations Management.


To create or edit an Execution Plan

  1. On the TrueSight console, from the navigation page, select  Configuration > Applications .
  2. Click the action menu of the relevant application and select Edit.
  3. Click the Synthetic tab. 
    The Execution Plans that are defined for the application are listed. 
  4. Perform one of the following actions:
    • To define a new Execution Plan, on the Execution Plans action menu, click Create Execution Plan.
    • To edit a previously defined Execution Plan, from the action menu of the specific Execution Plan, select Edit Execution Plan Settings.
  5. In General Settings, configure the following settings:
    • Enter a unique Name for the Execution Plan and, optionally, a Description for the Execution Plan.
      The description appears in a tooltip when you place the cursor over the Execution Plan name on the list of Execution Plans.

      Note

      Execution Plan names must be unique within the same application configuration. You can use the same Execution Plan name in different application configurations.

    • To change the the Execution Plan Status, select Active or In active.
      The status of the Execution Plan determines whether the script runs. The Execution Plan is also affected by the status of the application. The status of the application takes precedence.
    • For a new Execution Plan: Select the script file that this Execution Plan runs.
      You cannot change the script when you edit an Execution Plan.
  6. In Script Attributes, set values for the script attributes that require user input, such as URLs, host names, and passwords.

    Note

    • App Visibility does not validate script attribute values. For information about provided scripts, see Using scripts to simulate end-user transactions.
    • Script attributes of scripts provided by BMC do not support non-English characters.
    • If you define the Execution Plan to run a Silk Test script on more than one location, ensure that each TEA Agent in each location has an administrator account that uses the same user name and password.  
  7. In Locations, you can assign or unassign locations where the Execution Plan runs. 

    • To assign locations to the Execution Plan, click Select Locations and select locations to add.
    • To unassignlocations from an Execution Plan, click Select Locations  and clear the check boxes for the relevant locations.

    Click  OK .

  8. In Execution Plan Schedule, you see a summary of the current schedule settings for the Execution Plan.

    To edit the schedule, click Edit Schedule.

    See the following video for a description on setting an Execution Plan schedule:


    In the Execution Plan Schedule dialog box, set the following options: 

    Repetition
    Repeat EverySet how often the Execution Plan runs. This must be a whole number of minutes or hours.
    • Minimum is 1 minute.
    • Maximumis 24 hours.
    • Defaultis 5 minutes.
    Timeout PeriodSet the amount of time the Execution Plan is allowed to run before it stops automatically.  
    Advanced Settings
    Coordinated Universal Time (UTC) Select this to schedule the Execution Plan according to UTC time.
    TEA Agent TimeSelect this to schedule the Execution Plan according to the local time of the TEA Agent where the Execution Plan runs.
    Random Start-Time Delay (Maximum in minutes)Set this to the maximum range of delay before the Execution Plan starts. A different delay value is randomly set for each location where the Execution Plan runs. In each location, the Execution Plan runs at start time + the random delay set for the Execution Plan in that location.
    • Minimum is 1 minute.
    • Maximumis 60 minutes.
    • Defaultis 5 minutes.

    See examples at the end of this procedure.

     

    Effective Immediately /
    Effective From 

    Select Effective Immediately to start running the Execution Plan immediately.

    Select Effective From to start running the Execution Plan from a specific date and time.

     

    Never Expire /
    Expire On
    Select Never Expire to indicate the Execution Plan should continue running and will never expire.
    Select Expire On to set an expiration date and time for the Execution Plan. The Execution Plan will not run anymore after the expiration date/time passes.

    Click  Save .

  9. In Blackouts, If you have blackout periods set for this Execution Plan, you see a table listing the blackout periods.

    The following details are shown in the table (see the descriptions the fields in the editing a blackout section below for more details):

    ColumnDescription
    Time ZoneThe clock used to calculate the blackout period:
    • UTC  - Coordinated Universal Time

    • Local - Local time of the TEA Agent running the Execution Plan
    PeriodTime period when the blackout period is in effect
    RecurrenceWhen, and how often the blackout period recurs
    DescriptionOptional description
    • To add a blackout period for this Execution Plan, click Add Blackout . See the following video for a description on adding blackouts:


    • To edit a blackout period for this Execution Plan, click Edit on the blackout period's action menu.


      In the Blackout Settings dialog box, set the following options:

      Description (optional)
      Enter a logical name or description for the blackout period.
      Time Period
      Coordinated Universal Time (UTC) / TEA Agent Local TimeSelect Coordinated Universal Time (UTC) to schedule the blackout according to UTC time.
      Select TEA Agent Local Time to schedule the blackout according to the local time of the TEA Agent where the Execution Plan runs.
      Effective Immediately /
      Effective From
      • Effective Immediately - Start using the blackout period immediately. 

      • Effective From - Select a time and date from which the blackout period is in effect.
      Never Expire /
      Expire On
      • Never Expire - The blackout period continues running and never expires.

      • Expire On - Expiration date and time for the blackout period. The blackout period does not run anymore after the expiration date/time passes.

        Note

         The blackout period includes the entire minute indicated in the Expire On field. For example, if you select 8:00 as your expiration time, the blackout continues until 8:00:59.

      Recurrence
      All DaySelect this to set the blackout period to cover the entire day for the selected days.
      Start Time, End TimeSelect the start and end times of the blackout period for the selected days of the week. The same Start Time and End Time apply to all selected days.
      Days of the weekSelect the days of the week when the blackout period takes effect. At least one day must be selected.

      Click Save.

    • To delete a blackout period, click Delete on the action menu for the blackout period.

  10. Click Save to save the Execution Plan settings.

Note

Initial configuration operations might take several minutes to take effect, depending on the heartbeat interval of the TEA Agent (30 seconds, by default) and the amount of time to download the scripts to the TEA Agent computer. 

Random Start-Time Delay Examples


Random Start-Time Delay randomly assigns start times over a set range so that all Execution Plans do not start at the same time and overload the system.

Example A

Execution Plan Test_Purchase is set to run every 5 minutes in 3 locations (A, B, and C) with a Random Start-Time Delay setting of 5 minutes. The random values are automatically assigned over the five-minute interval (for example, 1:34, 3:28, and 2:56).The results would be as follows:

LocationExecution Times
A00:01:34, 00:06:34, 00:11:34, ...
B00:03:28, 00:08:28, 00:13:28, ...
C00:02:56, 00:07:56, 00:12:56, ...

Example B

Execution Plan Test_Run is set to run every 10 minutes in 5 locations, with a Random Start-Time Delay setting of 20 minutes. The random values are automatically assigned over the twenty-minute interval (for example, 11:59, 3:13, 7:38, 18:27, and 17:34). The results would be as follows:

LocationExecution Times
A00:11:59, 00:21:59, 00:3 1:59 , 00:4 1:59, ...
B00:03:13, 00:13:13, 00:23:13, 00:33:13, ...
C00:07:38, 00:17:38, 00:27:38, 00:37:38, ...
D00:18:27, 00:28:27, 00:38:27, 00:48:27, ...
E00:17:34, 00:27:34, 00:37:34, 00:47:34, ...

 

To edit the Custom SLA for an Execution Plan

  1. On the TrueSight console, from the navigation page, select  Configuration > Applications .
  2. Click the action menu of the relevant application and select Edit.
  3. Click the Synthetic tab. 
    The Execution Plans that are defined for the application are listed. 
  4. From the action menu of the specific Execution Plan, select Custom SLA.
  5. For each metric that you want to set differently from the Global SLA, set Value Type for the metric you want to customize to Custom, and then set the following options:
    • Minor Threshold  and  Critical Threshold—Levels indicating when an event is triggered
    • Send Notification —Level of event that triggers an automatic notification.  The following options are available:
      • Never  - An event is generated and the applications color indication is affected, but no notification is sent.
      • When minor or critical threshold is breached  - An event is generated and notification is sent.
      • When critical threshold is breached -  An event is generated and the applications color indication is affected, but notification is sent only for critical events.
       
    • Transaction Latency—(Performance only) Threshold beyond which the latency triggers an event.

    For more details about the specific metrics, see Monitoring synthetic transactions by location and Monitoring synthetic transactions by execution.
  6. Click Save.

To reset the SLA for an Execution Plan to the Global SLA

  1. On the TrueSight console, from the navigation page, select  Configuration > Applications .
  2. Click the action menu of the relevant application and select Edit.
  3. Click the Synthetic tab. 
    The Execution Plans that are defined for the application are listed. 
  4. From the action menu of the specific Execution Plan, select Reset to Global SLA.
    A confirmation message appears asking if you want to reset the SLA for this Execution Plan. 
  5. Click Yes.

To deactivate an Execution Plan

  1. On the TrueSight console, from the navigation page, select  Configuration > Applications .
  2. Click the action menu of the relevant application and select Edit.
  3. Click the Synthetic tab. 
    The Execution Plans that are defined for the application are listed. 
  4. From the action menu of the specific Execution Plan, select Deactivate.

To activate an Execution Plan

  1. On the TrueSight console, from the navigation page, select  Configuration > Applications .
  2. Click the action menu of the relevant application and select Edit.
  3. Click the Synthetic tab. 
    The Execution Plans that are defined for the application are listed. 
  4. Place the mouse cursor over the Inactive status of the Execution Plan to see why the Execution Plan is inactive. 
     

  5. If the deactivation is at the Execution Plan level, from the action menu of the Execution Plan, select Activate.

To delete a defined Execution Plan

  1. On the TrueSight console, from the navigation page, select  Configuration > Applications .
  2. Click the action menu of the relevant application and select Edit.
  3. Click the Synthetic tab. 
    The Execution Plans that are defined for the application are listed. 
  4. From the action menu of the specific Execution Plan, select Delete.
  5. Click Save.

Related topics

Using scripts to simulate end-user transactions

Application and Execution Plan status

Daylight saving time and blackout periods

Preparing Silk Test script execution for synthetic transaction monitoring

Managing synthetic metric rules