docs: added barebones readme.md

This commit is contained in:
əlemi 2024-12-03 02:27:42 +01:00
parent bd9f855107
commit a1558bd7b3
Signed by: alemi
GPG key ID: A4895B84D311642C

24
README.md Normal file
View file

@ -0,0 +1,24 @@
# uppe.rs
> batteries-included uptime monitor for your infrastructure
`uppe.rs` runs off a single binary, a configuration file (in toml) and an sqlite database (can be in memory or persisted on disk), and provides a daemon that tests configured routes while also serving a tiny API and web frontend.
it periodically makes requests to configured services, and tracks roundtrip time (or if no response was returned at all!). this data is then accessible using `uppe.rs` tiny builtin api, and can be viewed on the integrated webpage (served on service's `/`)
as an example, check out my instance on [up.alemi.dev](https://up.alemi.dev)
## goals
this aims to be super simple to use to glance at your stuff and help figuring out if there are issues. this doesn't aim to be an extensive monitoring solution for infrastructure, and while it can fit the role it isn't actively maintained against that use-case.
future features which would be nice to add are:
* notifications on downtime
* auto-cleanup of old samples
* configurable frontend span
* graph references on frontend
* data exporters
* full database engine to use mysql/psql
* multi-protocol endpoint tester
## name
honestly pretty bad, probably a mix of uptime + rust + monitors + stimulants. send me better ideas plz, contacts on my site