Configuring Request Logging

Applies to ReadyAPI 3.8, last modified on May 05, 2021

By default, the log does not record any data for the newly created load test. To record requests, configure the logging conditions.

Logging Failed Transactions

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:

    API load testing with ReadyAPI: Configuring Request Logging

    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:

API load testing with ReadyAPI: Logging Failed Transactions

Click the image to enlarge it.

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

General Configuration

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.

    API load testing with ReadyAPI: Configuring Request Logging

    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 .

    API load testing with ReadyAPI: The Logging Options Dialog

    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.

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

See Also

Script Filtering in Transaction Log

Highlight search results