greggd

Lightweight Linux, macOS, and Windows metrics daemon for the gregg monitoring ecosystem.

Installation

cargo install greggd

Usage

Run the daemon in the foreground (intended for systemd, launchd, or interactive diagnostics):

greggd run
greggd run --config /path/to/greggd.toml

Manage the system service:

greggd start
greggd stop
greggd restart
greggd croncheck

On Windows, the service entry point is greggd service (internal, used by the SCM). Install/uninstall via the provided PowerShell scripts in packaging/.

Configuration

Default config path:

Linux: /etc/gregg/greggd.toml
macOS: /Library/Application Support/gregg/greggd.toml
Windows: %ProgramData%\gregg\greggd.toml

Override the default with --config PATH.

Network

This daemon is designed for private networks only. It exposes a read-only HTTP/1 JSON API on the configured port (default 11310) and is not hardened for public internet exposure. No firewall rules are created automatically. LAN exposure is operator-controlled and the daemon has no TLS or authentication.

/v2/status is the universal status endpoint and may include a bounded drives list of mounted local filesystem names with numeric used and total bytes. Missing or null drive data means unavailable/legacy; an empty list means successful enumeration with no eligible volumes. Collection is best-effort and does not model physical disks or storage topology. Linux and macOS retain /v1/status; Windows is v2-only for status semantics.

License

MIT