What is monita-collector?

Monita Collector is the server-side piece of Monita, an open-source infrastructure monitoring platform. It receives metrics and logs sent by small agent programs running on your servers, stores everything in a PostgreSQL database, and exposes a REST API so you can query, stream, and set up alerts on that data. A separate companion project, monita-agent, is the lightweight program that actually runs on your monitored machines and ships data to this collector. Once agents are sending data, this collector lets you query metrics like CPU, memory, disk, and network usage by agent, time window, or label. It also stores logs with full text search, so you can search through log entries from your servers. You can define alert rules that watch metrics or logs and fire an event when a condition is met, and those events can later be marked resolved. For anyone who wants to watch things happen live rather than refresh a page, the collector streams metrics and log updates in real time using Server Sent Events, a simple way for a server to keep pushing updates to a connected browser or app. Security is handled with two layers. People who log into the dashboard get a JWT, a signed token proving who they are. Agents sending data use a bearer token plus a per-request cryptographic signature, which protects against replayed or tampered requests and includes protection against clock drift between machines. The project also includes basic operational features like rate limiting to prevent abuse, input validation that returns clear error messages, and a graceful shutdown process that finishes in-flight requests before stopping. To run it yourself, you need Go, PostgreSQL, and a couple of small command line tools for managing database migrations and generated database code. Setup involves cloning the repo, filling in environment variables such as database connection details and a JWT signing secret, running the database migrations, and starting the server with a single command. The project is licensed under AGPL v3, a copyleft license that generally requires anyone who modifies and runs the software as a network service to share their changes.