Configuring Request Logging

You can use a predefined configuration to log all the failed transactions. To do this:

1. Click Configure Transaction Log to capture failures on the Log page:

   

   Click the image to enlarge it.

2. The subsequent dialog asks you whether you want to save the log to a file. Click Yes to export the log to a file. In this case, you should specify the file to which you want to save the log.

   If you do not want to save the log to a file, click No. In this case, failed test cases will be logged only in the Transaction Log panel.

The configuration applied looks like this:

Click the image to enlarge it.

You can modify it later in the Logging Options dialog (see General Configuration below).

To configure the transaction log:

1. In the Performance Tests load test editor, switch to the Log page. Click or Configure Transaction Log conditions to open the Logging Options dialog.

   

   Click the image to enlarge it.

2. In the Logging Options dialog, you can edit conditions for transaction logging. The default condition checks if the simulation took longer than 0 and less than 1 second.

   To add more conditions, click . To delete conditions, click .

   

   Click the image to enlarge it.

3. In the Target drop-down list, select the test target for which the requests will be logged.

4. Select the value to be monitored. Available values are —

   • TimeTaken

   • HTTP Status Code

   • Bytes

   • Test step status

   • Script

5. Select the logging condition. Available options are:

   Option	Description
   Is	If selected, the request will be logged if it fits the specified conditions.
   Not	If selected, the request will be logged if it does not fit the specified conditions.

6. Select boundary values. For conditions based on Time Taken statistics, these are the Min and Max metrics.

7. If needed, add more conditions.

8. To select where ReadyAPI will store the log data, use the Log to drop-down list:

   Option	Description
   Transaction Log	Store transaction data in the Transaction Log table.
   File	Store transaction data in a standalone .csv file. Enter the fully-qualified file name. Choose whether ReadyAPI will add data to the file or overwrite it every time you start the test.

   If you decide to log to a file, specify the fully qualified path to the file and choose whether ReadyAPI will add lines to the file or overwrite it every time you start the test.

9. To log requests from remote machines during distributed testing, select Log in distributed mode.

   Note: In the distributed mode, the Transaction Log page shows only the raw data of the request and response messages.

10. Click OK to save the changes and close the dialog.