Skip to main content

Server notifications

warning

This feature is available exclusively for users with an Extended License.

FASTPANEL® allows monitoring of key server metrics: CPU load, Load Average 5, disk usage, and RAM consumption. When a metric exceeds its threshold, alerts are sent automatically to Telegram or Slack. Configuration is located under "Settings" → "Notifications".

This article explains how to set up delivery channels and configure notification parameters, including thresholds and triggers.

Channel setup

Telegram

  1. Create a new bot using the official Telegram bot @BotFather. Follow the link and click the "Start" button

notifications

  1. Type /newbot and press Enter.
  2. Enter the desired name for your bot and press Enter.
  3. Enter the desired username for your bot. It must end with bot, then press Enter.
  4. You will receive a message starting with:
    Done! Congratulations on your new bot.
  5. Click the blue line after Use this token to access the HTTP API: (blurred in the screenshot) to copy your bot's API token to the clipboard. Keep the token secure, as anyone with it can control your bot

notifications

note

The API token is stored in @BotFather. If you forget it, send the /mybots command, select your bot, and click the "API Token" button.

  1. Open FASTPANEL® and navigate to "Settings" → "Notifications".
  2. Click the "Create channel" button

notifications

  1. Fill in the following fields:
  • Name — Enter a name for the channel to distinguish it visually
  • Channel — Choose "Telegram"
  • Bot token — Paste the bot token copied in step 6
  • Problem period — Set the time interval (in minutes) after which a notification will be sent if the issue persists. Minimum value is 1 minute
  • Notification repeat interval — Set the interval between consecutive notifications for the same issue
  • Notify about solved problems — Enable this option to receive a notification when the issue is resolved
  • Add basic triggers — Enable this option to automatically create triggers for all drives, RAM, and CPU

notifications

  1. Click the "Save" button.
  2. On the next screen, click the "Invite" button to invite your bot to the chat or group chat

notifications

  1. A link will open in a new tab. Confirm the redirect to the Telegram Desktop application

notifications

  1. Click the "Start" button to activate your bot

notifications

  1. To verify that the setup is correct, return to the FASTPANEL® tab and click the paper plane button

notifications

  1. If everything is configured properly, a test notification will be sent to the chat with your bot

notifications

  1. To adjust channel settings later, click the pencil icon next to the channel

notifications

  1. Below is an example of a notification generated when a trigger is activated

notifications

Slack

  1. Log in to your account and create a Slack app via the apps page.
  2. Select "From scratch".
  3. Enter an App Name, choose the workspace where the app will be created, and click “Create app”.
  4. In the “Features” section, open “Incoming Webhooks” and enable the feature

notifications

  1. At the bottom of the same page, click “Add New Webhook”

notifications

  1. On the next screen, select the channel where notifications will be sent. It is recommended to create a dedicated channel for alerts. Then click “Allow”.
  2. You will be redirected back to the webhooks page. Scroll down and click “Copy” to copy the webhook URL

notifications

  1. Open FASTPANEL® and navigate to "Settings" → "Notifications".
  2. Click the "Create channel" button

notifications

  1. Fill in the following fields:
  • Name — Enter a name for the channel to visually distinguish it
  • Channel — Choose "Slack"
  • Webhook url — Paste the webhook URL copied in step 7
  • Problem period — Set the time interval (in minutes) after which a notification will be sent if the issue persists. Minimum value is 1 minute
  • Notification repeat interval — Set the interval between consecutive notifications for the same issue
  • Notify about solved problems — Enable this option to receive a notification when the issue is resolved
  • Add basic triggers — Enable this option to automatically create triggers for all drives, RAM, and CPU

notifications

  1. Click the "Save" button.
  2. To verify that the setup is correct, click the paper plane button

notifications

  1. If everything is configured correctly, a test notification will be sent to the channel selected in step 6

notifications

  1. To adjust channel settings later, click the pencil icon next to the channel

notifications

  1. Below is an example of a notification generated when a trigger is activated

notifications

Triggers configuration

To configure triggers, click the cog icon in the row of the channel you want to edit

notifications

In the opened section, you can:

  1. Disable unnecessary triggers using the toggle on the left.
  2. Create a new trigger of one of the following types: CPU, Disk (for each disk individually), Load Average 5 (average system load over the last 5 minutes), RAM.
  3. Edit existing triggers

notifications

Thresholds for CPU, Disk, and RAM are set in percentages. Threshold for Load Average 5 is set in integer values.

note

As a general rule, a normal Load Average 5 value is approximately equal to the number of CPU cores on the server, or up to twice that number.