https://github.com/yurenchen000/disk_notify

send notify if disk space low
https://github.com/yurenchen000/disk_notify

disk-space notification notify

Last synced: 29 days ago
JSON representation

send notify if disk space low

• Host: GitHub
• URL: https://github.com/yurenchen000/disk_notify
• Owner: yurenchen000
• Created: 2024-10-21T15:58:49.000Z (3 months ago)
• Default Branch: main
• Last Pushed: 2024-10-21T19:18:08.000Z (3 months ago)
• Last Synced: 2024-10-22T03:47:50.595Z (3 months ago)
• Topics: disk-space, notification, notify
• Language: Shell
• Homepage:
• Size: 12.7 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
disk notify

===========

send notify if disk avail space low

[README 中文](README_CN.md)



- Lightweight: only bash, df, curl

- Focus: only notify alert if space low

- Accuracy: partition specified threshold

- Reliable: multiple push channels




## 🛠️ Settings

it can monit multi mountpoint with specified thresholds  

by bash associative array. (key-value pairs)

```sh

declare -A mount_thresholds=(

    ["/"]="5120"      # 5 GB in MB

    ["/tmp"]="1024"   # 1 GB in MB

)

```




supported notify backends

- telegram bot

- feishu bot

- wework bot

- dingtalk bot

- pushplus

- wxpusher

- serverchan




logs

- disk_log=disk_hist.log   //disk space log

- send_log=send_hist.log   //send noitfy log




notify frequency

- push_delay=30 //push interval (will adjusted dynamically)




check frequency

- save_interval=3600  // 1 hour

- check_interval=300  // 5 min




## 🚀 Usage

download from https://github.com/yurenchen000/disk_notify/releases/latest  

and uncompress it.

// edit conf base on example  

```

cp -pv _disk_notify_global.example _disk_notify_global  

// modify the conf according to your needs  

```

conf file

- ./_disk_notify_global

- ~/.config/_disk_notify




// run in background

```

nohup ./disk_notify.sh &> disk_notify.out &

```