Troubleshooting Open-AudIT
General troubleshooting guidance for Open-AudIT covering discovery problems, common errors, and first steps for diagnosing issues.
IntermediateUpdated Apr 10, 2026
On this page
Troubleshooting
Open-AudIT works out of the box, but every network is different. This section covers the problems you're most likely to hit and how to work through them.
In This Section
- Discovery Problems — Can't find devices, limited data returning, duplicate records
- Common Errors — Specific error messages and what they mean
First Steps for Any Problem
Before diving into specific issues, these general steps resolve a surprising number of problems:
- Check the Discovery Log. Navigate to Menu → Admin → Database → List Tables, find
discovery_log, and export to CSV. Search for your device's IP address and review the entries. - Increase the log level. Go to Menu → Admin → Configuration → All, find
log_level(default 5), and set it to 7. Re-run the discovery. The additional detail often makes the problem obvious. - Test with a single device. If a subnet scan is failing, try scanning a single known IP first. This isolates the problem to one device and makes the logs much easier to read.
- Check target device configuration. Make sure the target device has the necessary ports open and services enabled. See Target Client Configuration on the wiki.