Debug logging
Debug logging can be used to identify issues with connections. It provides debug level details for each connections as well as the time each step took (e.g. parsing time, scan time, response time). It also tracks the number of active connections.
Important notes
Debug logging is not designed to be constantly enabled. It should only be used for investigating issues for short periods of time.
Keeping it enabled permanently may impact performance. If running for too long, the log file can become very large and significantly reduce the available disk space.
In each case below, both logfile and loglevel settings must be set for the changes to be active.
Step-by-step guide
Windows
Enable debug logging
Perform the following steps to enable debug logging:
- Make sure MetaDefender ICAP Server is stopped
Open the Windows Registry with regedit. Go to the HKEY_LOCAL_MACHINE\SOFTWARE\OPSWAT\ICAP Server\logger entry
Add or modify the following entries with the following values:
- loglevel: debug
- wineventlog_level: debug
Close the registry editor
Start MetaDefender ICAP server
Disable debug logging
Perform the following steps to disable debug logging:
- Make sure MetaDefender ICAP Server is stopped
Open the Windows Registry with regedit. Go to the HKEY_LOCAL_MACHINE\SOFTWARE\OPSWAT\ICAP Server\logger entry
Add or modify the following entries with the following values:
- loglevel: info
- wineventlog_level: info
Close the registry editor
Start MetaDefender ICAP server
Linux (CentOS syntax)
Enable debug logging
Perform the following steps to enable debug logging:
- Make sure MetaDefender ICAP Server is stopped
Edit /etc/mdicapsrv/mdicapsrv.conf
Add or modify the following entry under the [logger] section with the following value:
- loglevel: debug
Save and close the configuration file
Start MetaDefender ICAP server
Disable debug logging
Perform the following steps to enable debug logging:
- Make sure MetaDefender ICAP Server is stopped
Edit /etc/mdicapsrv/mdicapsrv.conf
Add or modify the following entry under the [logger] section with the following value:
- loglevel: info
Save and close the configuration file
Start MetaDefender ICAP server