Troubleshooting Guide

New
  • Published on May 15, 2025
  • 3 minute(s) read
Prev Next

This topic discusses the common issues that you may encounter while running API Security Testing on your application. From incomplete scan execution to API count disparity, each of the sections includes explanations and actionable fixes to help you troubleshoot quickly and effectively.

The scan appears incomplete, or the test execution percentage is lower than expected

Below is the list of common issues that may result in the above query, their cause, and resolution:

Aborted Scans

  • Cause — The scan may have been aborted manually from the Traceable platform or automatically due to a runner issue.

  • Resolution —

    • Navigate to the respective scan and check the Scan Status Reason column for the description.

    • Ensure that the runner instance is stable and has sufficient resources to execute the scan.

Scan Timeout

  • Cause — The scan has a high number of tests, but the Scan Timeout specified during Suite creation is insufficient. As a result, not all tests are executed.

  • Resolution — Modify the Suite details to increase the Scan Timeout value.

Unreachable APIs

  • Cause — Traceable evaluates tests within each scan as chains. If a test fails due to unreachable APIs, the dependent chain is skipped.

  • Resolution —

    • Ensure that all API endpoints configured as part of the scan are reachable. To check this, navigate to Testing → Suites, select the respective suite, Scans tab, and API Reachability tab for the respective scan.

    • Avoid using localhost or internal hosts in traces.

My scans are stuck in the Queued State

Below is the list of common issues that may result in the above query, their cause, and resolution:

All Runners are Busy

  • Cause — All the runners are busy executing scans.

  • Resolution — Allow the current scans to complete or add new runners to ensure uninterrupted scan execution without resource contention.

Idle Runners are not picking up the Scan

  • Cause — The runner may be inactive or may have been migrated to a different host, causing a change in its runner ID, which is tied to the host signature.

  • Resolution — Complete the following steps:

    1. Navigate to Testing → Suites.

    2. Select the respective suite where the scan is stuck.

    3. Navigate to the Details tab, and click the Edit icon corresponding to the Suite Config section.

    4. Remove the existing suite Schedule and add a new one.

    5. Click Select specific runners, and from the list of runners, select a new one.

    6. At the page’s bottom right corner, click Update.

My scan shows 0 generated tests

The probable causes and resolutions may vary depending on the traffic type configured in your suite:

Traffic Type

Cause, Check, and Resolution

Live Traffic

  • Cause — No live traffic available in the selected environment.

  • Check —

    • Navigate to Analytics → Explorer → Endpoint Traces tab, select the respective Environment, and check the traces for the past hour.

    • Navigate to Testing → Suites, select the respective suite, Scans tab, and check the API Coverage → APIs not Scanned tab to review the reason for skipped APIs and verify whether the APIs show the reason No past traffic found.

  • Resolution — Ensure that the respective environment is actively receiving API traffic.

Replay Traffic

  • Cause — Replay may have been disabled for the environment post-suite creation, or no replay APIs are stored.

  • Check — Navigate to Testing → Environment Config, and check whether replay is enabled and/or APIs are stored for the respective environment.

  • Resolution — Ensure that Replay is enabled for the respective environment.

DAST

  • Cause — APIs are unreachable, causing the scan to be aborted.

  • Check — Navigate to Testing → Suites, select the respective suite, Scans tab, and check the API Reachability tab for the respective scan.

  • Resolution — Ensure that all API endpoints configured as part of the suite are reachable.

  • Cause — Error in parsing the uploaded specification.

  • Check —

    • Verify that the uploaded specification is valid and correctly formatted.

    • Navigate to the respective scan and check the Scan Status Reason column for the description.

  • Resolution — Complete the following steps:

    1. Navigate to Testing → Suites.

    2. Select the respective suite where the scan is stuck.

    3. Navigate to the Details tab, and click the Edit icon corresponding to the Basic Info section.

    4. Reupload the Collection.

    5. At the page’s bottom right corner, click Update.