Adding Resource Monitoring sources to a performance schedule

You can add the Resource Monitoring sources to a performance schedule. After you add the Resource Monitoring sources, you can run the schedule from Rational® Performance Tester.

Before you begin

You must have completed the following tasks:

  • Accessed IBM® Rational® Test Automation Server.

  • Configured the Resource Monitoring sources in Rational® Test Automation Server for your project. For more information about Resource Monitoring sources, refer to Monitoring host resources.

  • Specified the Rational® Test Automation Server URL in the product preferences window (Window > Preferences > Test > Rational Test Automation Server > Resource Monitoring).

  • Generated an offline user token in Rational® Test Automation Server.

    For more information about generating an offline token, refer to Generating an offline token.

  • Selected the project in the product Preferences window from the Project to get sources from the drop-down list.

    Note: The Project to get sources from the drop-down list displays all the projects on Rational® Test Automation Server. The name of the team space for the project is displayed within parenthesis. You can select the appropriate project when there are identical project names in different team spaces.

About this task

You can add only Resource Monitoring sources that you added on the Resource Monitoring page of the Rational® Test Automation Server project to the schedule. The Resource Monitoring sources that are added in the team space are not available for selection.

You can add the Resource Monitoring sources to the schedule by using the labels. In this method, you can select all the Resource Monitoring sources that are added to Rational® Test Automation Server at the project and the team space level.

Procedure

  1. Find a schedule from the Test Navigator pane and double-click it.

    The schedule is displayed in a schedule editor.

    Note: A schedule can be a VU schedule or a Rate schedule.
  2. Perform the following steps in the Schedule Details section of the schedule editor:
    1. Select the Resource Monitoring from Service option from the Category drop-down list.
    2. Select the Enable resource monitoring from service checkbox.

      The methods of adding the Resource Monitoring sources are displayed.

  3. Select the Collect from the following sources option.
  4. Perform the following steps to select the Resource Monitoring sources to the schedule:
    1. Click Add/Remove.

      The list of Resource Monitoring sources that you added in Rational® Test Automation Server is displayed.

      Note: Only the Resource Monitoring sources that you added on the Resource Monitoring page of the Rational® Test Automation Server project is displayed. The Resource Monitoring sources that are added in the team space are not displayed.
      Tip: If you are unable to view the Resource Monitoring source in Sources from the Resource Monitoring Service dialog box, you can click Refresh to fetch the list of available Resource Monitoring sources.
    2. Select the Resource Monitoring sources that you want to add to the schedule.
    3. Click Finish.

      The selected Resource Monitoring sources are added to the schedule.

  5. Perform the following steps to set the Polling Time interval:
    1. Click the Polling Time option for the corresponding Resource Monitoring source that you added, and then click the Menu icon.
      The Set Time dialog box is displayed.
    2. Enter a time duration in the Polling interval field.
    3. Select the time unit from the drop-down list.
      Note: The default Polling Time is 5 Seconds.
    4. Click OK.

    The polling time is a time interval at which time the values for the Resource Monitoring source are collected when the schedule runs. For example, if you set the polling time as 5 seconds, data from the Resource Monitoring source is collected every 5 seconds.

  6. Select the Ignore invalid resources when executing the schedule checkbox to suppress any error message about the Resource Monitoring sources and continue running the schedule during the run time.
    Note: The errors can occur if the Resource Monitoring sources are unreachable or unavailable. After the schedule run completes, you can view the logs and verify the error messages.
  7. Save the schedule.

Results

You have enabled the Resource Monitoring service for the performance schedule and added the Resource Monitoring sources to the performance schedule in Rational® Performance Tester.

What to do next

You can add a test to the schedule and run the schedule in Rational® Performance Tester. After the run completes, you can view the details of the Resource Monitoring sources in the Performance Report as follows:
  • The Resources page displays the following information:
    • Resource monitoring sources that were monitored during the run time of the schedule.
    • All resource counters for those Resource Monitoring sources that were monitored during the run time of the schedule.
    • Unavailable Resource Monitoring sources that were unreachable or unavailable during the run time of the schedule.
  • The Performance Summary table under the Resources graph lists the following information:
    • The type of Resource Monitoring sources.
    • The most recent values of their corresponding resource counters were monitored during the run time of the schedule.