💾 Archived View for gmi.noulin.net › markdown › heartbeat_README.md captured on 2024-08-31 at 17:54:09.

View Raw

More Information

⬅️ Previous capture (2024-08-25)

-=-=-=-=-=-=-

# Heartbeat

`heartbeat` is a simple monitoring system which uses udp to send logs and sends event by mail.

About 300 machines can be monitored simultaneously with this system.

Running `heartbeat` without argument starts the monitoring.

`heartbeat` sends messages to the bridge. When the bridge is not logger, the messages are forwarded to the next bridge. This allows monitoring machines in private networks.

# Install

Install libsodium in debian like this:

git clone https://github.com/jedisct1/libsodium

git checkout stable

./configure

make

make install

Install sheepy: [sheepy](https://spartatek.se/r/sheepy/file/README.md.html)

Compile `heartbeat`:

./make.sh

# Configuration

See `heartbeatConfig.yml`

For `heartbeat` to send mails, mutt has to be configured.

# Setup

- Generate the configuration script: `./heartbeat config`
- The configuration script starts `heartbeat` and setups systemd to the start `heartbeat` at boot as a daemon
- The state is displayed with: `heartbeat monitor`