Releases: fabioconcina/alertpaca
Releases · fabioconcina/alertpaca
v0.8.1
What's fixed
- Disk usage % on filesystems with reserved blocks.
sysinfo'savailable_space()returnsf_bavail(space for non-root), so the previoustotal - availableformula counted ext4's default 5% root reserve as used. An empty 220G/mnt/ssdreported 5% used / 11.3G. - alertpaca now calls POSIX
statvfsdirectly:used = (f_blocks - f_bfree) * f_frsize,pct = used / (used + available). Matchesdf.
v0.8.0
What's new
- Temperature monitoring — auto-detects CPU package and NVMe/disk composite temps via sysinfo Components. Warns at 15°C below hardware-reported critical threshold (defaults: 95°C CPU, 70°C disk).
- Cleaner disk listing — boot partitions (
/boot,/boot/efi) are now filtered out to reduce noise.
v0.7.0
What's new
Cron job monitoring — alertpaca now auto-detects cron jobs by parsing crontab -l, /etc/crontab, and /etc/cron.d/*, then checks journald/syslog for evidence of execution. Warns if a scheduled job appears to have missed its window.
- Supports standard 5-field schedules, system crontabs (with user field), and shorthands (
@daily,@hourly, etc.) - 25-hour lookback window covers daily jobs with slack
- Summary by default, per-job detail with source file only on warnings
- Optional
[cron]config section to ignore noisy entries (e.g.run-parts) - Linux only, zero configuration required
Config example
[cron]
ignore = ["run-parts"]v0.6.0
What's new
- Pending updates check — detects upgradable apt packages and warns on security updates (Linux only)
Downloads
| Platform | Binary |
|---|---|
| Linux x86_64 | alertpaca-linux-amd64 |
| macOS Apple Silicon | alertpaca-darwin-arm64 |
# Linux
curl -Lo alertpaca https://github.com/fabioconcina/alertpaca/releases/latest/download/alertpaca-linux-amd64
chmod +x alertpaca && ./alertpaca
# macOS
curl -Lo alertpaca https://github.com/fabioconcina/alertpaca/releases/latest/download/alertpaca-darwin-arm64
chmod +x alertpaca && ./alertpacav0.5.0
Notifications
- ntfy.sh notifications — alert on status changes (Warning/Critical/Recovery)
- State-based diffing: only notifies on transitions, not every run
- Works with ntfy.sh, Slack webhooks, Discord webhooks, Gotify, or any POST endpoint
- Config:
[notify] url = "https://ntfy.sh/your-topic"
v0.4.0
What's new
- HTTP endpoint checks — monitor web services with configurable URL checks. Critical if unreachable/5xx, warn if 4xx. Shows response time and status code.
- DNS resolution checks — verify DNS servers resolve domains correctly. Critical if resolution fails, warn if >1s. Useful for monitoring Pi-hole/Unbound chains.
Configuration
[[endpoint]]
name = "Immich"
url = "http://localhost:2283"
# expect_status = 200 # optional
[[dns]]
name = "Pi-hole"
domain = "google.com"
server = "192.168.1.100" # optional, defaults to 127.0.0.1v0.3.0
What's new
- NTP clock skew check — queries
pool.ntp.org(configurable), warns at >100ms, critical at >1s - Swap usage check — auto-detected, warns at >50%, critical at >90% (hidden if no swap)
Configuration
NTP server and thresholds are optionally configurable in config.toml:
[ntp]
server = "time.google.com"
warn_ms = 50
critical_ms = 500v0.2.0
What's new
- Splash screen — 2-second centered ASCII art logo on startup (any key to dismiss)
--json— run all checks once, output JSON array to stdout--once— run all checks once, print plain-text table to stdout--mcp— MCP server over stdio withcheck_healthtool for AI agents- Exit codes — 0 (all ok), 1 (error), 2 (warning/critical found)
llms.txt— LLM-friendly project reference- Rust edition 2024
Exit codes
| Code | Meaning |
|---|---|
| 0 | All checks passed (Ok or Skipped) |
| 1 | Error (config load failure, I/O error) |
| 2 | At least one check returned Warning or Critical |
Download
alertpaca-linux-amd64— Linux x86_64alertpaca-darwin-arm64— macOS Apple Silicon
v0.1.0
Initial release.
Checks
- CPU, memory, disk usage (with fill prediction), system load, uptime
- Systemd failed units, Docker unhealthy/restarting containers
- Backup freshness (file glob, restic, ZFS) — via config
- TLS certificate expiry — via config
- Port/service drift detection
Download
alertpaca-linux-amd64— Linux x86_64alertpaca-darwin-arm64— macOS Apple Silicon