Crate aya_metrics 

Gets metrics from an eBPF program!

This is a generalized user space implementation to collect custom metrics from an eBPF program.

The module provides the EbpfMetrics type, which reads counters created in eBPF and emits them using the metrics crate. Any implementation of the [metrics::recorder::Recorder] trait can be used once it is set as the global recorder.

Example:

Define counters:

#[derive(Copy, Clone)]
enum MyCounter {
    Packets,
    Bytes,
}

impl aya_metrics_common::Counter for MyCounter {
    fn name(self) -> String {
        match self {
            MyCounter::Packets => "packets_counter".to_string(),
            MyCounter::Bytes => "bytes_counter".to_string(),
        }
    }

    fn index(&self) -> u32 {
        match self {
            MyCounter::Packets => 0,
            MyCounter::Bytes => 1,
        }
    }
}

let metrics = vec![
    Metric::new(
        MyCounter::Packets,
        Unit::Count,
        vec![
            Dimension::By(vec![]),
            Dimension::By(vec![Label::new("hostname", "test.hostname")]),
        ]
    )
];

Emit metrics:

// start emitting metrics using the global recorder
EbpfMetrics::new(&mut bpf, metrics, Duration::from_secs(60)).unwrap();

With the following eBPF code:

use aya_metrics_common::metrics::{counter, Counter};
use my_crate::MyCounter;

counter(MyCounter::Packets, 1);

Structs

EbpfMetrics

Emits custom metrics generated by an eBPF program using the metrics crate.

Metric

Defines a metric that EbpfMetrics can report on.

Enums

Dimension

Defines the dimension of a particular Metric.

Error

Errors occuring from working with EbpfMetrics