logo

Checker service description

About Checker

Checker is designed for monitoring HAProxy, Nginx, Apache and Keepalived services as well as HAProxy backends. If a backend 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 keeps 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.

In order for you to monitor 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 Telegram alerts for Nginx, HAProxy, Apache and Keepalived servers events. Go to Admin area-Сhecker to specify the Telegram settings.

Roxy-WI checker
You should see the list of Telegram channels:
Roxy-WI checker

Click the Add button to add a new channel. Specify the parameters in the new window according to 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 the one for Telegram. Click the Add button to add a new channel, then specify the parameters according 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

You can manage Telegram and Slack notifications for all Nginx, HAProxy, Apache and Keepalived servers on the Settings tab.

Roxy-WI checker

Select a channel in the dropdown menu to enable notifications or select Disabled to stop sending notifications. If you need to send notifications by e-mail to all members of a group, tick the E-mail checkbox.

Note that user who have the guest role will not receive e-mail notifications.

You may tick other checkboxes (Service, Backend, Maxconn, Status) as well. Notifications can include the information on:

Logs

The Master Checker and the Worker Checker have their own log in Admin area-Internal logs.

Internal logs
All further information concerning the Internal logs can be found here

Go to TOP

Updating

Execute the following command to update Checker:

You can also update it via the Roxy-WI interface:

Roxy-WI Update services

Was this article helpful?

Yes, thanks!
Not really
Go to TOP
Go back