Autometrics provides a macro that makes it easy to instrument any function with the most useful metrics: request rate, error rate, and latency. It then uses the instrumented function names to generate Prometheus queries to help you identify and debug issues in production.

Features

• ✨ #[autometrics] macro instruments any function or impl block to track the most useful metrics
• 💡 Writes Prometheus queries so you can understand the data generated without knowing PromQL
• 🔗 Injects links to live Prometheus charts directly into each function's doc comments
• 🔍 Identify commits that introduced errors or increased latency
• 🚨 Define alerts using SLO best practices directly in your source code
• 📊 Grafana dashboards work out of the box to visualize the performance of instrumented functions & SLOs
• ⚙️ Configurable metric collection library (opentelemetry, prometheus, prometheus-client or metrics)
• 📍 Attach exemplars to connect metrics with traces
• ⚡ Minimal runtime overhead

See autometrics.dev for more details on the ideas behind autometrics.

Example Axum App

Autometrics isn't tied to any web framework, but this shows how you can use the library in an Axum server.

```rust use autometrics::{autometrics, prometheus_exporter}; use axum::{routing::*, Router, Server};

// Instrument your functions with metrics

[autometrics]

pub async fn create_user() -> Result<(), ()> { Ok(()) }

// Export the metrics to Prometheus

[tokio::main]

pub async fn main() { prometheus_exporter::init();

let app = Router::new() .route("/users", post(createuser)) .route( "/metrics", get(|| async { prometheusexporter::encodehttpresponse() }), ); Server::bind(&([127, 0, 0, 1], 0).into()) .serve(app.intomakeservice()); } ```

Quickstart

See the Github repo README to quickly add autometrics to your project.

Contributing

Issues, feature suggestions, and pull requests are very welcome!

If you are interested in getting involved: - Join the conversation on Discord - Ask questions and share ideas in the Github Discussions - Take a look at the overall Autometrics Project Roadmap