Customize notifications

Last update: March 04 2024

Customize notifications

You can select an event when you check a metric and set up notifications to be sent — if it is fulfilled (or conversely, not fulfilled), you will receive a notification. This can be used to identify problem areas during inspections.

Add contact⁠

Email or phone number

1. In Control Panel, go to Monitoring → Reports and Notifications.

2. Open the Contacts tab → click Add Contact.

3. Select how you want to receive notifications:

   • Email — email notifications are free of charge.
   • Phone — SMS notifications. You need to purchase a paid package, to do this go to Monitoring → Reports and notifications → click Order SMS.

4. Optional: Specify the time to send notifications.

5. Press Add.

HTTP request

1. Create a php file in the directory with your website, for example, log.php.

2. Add the code to the script to test it:

   <?php
   echo "<response>";
   ?>

   Specify <response> — the expected response is of the form 5ca8ada3938381ec79e881132b1fa3dac3.

3. In Control Panel, go to Monitoring → Reports and Notifications.

4. Open the Contacts tab.

5. Press Add Contact.

6. Select the method of receiving HTTP notifications — via HTTP requests.

7. In the HTTP field, add the absolute address of the link to the file you created in step 1, for example, http://domain.com/log.php.

8. Press Check.

9. The expected response that you added to the file in step 2 will appear in the dashboard.

10. Once verified, modify the php file and add a working script to it. You can use sample script.

11. Optional: Specify the time to send notifications.

12. Press Add.

Sample script⁠

This script sends a message to Telegram if a new entry appears in the monitoring message log.

1. Start a dialog with the bot from your account and get a list of updates for your bot:

   https://api.telegram.org/bot<token>/getUpdates

   Specify <token> — the API access token for your bot that you received when you created the bot.

2. Get the chat ID — copy the value of the chat_id parameter.

3. Create a log.php file.

4. Add the following script to the file:

   <?php
   $file_get = $_SERVER["DOCUMENT_ROOT"] . "/modules/log/get.log";
   if (!empty($_GET)) {
       $fw = fopen($file_get, "a");
       fwrite($fw, "GET " . var_export($_GET, true)));
       fclose($fw);
       $ch = curl_init();
       curl_setopt($ch, CURLOPT_URL,
   "https://api.telegram.org/bot<token>/sendMessage?chat_id=<chat_id>&text='New entry in monitoring file: <url>'");
       $result=curl_exec($ch);
       curl_close($ch);
       }
   ?>

   Specify:

   • <chat-id> — chat ID or username of the user to whom you want to send a message;
   • <token> — Telegram bot key (token) of the form 864190220:AAGY3To77NuySjaGmupS7PfEQy952V08QOA;
   • <url> — a link to a file of the form http://test-http-get.ru/modules/log/get.log.

5. Create a log directory in the root directory of your site.

6. In the directory, create a file named get.log where the log of GET requests will be saved.

7. In the same directory, place the log.php file created in step 3.

Customize notification⁠

A separate notification is configured for each metric.

1. In Control Panel, go to Monitoring → Monitoring.
2. Open the Metrics tab → open the metrics page → Notifications tab.
3. Select the contacts to which the notification will be sent.
4. Press New Notification.
5. Select the event, after how many failures and at what frequency to send notifications.

View public statistics⁠

Another way to keep track of the status of metrics is on the public stats page.

In control panel, go to Monitoring → Monitoring → click on the Public Statistics Page link.