Server Monitoring For WHMCS

About Server Monitoring For WHMCS

Server Monitoring For WHMCS is a powerful tool designed for administrators and their clients, enabling fast and effective verification of server online status through ping and HTTP checks. Schedule regular checks on VPS services, giving your clients the ability to configure and monitor their checks, and helping them track the health of their services within predefined limits and intervals. Establish continuous control of server health and empower your customers to monitor the performance of their services.

• Addon Module Features:

✔ Monitor Services Health Status From Client And Admin Areas

✔ View Dashboard Statistics:

✔ Graph Overview

✔ Checks Summaries

✔ Recently Performed Checks

✔ Configure Available Services For Clients To Monitor:

✔ Select Product

✔ Set Minimum Number Of Failures Triggering Notification

✔ Set Maximum Number Of Checks For Clients

✔ Set Minimum Interval Between Checks

✔ Select Check Types Available For Clients:

✔ cURL Check

✔ Ping Execute Check

✔ Socket Ping Check

✔ Allow Clients To Use Custom IP Address For Checks

✔ Select Available Notification Types For Client:

✔ Select Email Template For Failed Checks

✔ Select Email Template For Service Recovery

✔ Configure Services Monitoring Checks:

✔ Specify Check Name And Status

✔ Set Check Verification Interval

✔ Set Failure Count To Trigger Notification

✔ Select Monitored Service

✔ Select Type Of Performed Check

✔ cURL Check:

✔ Specify Request URL

✔ Specify Response Code

✔ Ping Execute Check:

✔ Select Assigned Or Specify Custom IP Address

✔ Socket Ping Check:

✔ Select Assigned Or Specify Custom IP Address

✔ Select Notification Type:

✔ Email Notification:

✔ Select Email Template For Failed Checks

✔ Select Email Template For Service Recovery

✔ Select Notification Recipients

✔ Other Types Including SMS Messages Coming Soon

✔ View Checks Logs, Response Messages And Status

✔ View Queue Of Pending, Failed And Finished Checks

✔ Customize Module Language Files With "Translations" Tool

✔ View And Manage Module Logs

• Client Area:

✔ Create Monitoring Checks For Allowed Services Within Specified Limits:

✔ Specify Check Name

✔ Set Check Status

✔ Set Check Verification Interval

✔ Set Failure Count For Notification

✔ Select Type Of Performed Check

✔ Select Notification Type

✔ View Logs Of Monitored Checks Results

✔ Receive Email Notifications Of Failed And Recovered Services

• General Info:

✔ Multi-Language Support With Custom Translations Tool

✔ Supports PHP 8.2 Back To PHP 8.1

✔ Supports WHMCS V8.12 Back To WHMCS V8.9

✔ Requires ionCube Loader V13 Or Later

✔ Easy Module Upgrade To Open Source Version

Installation

This tutorial will show you how to successfully install and configure Server Monitoring For WHMCS. We will guide you step by step through the whole installation and configuration process.

1. Log in to our client area and download the module.

2. Extract the package and upload its content into the main WHMCS directory. The content of the package to upload should look like this.

3. When you install Server Monitoring For WHMCS for the first time you have to rename 'license_RENAME.php' file. The file is located in 'modules/addons/ServerMonitoring/license_RENAME.php'. Rename it from 'license_RENAME.php' to 'license.php'.

4. In order to configure your license key, you have to edit the previously renamed 'license.php' file. Enter your license key between quotation marks as presented on the following screen. You can find your license key in our client area → 'My Products'.

5. Now you have to activate the module in your WHMCS system. Log in to your WHMCS admin area. Go to 'System Settings' → 'Addon Modules'. Afterwards, find 'Marketing Triggers Automation' and press the 'Activate' button.

6. In the next step, you need to permit access to this module. To do so, click on the 'Configure' button, tick 'Full Administrator' and press 'Save Changes'.

7. The final step of the module installation is setting up cron commands that are required for several module features to work properly. php -q /your_whmcs/modules/addons/ServerMonitoring/cron/cron.php checks:generate php -q your_whmcs/modules/addons/ServerMonitoring/cron/cron.php checks:run Note that the above directory is exemplary, please adjust the cron lines to your own needs. A 1-minute interval is recommended.

8. You have just successfully installed Server Monitoring For WHMCS! You can access your module under 'Addons' → 'Server Monitoring'. Read the guide provided on the 'Dashboard' or continue with this documentation.

Management

Server Monitoring For WHMCS empowers your clients with tools to monitor their services directly from the WHMCS client area. In this brief guide, we will introduce the module’s capabilities and show you how to make the most of its features.

Module Addon

The module addon is where all of the setup and management take place for the admin. It allows you to add products to the module, enabling the creation of checks for services associated with those products. It also features several management tools like the queue, translations tool and module logs.

Products

To start creating checks, the module functionality must first be enabled for specific products. This step is crucial as it defines how checks can be configured later on. Start by navigating the 'Products' tab and clicking on the 'Add Product' button.

Fill the necessary fields as you add the products: Status - set the initial status for the products, this can be changed later. Products - include the products you wish to add with this configuration Number of Failures Triggering Notification - set the amount of failed checks needed to trigger a notification. The number you set for the product here will be the minimum clients will be able to set for their services. Checks Number Limit for Clients - limit how many checks clients can set up for their services. Verification Interval - set the minimum check interval clients can set for their services. Available Check Types - select which check types will be available to set up. cURL Check - an HTTP GET request is sent to a server to retrieve data and check its availability. Ping Execute Check - an ICMP ping is sent to a specific IP address to test if the server is reachable. Allow Custom IP Address - enable to allow custom IP addresses for the 'Ping Execute Check'. Socket Ping Check - a connection attempt is made to a specific IP address and port to check if the service is running and accessible. Important: This check type requires specific configuration, see the Tips section for details. Available Notifications - include allowed notification types. Email Notification - sent email messages when the checks fail, and when the service recovers. Email Template for Failed Checks - decide which email template will be used when the failed check threshold is exceeded. The default email template is named 'Server Monitoring - failed checks alert', it includes merge fields and can be freely edited. Email Template for Service Recovery - decide which email template will be used when the service has recovered. The default email template is named 'Server Monitoring - service unreachable', it includes merge fields and can be freely edited.

Once products are added, you can disable/enable them with the 'Status' toggle.

Use the action buttons to edit or delete products from the list.

Checks

Once products are added, both admins and clients can create checks for services. To see how clients can add and monitor checks for their services see the Client Area section. To add checks as an admin, navigate to the 'Checks' section of the module and click on the 'Create Check' button.

Provide the required fields: Name - provide a name for the check. Status - select the initial status of the check, this can be changed later. Verification Interval - decide how often the check should be performed (in minutes). Failure Count For Notification - indicate how many checks need to fail before a notification is sent. Monitored Service - select the service that will be checked. Type of Performed Check - pick the check type. cURL Check - an HTTP GET request is sent to a server to retrieve data and check its availability. Request URL - provide a URL that will return a code upon a GET request. Response Code - include the expected HTTP response code. Ping Execute Check - an ICMP ping is sent to a specific IP address to test if the server is reachable. IP Address - provide the IP address for the check. Socket Ping Check - a connection attempt is made to a specific IP address and port to check if the service is running and accessible. Important: This ping type requires specific configuration, see the Tips section for details. IP Address - provide the IP address for the check. Notification Type - select the notification type. Email Notification - email messages will be sent out after the failed checks threshold is exceeded. Email Template for Failed Checks - decide which email template will be used when the failed check threshold is exceeded. The default email template is named 'Server Monitoring - failed checks alert', it includes merge fields and can be freely edited. Email Template for Service Recovery - decide which email template will be used when the service has recovered. The default email template is named 'Server Monitoring - service unreachable', it includes merge fields and can be freely edited. Notification Recipients - select where to send the notification.

Once checks are added, you can turn them off and on with the 'Status' toggle.

Click the 'Show Logs' button to display logs related to the specific check.

The logs will include: The result of the check Its message Its date Note that clients will not be able to see messages when checking logs in the client area.

Use the action buttons to edit or delete checks as needed.

The mass action function can be used to delete multiple checks at once.

Queue

The "Queue" tool helps you track and manage the tasks created by the module. It allows you to view and interact with task details, including task IDs, statuses, and related items. You can filter tasks, execute actions like deleting or running tasks, and even use mass actions for bulk operations. For detailed guidance on using this tool, please refer to the dedicated article available here.

Translations

Customizing language files is now extremely easy with the "Translations" tool that is now available directly in the addon. Its user-friendly design makes managing various language file tweaks a smooth and efficient process. Prepare translations for the original English files with this handy built-in tool. For specific instructions on how to use this tool please refer to its dedicated article, you will find it here.

Logs

The "Logs" tool makes monitoring and managing module activity records simple and efficient. It provides options to categorize, filter, and view detailed entries, giving you control over the logs. Features like bulk deletion, rule-based deletion, and export options make it easy to organize and maintain your logs. For detailed guidance on using this tool, check its dedicated article, which is available here.

Client Area

Clients will be able to take advantage of Server Monitoring For WHMCS too, as long as they own one of the products you have configured. The basic client area integration allows them to create and monitor checks for their service, within restrictions opposed by the admin. To add a new check, click on the 'Create Check' button.

Fill the necessary fields: Name - provide a name for the check. Status - set the initial status of the check, it can be toggled off and on later as well. Verification Interval - set how often the check should be performed (in minutes). Failure Count for Notification - set how many checks with the failed resold are needed to send a notification. Type of Performed Check - select the type of the check. IP Address - select/provide an IP address to be checked. Notification Type - select the type of the notification Notification Recipients - select where the notification should be sent.

Once the check is added, you can toggle it on/off as needed with the 'Status' toggle.

You can display logs for the specific check by clicking on the 'Show Logs' button.

The logs only include results of the selected check, as opposed to all logs in the table below.

Use the action buttons to edit or delete created checks whenever you need to. Consider disabling a check with the 'Status' toggle before deleting it for good.

The 'Server Monitoring Logs' list check history of every check related to the service in a single table including: Check Name Check Type Check Result Check Date

Tips

1. If you plan on using the 'Socket Ping Check' check type, make sure that queue executor cron has admin permissions. You can do this by running it from an account with sudo permissions or adding 'sudo' before the cron job line like this: sudo php -q /your_whmcs/modules/addons/ServerMonitoring/cron/cron.php checks:run

Update Instructions

An essential guidance through the process of updating the module is offered here. Ensure successful completion of the module update by carefully following each step, thereby preventing data loss or any unforeseen issues. Additionally, you will find a current list of supplementary actions necessary for a smooth update process there.

Upgrade Guide

Seeking a solution that offers greater flexibility, customization tailored to your precise needs, and unrestricted availability? There is an option that not only proves to be cost-effective in the long run but also includes prioritized support services, making it a truly valuable investment. Opt for the Open Source version of your Server Monitoring For WHMCS module to unlock these benefits. Simply click on either the Get Source Code or Upgrade To Lifetime button found on the product's page in our client area to complete the one-step upgrade process, with a dedicated discount already applied. Follow a comprehensive guide covering the transition process, the advantages it brings, and step-by-step instructions on what to do next after the order has been successfully finalized.

Common Problems

1. When you have problems with connection, check whether your SELinux or firewall does not block ports.