logo

Checker service description

About Checker

Checker is designed for monitoring HAProxy, Nginx, Apache and Keepalived services as well as HAProxy backends. If a ackend or a service is down, Checker will send an alert via Telegram and/or Slack. Real-time alerting via Roxy-WI panel is also supported. Checker preserves the history of incidents.

If you installed services manually read here how to configure them.

The checker service consists of the following parts:

The Master Checker runs the Worker Checkers. It must always be running.

When you would like to start monitoring HAProxy and/or Nginx services the "Master checker" will start the local worker for every HAProxy/Apache/Nginx service.

Checker Features

The Worker Checker for HAProxy performs the following operations:

The Worker Checker for Nginx can perform the following operations:

The Worker Checker for Apache can perform the following operations:

The Worker Checker for Keepalived performs the following functions:


Go to TOP

Installation


Execute the following command to install Checker

All information concerning RPM packages can be found here

Go to TOP

Telegram parameters

Since version 6.1.0 Checker can send via Telegram alerts for each server. Alerts can be sent for Nginx, HAProxy, Apache and Keepalived Servers. To specify the Telegram settings, go to Admin Area => Сhecker. You should see the list of Telegram channels: list_of_channels

To add a new channel, click on the Add button. In the window that will open specify the parameters from the table below:

Parameter: Description:
Token Token received from @father_bot.
Channel name Name of your channel. The channel must be public.
Group You can specify one of the existing groups. A group is equal to a namespace. Members of one group cannot see the servers from the other groups.

Slack parameters

Slack notifications for each server are available since version 6.1.0. The interface for specifying Slack parameters is quite the same as that for Telegram. To add a new channel, click on the Add button and specify the parameters from the table below.
Parameter: Description:
Token Token received via the Slack API
Channel name Name of your channel. The channel must be public
Group You can specify one of the existing groups. A group is equal to a namespace. Members of one group cannot see the servers from the other groups.

Roxy-WI checker
Go to TOP

Notifications settings

On the Settings tab you can specify Telegram and Slack notifications for all servers; notification_settings

You can manage notifications for Nginx, HAProxy, Apache and Keepalived servers. To enable notifications, select the name of the channel in the dropdown menu. To stop sending notifications, select Disabled. If you need to sent notifications via e-mail to all members of the group, select the E-mail checkbox. Note that user who have the guest role will not receive e-mail notifications.

By setting the corresponing checkboxes you can specify the information to be included in Notifications. You can include the information on:

  • the availability of the service (the Service checkbox);
  • changes of the server status (the Status checkbox);
  • the availability of HAProxy backend servers (the backend checkbox);
  • the value of the Maxconn parameter for HAproxy (when the value is about to reach the specified threshold, а notification is sent)

Logs

The Master Checker and Worker Checker have their own log in Internal logs. All further information concerning the Internal logs can be found here

Go to TOP

Updating


To update Checker execute the following command. If a new version is available yum will offer you to intall it:
You can either update it via Roxy-WI:

Roxy-WI Update services

Was this article helpful?

Yes, thanks!
Not really
Go to TOP
Go back