#metrics #server #http

metrics_server

A hassle-free, single-responsibility, safe HTTP/S server used to easily expose metrics in an application

20 releases (breaking)

0.15.0 May 29, 2024
0.13.0 Aug 28, 2023
0.12.0 Feb 23, 2023
0.10.1 Dec 27, 2022
0.1.1 Feb 28, 2022

#223 in HTTP server

Download history 2/week @ 2024-07-30 3/week @ 2024-09-17 48/week @ 2024-09-24

1,166 downloads per month

MIT license

20KB
199 lines

metrics_server

CI Version Docs License

Note: This lib's API should NOT currently be considered stable - it might change before v1.

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.

Usage

Include the lib in your Cargo.toml dependencies:

[dependencies]
metrics_server = "0.15"

To enable TLS support, pass the optional feature flag:

[dependencies]
metrics_server = { version = "0.15", features = ["tls"] }

HTTP

use metrics_server::MetricsServer;

// Create a new HTTP server and start listening for requests in the background.
let server = MetricsServer::http("localhost:8001");

// Publish your application metrics.
let bytes = server.update("my_awesome_metric = 10".into());
assert_eq!(22, bytes);

// Stop the server.
server.stop().unwrap();

HTTPS

Note: there is currently no option to skip TLS cert verification.

use metrics_server::MetricsServer;

// Load TLS config.
let cert = include_bytes!("/path/to/cert.pem").to_vec();
let key = include_bytes!("/path/to/key.pem").to_vec();

// Create a new HTTPS server and start listening for requests in the background.
let server = MetricsServer::https("localhost:8443", cert, key);

// Publish your application metrics.
let bytes = server.update("my_awesome_metric = 10".into());
assert_eq!(22, bytes);

// Stop the server.
server.stop().unwrap();

Serve a custom URL

use metrics_server::MetricsServer;

// Create a new server and specify the URL path to serve.
let mut server = MetricsServer::new("localhost:8001", None, None);
server.serve_uri("/path/to/metrics");

// Publish your application metrics.
let bytes = server.update("my_awesome_metric = 10".into());
assert_eq!(22, bytes);

// Stop the server.
server.stop().unwrap();

For more comprehensive usage, see the included examples.

Dependencies

~2–11MB
~131K SLoC