https://github.com/nodiscc/netdata-needrestart
[mirror] Check for processes/services/kernels that need to be restarted - netdata plugin
https://github.com/nodiscc/netdata-needrestart
monitoring needrestart netdata unattended-upgrades updates
Last synced: 2 months ago
JSON representation
[mirror] Check for processes/services/kernels that need to be restarted - netdata plugin
- Host: GitHub
- URL: https://github.com/nodiscc/netdata-needrestart
- Owner: nodiscc
- License: gpl-3.0
- Created: 2019-06-14T16:55:50.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2023-07-22T13:57:41.000Z (about 2 years ago)
- Last Synced: 2025-04-03T05:41:30.473Z (6 months ago)
- Topics: monitoring, needrestart, netdata, unattended-upgrades, updates
- Language: Python
- Homepage: https://gitlab.com/nodiscc/netdata-needrestart/
- Size: 23.4 KB
- Stars: 6
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# netdata-needrestart
Check/graph the number of processes/services/kernels that should be restarted after upgrading packages.
This is a `python.d` plugin for [netdata](https://my-netdata.io/). It parses output from [needrestart](https://fiasko.io/tag/needrestart.html).
When no restarts are required all charts will have a value of 0. Values higher than 0 indicate that a restart is required, or that there was an error opening/reading the log file. The chart is always visible when the plugin is installed. Any value higher than 0 will raise a warning in netdata alarms (and trigger a notification).
## Installation
This plugin expects the last [batch](https://github.com/liske/needrestart/blob/master/README.batch.md) output of needrestart at `/var/log/needrestart.log`
```bash
# install needrestart
apt install needrestart
# clone the repository
git clone https://gitlab.com/nodiscc/netdata-needrestart
# generate the initial file
needrestart -b > /var/log/needrestart.log
# configure dpkg to refresh the file after each run
cp netdata-needrestart/etc_apt_apt.conf.d_99needrestart /etc/apt/apt.conf.d/99needrestart
# add a cron job to refresh the file every 30 minutes
cp netdata-needrestart/etc_cron.d_needrestart /etc/cron.d/needrestart
# install configuration files/alarms
netdata_install_prefix="/opt/netdata" # if netdata is installed from binary/.run script
netdata_install_prefix="" # if netdata is installed from OS packages
cp netdata-needrestart/needrestart.chart.py $netdata_install_prefix/usr/libexec/netdata/python.d/
cp netdata-needrestart/needrestart.conf $netdata_install_prefix/etc/netdata/python.d/
cp netdata-needrestart/health.d_needrestart.conf $netdata_install_prefix/etc/netdata/health.d/needrestart.conf
# restart netdata
systemctl restart netdata
```
## Configuration
No configuration is required. Common `python.d` plugin options can be changed in [`needrestart.conf`](needrestart.conf).
The default `update every` value is 120 seconds so the initial chart will only be created after 2 minutes. Change this value if you need more accuracy.
You can get details on which services need to be restarted by reading mail sent by needrestart, running `needrestart`, or reading the log file.
You can schedule an automatic restart at a convenient time, for example using `echo reboot | at 22:00`.
## Debug
To debug this plugin:
```bash
$ sudo su -s /bin/bash netdata
$ $netdata_install_prefix/usr/libexec/netdata/plugins.d/python.d.plugin 1 debug trace needrestart
```
## TODO
- Graph one line for each service/kernel, by name
## License
[GNU GPLv3](LICENSE)
## Mirrors
- https://github.com/nodiscc/netdata-needrestart
- https://gitlab.com/nodiscc/netdata-needrestart