Skip to main content

Addon Configuration

  1. Go to Setup > Addon Modules
  2. Find “Website Monitoring” and click on “Activate”
  3. Click on “Configure”
  4. Set the desired configuration
  5. Click on "Save changes".

Configuration values

ParameterDescription
License KeyInsert your license key. After saving the changes, the license status should appear next to the field.
Email AdminsTick to send email notifications to WHMCS admins about any changes in monitoring status. This is recommended.
Email ClientsTick to send email notifications to an affected Customer in case of any changes in monitoring status. Use with caution as even small downtimes might make the customer panic while otherwise he wouldn't notice 😊
Enable client area integrationIf you wish to allow your customers to look at the monitoring information for their websites from within the client area, tick this box.
Allow clients to see historyAllows clients to see monitoring history of their subscriptions
Navbar nodeTo add a link to the client area monitoring page to the main menu, specify the menu node here. The default "Support" should work, unless you customized your menu. Leave empty to disable.
Sidebar nodeTo add a link to the client area monitoring page to a sidebar, specify the sidebar node here. The default "Support" should work, unless you customized your sidebars. Leave empty to disable.
Auto enable serversIf you add a new server in WHMCS, it will be enabled automatically in the monitoring module.
Auto enable clientsIf a new client gets created in WHMCS, it will be enabled automatically in the monitoring module.
Auto enable subscriptionsIf a new hosting subscription is created in WHMCS, it will be enabled automatically in the module, but only if its client, product and server are enabled as well.
Retain History of the past x daysAutomatically deletes history older than the configured days.
HTTP GET fallbackIf you have websites that return HTTP 4xx even though they open fine in a web browser, enabling this option will have the agent try the GET method instead on failure.
Check IP status every x hoursYou can limit how often IP checks need to be made. 24 hours is the recommended value. Set to 0 to always check.
Check SSL certificates every x hoursYou can limit how often SSL checks need to be made. 6 hours is the recommended value. Set to 0 to always check.
Warn about expiring certificates x days in advanceWarns if SSL certificates are expiring within the defined days. Set to 0 to disable.
Throttle one check every x millisecondsTo avoid stressing your webservers too much with many requests at once, you can throttle the requests. 100 milliseconds are the recommended value.
Connection timeout limitSets how many seconds the check will wait for a response from the server. Don't set this too high, as slow responding websites are also an issue. 10 seconds is the recommended value.
Retry x times on failureSometimes, the web server might briefly reload or restart, causing the website that is being checked to fail. To avoid unnecessarily returning an error in these cases, you can set to retry the check a few times before giving up.
Wait x seconds between each retry1-2 seconds should do. The higher the value, the more time cron will take.
Redirect limitIf HTTP gets redirected more than the limit, it will be treated as error.
Maximum processesLimits how many processes are spawn for the cron run.
Enable loggingEnables logging to text files for diagnostic purposes
Log levelSets the amount of verbosity in the logs. WARNING is the recommended setting.
Anonymize log entriesAnonymizes domain names in the log files. Useful if you need support from us and don't want to disclose your domain names.
Absolute Log pathSpecify an absolute path to a directory where the module should write its logfiles into. Please ensure that the webserver AND cron users have the rights to write in that directory. Also ensure that the directory is not viewable via the web. Either block it via .htaccess or place it outside your web root.
Cleanup logs older than x daysThis deletes older log files to keep the log folder clean. If you want to keep it all, set this to 0.
Maintenance modeIn case you have some planned downtimes due to server maintenance, you can activate maintenance mode to prevent the cron to run during that time.