Skip to content

Latest commit

 

History

History
45 lines (36 loc) · 2.84 KB

README.md

File metadata and controls

45 lines (36 loc) · 2.84 KB
Raw

Monitor metrics and send notifications to telegram

This allows you to monitor remote machine metrics (disk usage, CPU load, etc.) and send notifications to telegram if certain thresholds are exceeded.

It is necessary to create a cron that executes the script every "x" seconds/minutes/hours/days... and have "bc" installed on the server (apt-get install bc).

The script works similar to Nagios NRPE but without using another external server. It is a low cost monitoring.

Configuration

Edit the checker.sh file and modify the configuration variables with the parameters you want.

  • TELEGRAM_TOKEN: It is necessary to create a new Telegram bot using Bot Father.
  • TELEGRAM_CHAT: It is necessary to create a channel/chat of Telegram and take the ID of it. It is also necessary to put the bot as administrator of the channel/chat.
  • DEBUG_MODE: If you want debug mode, put a 1, if not a 0.
  • RAM_CRITICAL: Percentage of busy RAM that will be notified that the server is in a critical state.
  • RAM_WARNING: Percentage of busy RAM that will be notified that the server is in a warning state.
  • SWAP_CRITICAL: Percentage of busy swap that will be notified that the server is in a critical state.
  • SWAP_WARNING: Percentage of busy swap that will be notified that the server is in a warning state.
  • DISK_CRITICAL: Percentage of busy disk that will be notified that the server is in a critical state.
  • DISK_WARNING: Percentage of busy disk that will be notified that the server is in a warning state.
  • CPU_CRITICAL: Percentage of busy CPU that will be notified that the server is in a critical state.
  • CPU_WARNING: Percentage of busy CPU that will be notified that the server is in a warning state.
  • PING_HOSTS: Host to which the ping will be made. They should be separated by ";".
  • PING_NUMBER: Number of pings to be made in the check.
  • PROCESSES_LIST: Processes that will be verified that they are running. They should be separated by ";".
  • PORTS_LIST: Ports to be checked that are open. It should be written as host:port (For example: localhost:80). They should be separated by ";".
  • DOCKER_CONTAINER_LIST: List of docker containers that want to be checked. It should be written as docker_id:docker_name (For example: 231as3213asdf:BBDD). They sould be separate by ";" (231as3213asdf:BBDD;6145af3213asdf:Script).
  • MAX_SYSTEM_USERS: Maximum number of users (contained in /etc/passwd) that must exist in the system.

Checks available

  • check_ram
  • check_swap
  • check_disk
  • check_cpu
  • check_ping
  • check_processes
  • check_iptables
  • check_ports
  • check_docker
  • check_system_users

Contribution

Feel free to contribute!