statsd.
One command. Live metrics.
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.
Every metric, every second.
statsd gathers system metrics every second and Docker container stats every three seconds, then sends them over a secure MQTT connection.
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, plus swap usage.
Disk
Storage capacity, used space, and read/write I/O per disk.
Network
Upload and download throughput, local and public IPs per interface.
Docker
Container state, CPU, memory, network & disk I/O, health, and port mappings.
Hardware
CPU model, GPU specs, RAM modules, disk info, OS version, and architecture.
From $ statsd up to live in two minutes.
Install and authorize
Run the install command - it automatically enters authorize mode. Open the link from the logs to connect it to your System Stats account.
Collects metrics locally
statsd reads system metrics every second and Docker container stats every 3 seconds - minimal 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.
Prefer containers? Run statsd in Docker.
Run the agent as a container instead of a background service. Mounting the Docker socket lets statsd report container stats from the host.
services:
statsd:
image: exelban/statsd:latest
restart: unless-stopped
network_mode: host
volumes:
- ./statsd:/root/.statsd
- /var/run/docker.sock:/var/run/docker.sock:rodocker compose).Create the compose file
Save the configuration to a docker-compose.yml in an empty directory.
Start the container
Pull the image and bring statsd up in the background.
$ docker compose up -dAuthorize the agent
The agent enters authorize mode automatically on first start. Check the logs and open the link to connect it to your System Stats account.
$ docker compose logs -f statsdNote: Docker support is an open beta - behavior may change between releases. network_mode: host is recommended so statsd can read host network interfaces; on Docker Desktop (macOS/Windows) host networking is limited.