Monitoring Agent
statsd
A lightweight daemon that collects system metrics and Docker container stats from your machine and streams them to the System Stats cloud in real time.
Available on macOS and Linux. Runs as a background service.
What it collects
statsd gathers system metrics and container stats every second and sends them over MQTT.
CPU
Overall and per-core usage, load averages (1, 5, 15 min), and clock frequency.
GPU
Utilization, render/tiler activity, temperature, and memory usage.
RAM
Total, used, and free memory, swap usage.
Disk
Storage capacity, used space, and read/write I/O per disk.
Network
Upload/download throughput, local and public IPs per interface.
Docker
Container state, CPU, memory, network I/O, disk I/O, health, and port mappings.
Hardware Details
CPU model, GPU specs, RAM modules, disk info, OS version, and architecture.
How it works
Install and authorize
Run the install command, then authorize the agent with your System Stats account using a device code.
Collects metrics locally
statsd reads system metrics every second and Docker container stats every 3 seconds with minimal resource overhead.
Streams to the cloud
Data is sent over a secure MQTT connection to the System Stats backend, which feeds the web dashboard in real time.
Receives commands
The agent listens for remote commands — like container start/stop, software updates, or sleep — sent from the dashboard.
CLI commands
Manage the agent from your terminal.
statsd upStart the agentstatsd downStop and log outstatsd statusCheck running statusstatsd systemShow system infostatsd updateUpdate to latest versionstatsd logsStream application logsstatsd startStart as background servicestatsd stopStop background serviceInstall on macOS or Linux and start streaming metrics in minutes.