HDD Monitoring Proxmox

Tutorial to setup Scrutiny HDD Monitoring & Alerting Dashboard on Proxmox (really useful for RAID setups)

Scrutiny setup

Web+DB

I opened a PR on Dokploy's Github, as of now it's pending but you can still use it by setting "Base URL" to: https://kipavy-add-scrutiny-template.templates-70k.pages.dev/

If you don't want to use dokploy you can browse that link and just copy the docker-compose.yml from scrutiny template.

Collector

The collector must be on proxmox host since LXCs don't have access to S.M.A.R.T data (it may be possible via VMs with PCI passthrough but I don't recommend it and haven't tried it)

For reference:

[HELP] How to install Scrunity on Proxmox · Issue #534 · AnalogJ/scrutinyGitHub

scrutiny/docs/INSTALL_HUB_SPOKE.md at master · AnalogJ/scrutinyGitHub

---

You can just change API_ENDPOINT in the script to match your Scrutiny Web IP + Port and paste the script in proxmox shell.

#!/bin/bash

# CHANGE ME
API_ENDPOINT="http://192.168.1.xx:8080"


############# Scrutiny Collector ###################
apt install -y smartmontools
INSTALL_DIR="/opt/scrutiny"
BIN_DIR="$INSTALL_DIR/bin"
LATEST_RELEASE_URL="https://github.com/AnalogJ/scrutiny/releases/latest/download/scrutiny-collector-metrics-linux-amd64"

mkdir -p $BIN_DIR
curl -L $LATEST_RELEASE_URL -o $BIN_DIR/scrutiny-collector-metrics-linux-amd64
chmod +x $BIN_DIR/scrutiny-collector-metrics-linux-amd64

############## Scrutiny Service ####################
mkdir -p /root/scrutiny
cat << EOF > /root/scrutiny/scrutiny.sh
#!/bin/bash
/opt/scrutiny/bin/scrutiny-collector-metrics-linux-amd64 run --api-endpoint "$API_ENDPOINT" 2>&1 | tee /var/log/scrutiny.log
EOF
chmod +x /root/scrutiny/scrutiny.sh

cat << 'EOF' > /etc/systemd/system/scrutiny.service
[Unit]
Description="Scrutiny Collector"
Requires=scrutiny.timer

[Service]
Type=simple
ExecStart=/root/scrutiny/scrutiny.sh
User=root
EOF

cat << 'EOF' > /etc/systemd/system/scrutiny.timer
[Unit]
Description="Timer for the scrutiny.service"

[Timer]
Unit=scrutiny.service
OnBootSec=5min
OnUnitActiveSec=12h

[Install]
WantedBy=timers.target
EOF

systemctl daemon-reload
systemctl enable --now scrutiny.timer
systemctl status scrutiny.timer

You'll now have access to Scrutiny Dashboard on http://192.168.1.xx:8080

Configuring Alerting

Scrutiny supports webhook alerting through Shouttr, we'll set up discord alerting.

1. Get a discord webhook: create a server and a channel dedicated for Scrutiny

1. Create config/scrutiny.yaml based example.scrutiny.yaml with discord webhook matching shouttr's url format.

2. You can try to trigger an alert with

curl -X POST http://192.168.1.xx:XXXX/api/health/notify

If it doesn't work try to restart or rebuild the scrutiny container.