Adding Resource Monitoring sources to a performance schedule by using labels

You can add the Resource Monitoring sources to a performance schedule in Rational® Performance Tester by using labels that are created in Rational® Test Automation Server. After you add the Resource Monitoring sources, you can run the schedule from Rational® Performance Tester.

Before you begin

You must have added labels for the Resource Monitoring sources in your Rational® Test Automation Server project. See Add Resource Monitoring labels.

Important: Note down the labels that you added to the Resource Monitoring sources in your Rational® Test Automation Server project because you must use these labels for adding the Resource Monitoring sources to the performance schedule in Rational® Performance Tester.

Note: When you run the same schedule from Rational® Test Automation Server, the same labels are displayed in the Results page for the schedule. Open the schedule and go to the Details card to view the resource monitoring labels for the schedule that you run.

About this task

After you add the Resource Monitoring sources by using labels to a performance schedule, you can run the schedule from Rational® Performance Tester. After the schedule run completes, you can view the labels and the Resource Monitoring sources associated with those labels in Performance Report > Resources page. The Resources page also displays the Resource Monitoring sources that were unreachable or unavailable during the schedule run.

Procedure

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

A schedule can be a VU schedule or a Rate schedule.

The schedule is displayed in a schedule editor.
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 check box.
  
  The Resource Monitoring options related to the Resource Monitoring from Service category are displayed.
Select the Collect from sources matching at least one of the following labels option.

You can add the available Resource Monitoring sources by using labels in the schedule editor by performing the following steps:
1. Click Add to add the labels of the Resource Monitoring source.
  
  The Add Label dialog box is displayed.
  
  Note: The labels that you added for the Resource Monitoring sources in your Rational® Test Automation Server project are available for selection. You can also add a label in a performance schedule, and then use the same label for a Resource Monitoring source in your Rational® Test Automation Server project before running the schedule.
2. Enter or select a label in the Enter a label field.
3. Click OK.
  
  The label is added to the Data Source table.
  
  Note: You can add multiple labels to a performance schedule if required.
  
  Optionally, you can edit or delete the labels that you added if required. Select the label from the Data Source table. You can then click Edit to edit an existing label. If you want to remove an existing label that you do not want to use in the schedule, select the label, and then click Remove.
4. Set the polling time for the Resource Monitoring sources by performing the following steps:
  1. Enter a time duration in the Polling Time box.
  2. Set a time unit.
    The default polling time is 5 seconds.
  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 at every 5 seconds.
Select the Ignore invalid resources when executing the schedule check box to suppress any error message about the Resource Monitoring sources and continue running the schedule during the schedule run.

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.
Save the schedule.

Results

You have enabled Resource Monitoring service for a performance schedule, and then added the Resource Monitoring sources by using labels 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 labels and the Resource Monitoring sources in the Performance Report as follows:

The Resources page displays the following information:
- Labels and Resource Monitoring sources associated with those labels that were monitored during the schedule run.
- All resource counters for those Resource Monitoring sources that were monitored during the schedule run.
- Unavailable Resource Monitoring sources that were unreachable or unavailable during the schedule run.
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 that were monitored during the schedule run.