crypto-mining-tools

Monitoring and alerting scripts for ASIC miners and mining infrastructure. CGMiner API, Start9/DATUM Gateway, Discord webhooks.

I built these to monitor my own mining stack. They run on cron, track state to avoid alert spam, and push alerts to Discord when something goes wrong. Same cron + bash + Discord webhook pattern I use for my DigiDollar oracle monitoring.

---

Tools

Script	Docs	What It Does	Cron
avalon_temp_monitor.sh	AVALON_TEMP_MONITOR.md	Canaan Avalon Q ASIC — temps, fan health, hashboard errors, crash detection. Auto-switches work modes to protect hardware. Works with any CGMiner-compatible ASIC.	*/5
monitor_btc_stack.sh	MONITOR_BTC_STACK.md	Start9 OS + DATUM Gateway — ping check and stratum protocol probe. Catches DATUM outages that a simple TCP check would miss.	*/1
daily_mining_summary.sh	DAILY_MINING_SUMMARY.md	Parses avalon_temp_monitor.sh logs and sends a daily Discord summary — hashrate, temps, power usage, cost, mode split, uptime, and monthly projection.	0 0 *

---

Requirements

All scripts run on a Linux box on the same LAN as your mining hardware. They don't run on the miners themselves.

System packages:

# avalon_temp_monitor.sh needs: curl, socat
# monitor_btc_stack.sh needs: curl, netcat, ping
# daily_mining_summary.sh needs: curl, grep, awk (already installed)
sudo apt install curl socat netcat-openbsd

---

Discord Webhook Setup

The alert scripts (avalon_temp_monitor.sh, monitor_btc_stack.sh) read the webhook URL from a shared file. The daily summary script uses a separate webhook file so summaries go to their own channel.

1. Create Discord webhooks:

Go to your Discord server → channel settings → Integrations → Webhooks → New Webhook. Copy the URL.

2. Save to files on your monitoring server:

# Alerts channel (shared by avalon_temp_monitor.sh and monitor_btc_stack.sh)
echo "https://discord.com/api/webhooks/YOUR_ALERTS_ID/YOUR_ALERTS_TOKEN" > ~/Discord_Webhook.txt
chmod 600 ~/Discord_Webhook.txt

# Daily summary channel (used by daily_mining_summary.sh)
echo "https://discord.com/api/webhooks/YOUR_SUMMARY_ID/YOUR_SUMMARY_TOKEN" > ~/Discord_Webhook_Summary.txt
chmod 600 ~/Discord_Webhook_Summary.txt

3. Test them:

curl -s -H "Content-Type: application/json" \
  -d '{"content":"Test from mining monitor"}' \
  "$(cat ~/Discord_Webhook.txt)"

You should see the message appear in your Discord channel.

Note: Scripts default to reading from /home/ubuntu/Discord_Webhook.txt and /home/ubuntu/Discord_Webhook_Summary.txt. If your username isn't ubuntu, update the WEBHOOK_FILE paths at the top of each script.

---

Related

• digidollar-oracle-tools — My DigiDollar oracle monitoring, hardening guides, and deployment tools.
• GSS/GSSM by MMFP Solutions — Solo mining pool software and miner manager I run for DGB and BTC.
• DATUM Gateway — Stratum proxy between Bitcoin Knots and miners on Start9.

---

License

MIT — see LICENSE.