Difference between revisions of "Troubleshooting Module Problems"
(→Enable Logging) |
|||
| Line 12: | Line 12: | ||
#Make sure your Administrator role has the '''View Module Debug Log''' permission. | #Make sure your Administrator role has the '''View Module Debug Log''' permission. | ||
#Go to '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Logs > Module Log''' ('''Utilities > Logs > Module Log''' in WHMCS 7.x and earlier). | #Go to '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Logs > Module Log''' ('''Utilities > Logs > Module Log''' in WHMCS 7.x and earlier). | ||
| − | # | + | #Switch '''Module Logging''' to '''On'''.<br/><br/>[[File:turn-on-module-log.png|800px]] |
| − | #Reproduce the issue. | + | #Reproduce the issue.<br/> |
#Return to the module log page. | #Return to the module log page. | ||
Revision as of 15:41, 9 March 2022
This module debugging tool can be used to identify and resolve problems communicating with remote API systems. It will record and display the raw API data being sent to, and received back from the remote system. Logging should only ever be enabled for testing, and never left enabled all the time.
Enable Logging
NOTE:
It is important that once troubleshooting has been completed that the debugging tool is disabled by clicking the Disable Debug Logging button.
If you are experiencing a technical issue with a module, enable logging:
- Make sure your Administrator role has the View Module Debug Log permission.
- Go to Configuration () > System Logs > Module Log (Utilities > Logs > Module Log in WHMCS 7.x and earlier).
- Switch Module Logging to On.
- Reproduce the issue.
- Return to the module log page.
The details of the interaction between WHMCS and the module will be displayed on-screen for your own analysis. These details can then be forwarded to the provider's technical support team if necessary.
Unknown Errors
Sometimes a third party system or module will provide a response that WHMCS is unable to recognise and interpret. This can result in the display of an "Unknown Error" message.
In these cases, you can use the System Module Debug Log to obtain the raw response, which will typically help identify the problem.