How to Debug Automation Results

The Results page provides valuable information on tests at the step level. However, if you want to gain a better understanding of how each step ran, you can use the Investigate Action feature. To view details on any step, click Investigate Action.

To return to the test results, click the back arrow at the top of the page. Note that you can use Investigate Action on any step.

Reviewing a Passed Step

Sometimes, you might find it helpful to see how a match occurred in a step that passed. You can see the following information:

• Attempted to find a match (image)
• Closest match identified (image)
• Results determined
• Metadata
  • Action completed
  • Delay after action. See How to Set Delays in Automated Tests for more information.
  • Environment
• The Closest match location is shown in the screenshot to the right.

If a visual match was performed using pixel data, detailed information on how close the match was is shown in the “Result determined” section.

If a match was performed using Text Matching, the text is shown in the “Result determined” section. See Text Matching for more information.

Reviewing a Failed Step

When you click Investigate Action on a failed step, you see the same information that displays for a passed test, except that neither visual nor Text Matching was successful.

Information, including the closest visual match and the text used to match (if applicable), is displayed. Note that additional information and actions are available for further troubleshooting.

Image Comparison

For failed steps, you can investigate further by comparing the requested and closest matched items.

1. Click the Can’t see the difference? link under “Closest match identified” to compare the images.
2. Use Swipe or Layered to determine whether the closest match should be used.
3. When you’re finished, click Done.

Update Action Screenshot

You can update the failed step directly from this screen. First, confirm the closest match is appropriate to use, then click the Accept Replacement button. Note that the test is automatically updated.

If the closest match isn’t acceptable, then open the test, edit the step, and capture the correct element.

The Site Can’t Be Reached When Navigating to the Test URL

You might find you cannot get to the site. Make sure to whitelist all Rainforest IP addresses. See Which IP Addresses Do Rainforest Tests Come From? for more information.

HTTP and Video Logs for Troubleshooting

Using HTTPHTTP - Hypertext Transfer Protocol (HTTP) is data communication foundation for the World Wide Web. It provides access to hypertext documents, including hyperlinks to other resources. logs, you can view all HTTP traffic passing to and from each Rainforest virtual machine (VM). Use the logs to examine request interruptions at the network level and see the order in which HTTP requests were made.

To view a test’s HTTP browser logs or a copy of the video results:

1. Click the test’s run results.
2. Click the More dropdown.
3. Click “HTTP Logs” or "Video" to download the HTTP logs or the video results.

View the HAR file in your text editor of choice, this recommended tool, or this Google Chrome extension.

If you have any questions, reach out to us at [email protected] or via the chat bubble below.