General Trouble Shooting
Overview
This guide explains how to troubleshoot partially successful or failed scans in DeepTraQ. Understanding scan status and reviewing error logs are essential to identify issues, resolve failures, and ensure accurate security assessments.
Scan status is indicated by icons in the dashboard:
- Green icon (Done) – Scan executed successfully.
- Yellow icon (Partially Completed) – At least one job succeeded and at least one job failed.
- Red icon (Failed) – Scan execution failed; the security scanners were unable to complete checks.
- Gray icon (Stopped) – Scan was manually stopped by the user.
Hovering over the icons shows the corresponding status message.
Only partially successful or failed jobs provide detailed error logs to help diagnose problems.
Supported Platforms
This troubleshooting guide applies to all scan types supported by DeepTraQ, including:
- Network Perimeter scans
- Web Application scans
- Code scans
Error logs and diagnostic steps are consistent across all scan types.
Prerequisites
- Access to the DeepTraQ dashboard
- Scan project created
- Appropriate permissions to view scan history and error logs
Understanding Scan Status
| Status | Icon Color | Description |
|---|---|---|
| Done | Green | Scan completed successfully; all jobs executed without errors. |
| Partially Completed | Yellow | At least one job succeeded and at least one job failed. |
| Failed | Red | Scan execution failed; security scanners were unable to complete checks. |
| Stopped | Gray | Scan was manually stopped by the user. |
| Submit Error | Red with “Submit Error” | Job was not successfully added to the security scanners. |
Viewing Scan History and Errors
Error logs provide diagnostic information without exposing sensitive data. Use the following steps:
- Navigate to the scan project in the Findings Dashboard.
- Click the History tab to view all historical scans for the selected project.
- Review the Status column to identify partially completed or failed scans.
- Open the three-dot menu next to a scan.
- Click Error to view detailed logs.
- If multiple errors exist, click the arrow button to expand all details.
Errors typically indicate:
- Temporary processing issues
- Configuration or connectivity problems
- Scanner execution failures
If problems persist after retrying, contact support for assistance.
Debugging Steps
- Verify the scan targets are reachable and correctly configured.
- Check the scan profile and authentication settings if applicable.
- Review the expanded error logs for details on the failure.
- Retry the scan after addressing any issues found in the logs.
- If issues remain unresolved, escalate to support with the relevant error logs.
Following these steps ensures that partially completed or failed scans can be effectively diagnosed and resolved.
Related Articles
- Understanding Scan Status
- Debugging Failed Jobs
- Network Perimeter Scanning
- Investigating Web Application Vulnerabilities