Introduction
vCanopy uses Monit to manage services and restart them based on criteria such as extended periods of high CPU or RAM usage over a set period of time.
Monit will send out notifications within your vCanopy account and to Slack (if setup). These notifications are all logged on your server and they’re all time stamped. Should you encounter any issues, they maybe useful for troubleshooting issues such as 502/504 timeouts and more.
In this article we’ll dig into the available GP-CLI.
CONNECT TO YOUR SERVER
You’ll need to connect to you server to run the CLI commands, so if you’ve haven’t already, please see the following guides to get started:
Generate your SSH Key:
Generate SSH Key on Windows with Putty
Generate SSH Key on Windows with Windows Subsystem for Linux
Generate SSH Key on Windows with Windows CMD/PowerShell
Add your SSH Key to vCanopy:
Add/Remove an SSH Key to/from an Active vCanopy Server
Connect to your server:
Connect to a vCanopy server by SSH as Root user.
Viewing All Notification History
To view your Monit notification history, for all entries from our gpmonit triggers of gpmonitor, you can run the following command:
gpmonit -history
The output will look as follows, with the most recent notifications at the bottom:
May 19 20:59:48 aws-nginx-mariadb root[831]: ***** vCanopy Monitoring - FILESYSTEM Capacity Warning > 80% ***** The Filesystem on aws-nginx-mariadb 35.159.0.17 has surpassed 80% disk capacity. Please consider upgrading your disk space. May 19 21:00:22 aws-nginx-mariadb root[4185]: ***** vCanopy Monitoring - FILESYSTEM Capacity Warning > 85% ***** The Filesystem on aws-nginx-mariadb 35.159.0.17 has surpassed 85% disk capacity. Really, it would be a great idea to scale your disk up now... May 19 21:00:32 aws-nginx-mariadb root[4362]: ***** vCanopy Monitoring - FILESYSTEM Capacity Warning > 90% ***** The Filesystem on aws-nginx-mariadb 35.159.0.17 has surpassed 90% disk capacity. Please consider upgrading your disk space. May 20 20:52:24 aws-nginx-mariadb root[18063]: ***** vCanopy Monitoring - FILESYSTEM Capacity Warning > 95% ***** The Filesystem on aws-nginx-mariadb 35.159.0.17 has surpassed 95% disk capacity. Really, it would be a great idea to scale your disk up now... May 20 20:52:25 aws-nginx-mariadb root[18108]: ***** vCanopy Monitoring - FILESYSTEM Capacity Warning > 98% ***** The Filesystem on aws-nginx-mariadb 35.159.0.17 has surpassed 98% disk capacity. This is bad, things are about to go south... please scale up before it is too late... May 20 20:52:27 aws-nginx-mariadb root[18153]: ***** vCanopy Monitoring - FILESYSTEM Capacity Warning > 99% ***** The Filesystem on aws-nginx-mariadb 35.159.0.17 has surpassed 99% disk capacity. Okay, this is where things are going to cascade fail... so long and thanks for all the fish!!! May 20 20:52:28 aws-nginx-mariadb root[18204]: ***** vCanopy Monitoring - MYSQL CPU_HOT Warning ***** MYSQL on aws-nginx-mariadb 35.159.0.17 has been using 70% of CPU for over 20 minutes... May 20 20:52:32 aws-nginx-mariadb root[18513]: ***** vCanopy Monitoring - MYSQL CPU_RESTART Error ***** MYSQL on aws-nginx-mariadb 35.159.0.17 was using 90% of CPU for over 30 minutes... restarting MYSQL! May 20 20:52:33 aws-nginx-mariadb root[18579]: ***** vCanopy Monitoring - MYSQL MEM_HIGH Warning ***** MYSQL on aws-nginx-mariadb 35.159.0.17 has been using at least 711MB RAM for at least the last 20 minutes... May 20 20:52:36 aws-nginx-mariadb root[18947]: ***** vCanopy Monitoring - MYSQL MEM_RESTART Error ***** MYSQL on aws-nginx-mariadb 35.159.0.17 has been using at least 800MB RAM for at least the last 40 minutes.... restarting MYSQL!
All Monit warnings and events are now stored in the /var/log/syslog. This GP-CLI command will check the log and format it into the above output.
Viewing Individual Service Notifications
You can also specify a specific service and use the following to view only notifications for that service:
gpmonit -history {monitor}Each of the individual 16 monitors in the box below can be viewed, and as noted at the end of the very last line, you can view ALL PHP notifications or only those specific to an individual version.
fail2ban filesystem mysql nginx redis openlitespeed sys_load_avg|sys_mem_usage|sys_cpu_usage|sys_swap_mem|system php7.1|php7.2|php7.3|php7.4|php
EXAMPLE COMMANDS
For example to view MySQL history, run:
gpmonit -history mysql
For the System Load Average notifications run:
gpmonit -history sys_load_avg
Simply add your desired monitor to end of gpmonit -history and hit enter.