Lightweight Go agent
A single static binary per host. Collects CPU, memory, disk, and network metrics, with privacy-conscious process telemetry as an opt-in.
Open source · Self-hosted
A lightweight Go agent streams CPU, memory, and disk metrics to a TimescaleDB-backed core, and a real-time dashboard shows you exactly what your infrastructure is doing.
Kanshi keeps the surface area small: one agent, one core, one dashboard, and no external services required.
A single static binary per host. Collects CPU, memory, disk, and network metrics, with privacy-conscious process telemetry as an opt-in.
Metrics are batched on the agent and streamed to core over gRPC, with automatic reconnection when the link drops.
Backed by TimescaleDB, PostgreSQL with real time-series chops. Time-bucketed rollups keep range queries fast at any zoom level.
Explore seven days of host history, processes, services, traces, and host navigation in a persistent Light or Dark theme.
Everything the dashboard shows comes from a clean REST API with consistent responses, so you can build your own tooling on top of it.
Your metrics stay on your infrastructure. Run the whole stack with Docker Compose; read every line on GitHub.
Three small components, each with one job. Deploy them together with Docker Compose or run each piece where it fits.
agentThe agent samples CPU, memory, disk, and network activity on each host. Process telemetry is available as an explicit opt-in.
gopsutil · 5s interval
coreBatches stream to core over gRPC and land in TimescaleDB, where time-bucketed queries stay fast as history grows.
gRPC :50051 · TimescaleDB
dashboardThe dashboard reads core's REST API for fleet history, process details, application telemetry, and host navigation.
REST :8080 · React
One command starts the complete Docker demo. No Kanshi binary is installed on your machine.
The demo already includes an Agent. For host Agent setup and configuration, read the installation guide.
# Start the complete Docker demo
curl -fsSL https://kanshi.dev/demo.sh | sh
# Open the dashboard
open http://localhost:3000
# Optional: install the Agent on this host
curl -fsSL https://kanshi.dev/install.sh | sh