Cloud Monitoring


The Cloud Monitoring module allows you to:

  • Create monitoring node - a VPS/Cloud node with CentOS 8.x x86_64
  • Install monitoring node software (comes with the plugin)
  • Connect your HostBill to monitoring node
  • Configure paid/free monitoring package in HostBill

Activating the module

  1. If the plugin is included in your HostBill edition you can download it from your client portal.
  2. If the plugin is not included in your HostBill edition you can purchase it from our marketplace and then download it from the client area.
  3. Once you download the plugin extract it in the main HostBill directory.
  4. Go to Settings → Modules → Hosting Modules, find and activate Cloud Monitoring (HBmonitoring) plugin.
  5. Once the plugin is activated you will be directed to Settings→ Apps to configure the plugin.

Configuring monitoring node

After monitoring node is installed, edit file (login as root):

Update "monitor" section:

hbURL - enter url to your HostBill (client section) - make sure to end this URL with trailing slash "/"
api_username - enter random string, copy it to use in your HostBill Apps section
api_password - enter random string, copy it to use in your HostBill Apps section

After saving configuration file, restart your monitoring node:

Adding Cloud Monitoring Product

  1. In your HostBill go to: Settings → Products & Services, and Add new order page.
  2. From Order Types select Other Services.
  3. Enter your order page name, select order page template. Save changes.
  4. Add new product in the new order page. Provide product name, setup price, save changes.
  5. In product configuration section proceed to Connect with App, select HBMonitoring and App server created in the previous steps.
  6. Setup Package Limits:
    1. Monitoring Protocol - select between icmp (ping) and http 
    2. Monitor every N seconds - define polling interval (how often to check for host presence)
    3. Slow host response [ms] above - define max time after which monitored host will be considered slow
    4. Alert after N pings down - after this many subsequent "down" pings customer will receive alert
    5. Allow client to add/remove monitored hosts - define if customer should add his own hosts to monitor in client portal. If this is disabled make sure to enable "hostname" field for this product in Components→Domains tab
    6. Max monitored hosts - limit of hosts customer can monitor using this product. Use "Allow client to adjust during order" to let client decide during order/add pricing to this option
    7. Auto-monitor client IPs - when enabled, Main IP for each new account created for customer owning this package will be added to monitor
    8. Open ticket on host-down event  - Choose if new ticket should be auto-opened on host-down event
    9. Send email on host-down event - Choose if email to client should be sent on host-down event
    10. Send email on host-up event  Choose if email to client should be sent on host-up event
    11. Close ticket on host-up event - if ticket was opened for host-down event, this option can auto-close it
    12. Email notification template on host-down Email template to be used on host-down event
    13. Email notification template on host-up - Email template to be used on host-up event
    14. Ticket notification template - Email template to be used for ticket body on host-down event
    15. Ticket department - Department to open notification tickets in
    16. SMS notification on host-down - Notify client with SMS/Mobile using Mobile:HostDown sms template
    17. SMS notification on host-up - Notify client with SMS/Mobile using Mobile:HostBackUp sms template

Configuring Client Functions   

In Products & Services → Your Order Page  Your Product → Client Functions you can control what features customer will have access to in client portal, by clicking Enable/Disable next to the given option.
Use Edit button to adjust function appearance in the client portal. 

For Cloud Monitoring next to  a number of standard client functions you can enable: Monitoring function to allow client add/monitor his hosts

Fixing connection problems

If you're using CGI/FCGI php handler, and up/down notifications do not work, add following in your HostBill .htaccess file: 

Make sure that your HostBill URL (hbURL) is configured properly in /home/nodemonit/uptime/config/default.yaml

If you're using nginx + php_fpm and up/down notifications do not work add:

to your nginx configuration file, near fastcgi_pass line

I.e. if using HostBill Enterprise edit file:

And add:



Question: Do monitoring nodes simply work as individual monitoring nodes with signups spread across them or are they used in a cluster for monitoring?

Answer: Monitoring nodes work as individual monitoring nodes. You can configure multiple nodes in your Settings->Apps and distribute your customer accounts across them, by selecting App in accounts section before provisioning.