Note: this lib is NOT stable. The API might change before v1.0
A hassle-free, single-responsibility, safe HTTP/S server used to easily expose metrics in an application.
This crate provides a thread safe, minimalstic HTTP/S server used to buffer metrics and serve them via a standard /metrics endpoint. It's aim is to remove the boilerplate needed to create such simple mechanisms. It is currently somewhat oppinionated and naive in order to maintain little complexity.
Include the lib in your Cargo.toml dependencies:
toml
[dependencies]
metrics_server = "0.6"
```rust use metrics_server::MetricsServer;
// Create a new HTTP server and start listening for requests in the background. let server = MetricsServer::http("localhost:8001");
// Publish you application metrics. let bytes = server.update(Vec::from([1, 2, 3, 4])); assert_eq!(4, bytes); ```
Note: there is currently no option to skip TLS cert verification. ```rust use metrics_server::MetricsServer;
// Load TLS config. let cert = includebytes!("/path/to/cert.pem").tovec(); let key = includebytes!("/path/to/key.pem").tovec();
// Create a new HTTPS server and start listening for requests in the background. let server = MetricsServer::https("localhost:8443", cert, key);
// Publish you application metrics. let bytes = server.update(Vec::from([1, 2, 3, 4])); assert_eq!(4, bytes); ```
For more comprehensive usage, see the included examples.