Lib.rs

Metrics are a powerful and cost-efficient tool for understanding the health and performance of your code in production. But it's hard to decide what metrics to track and even harder to write queries to understand the data.

Autometrics provides a macro that makes it trivial to instrument any function with the most useful metrics: request rate, error rate, and latency. It standardizes these metrics and then generates powerful Prometheus queries based on your function details to help you quickly identify and debug issues in production.

Benefits

• ✨ #[autometrics] macro adds useful metrics to any function or impl block, without you thinking about what metrics to collect
• 💡 Generates powerful Prometheus queries to help quickly identify and debug issues in production
• 🔗 Injects links to live Prometheus charts directly into each function's doc comments
• 📊 Grafana dashboards work without configuration to visualize the performance of functions & SLOs
• 🔍 Correlates your code's version with metrics to help identify commits that introduced errors or latency
• 📏 Standardizes metrics across services and teams to improve debugging
• ⚖️ Function-level metrics provide useful granularity without exploding cardinality
• ⚡ Minimal runtime overhead

Advanced Features

• 🚨 Define alerts using SLO best practices directly in your source code
• 📍 Attach exemplars automatically to connect metrics with traces
• ⚙️ Configurable metric collection library (opentelemetry, prometheus, prometheus-client or metrics)

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.

use std::error::Error;
use autometrics::{autometrics, prometheus_exporter};
use axum::{routing::*, Router};
use std::net::Ipv4Addr;
use tokio::net::TcpListener;

// Instrument your functions with metrics
#[autometrics]
pub async fn create_user() -> Result<(), ()> {
    Ok(())
}

// Export the metrics to Prometheus
#[tokio::main]
pub async fn main() -> Result<(), Box<dyn Error + Send + Sync>> {
    prometheus_exporter::init();

    let app = Router::new()
        .route("/users", post(create_user))
        .route(
            "/metrics",
            get(|| async { prometheus_exporter::encode_http_response() }),
        );


    let listener = TcpListener::bind((Ipv4Addr::from([127, 0, 0, 1]), 0)).await?;
    axum::serve(listener, app).await?;
    Ok(())
}

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