Back to Blog Posts

Feature Spotlight: Cron Task Reporting

By Matt / April 3rd, 2020


In WHMCS 7.10 we've introduced more detailed logging of the automated actions that are carried out by WHMCS, allowing you to delve deeper into the actions that WHMCS is performing on your behalf.

This feature received over 80 votes on our feature requests site.

Back in WHMCS 7.1, we simplified the output of the daily cron report email to provide a summary that was easier to digest more quickly. It was designed to save you time, make it easier to identify things that are requiring attention, enable us to provide charts and metrics around cron activity, and to improve information security.

But we heard from some users that they missed not being able to see who payments had failed to capture successfully, who invoice reminders had been sent to or why suspensions had failed to complete successfully.

So what have we done?
In WHMCS 7.10, we've increased the logging that we perform for cron actions, and you can now access this additional level of detail via the Automation Status page by clicking on any of the individual Cron Tasks.

The new logging will start occurring in the first cron run following the upgrade to 7.10, so for cron runs prior to 7.10, you will not be able to see the additional information.

What's new
The automated actions that WHMCS performs daily are called Cron Tasks.

Each Cron Task displayed on the Automation Status page, for cron runs performed after the upgrade to 7.10, will be clickable.

Upon clicking the task, additional information about what occurred during that Cron Task will be displayed.

The additional detail and information you will see is context specific, so for tasks relating to invoices you will see invoice details, and for tasks relating to services you'll see product and service information, etc...
In tasks where the outcome of the task has multiple possible results, such as for cancellation requests as shown above, the additional detail will be broken up into tabs, grouping the different possible outcomes of the function for easier interpretation and readability.

In cases where the failure conditions are the result of API communication with 3rd party APIs and systems, any error messages that get returned will also be recorded and displayed as part of the output. Contextual links will also allow you to quickly jump to invoices or the module queue to retry the failed action.

Important note: In the detailed information, some values are cached from the time of the cron task attempt, and some are displayed in real-time. For example Invoice Status, Due Date and Amounts are live information, so when reviewing failed capture attempts, or overdue invoice reminders, you can easily identify invoices which have since been paid.

The additional logging is retained by WHMCS, allowing you to scroll back through historic dates using the handy calendar, and enabling you to easily see what events occurred on any given day.

The cron report email remains the same as before, but each email now contains a button that will allow you to jump immediately to the Automation Status for that particular days cron tasks, and get the additional detail in just a matter of clicks, securely through the WHMCS admin user interface.

New data points include:
  • Invoices that have been generated
  • Invoices late fees have been added to
  • Invoices attempted for capture
  • Invoices that have been sent late and overdue notices
  • Automated Cancellation requests that are processed
  • Suspensions that are performed due to late payment
  • Terminations that are performed on delinquent accounts or those with fixed terms
  • Domain renewal notices that are sent out
  • Support Tickets that are closed due to inactivity
  • Client statuses that are auto-changed due to active services
The new more detailed reporting can be accessed via the Automation Status UI, found with the Utilities > System menu within the WHMCS admin area.

WHMCS 7.10 is available in Release Candidate status right now, so we invite you to download and try it out today. You can learn more about the new features and how to get involved at https://beta.whmcs.com/

Thanks for reading!

Liked this article? Share it