8 releases

0.2.1 Oct 9, 2024
0.2.0 Feb 28, 2024
0.1.13 Nov 16, 2022
0.1.11 Sep 1, 2022
0.1.1 Oct 15, 2021

#415 in Unix APIs

Download history 2393/week @ 2024-10-30 2253/week @ 2024-11-06 2121/week @ 2024-11-13 2781/week @ 2024-11-20 2659/week @ 2024-11-27 2890/week @ 2024-12-04 2802/week @ 2024-12-11 2232/week @ 2024-12-18 2166/week @ 2024-12-25 2982/week @ 2025-01-01 4103/week @ 2025-01-08 4747/week @ 2025-01-15 4030/week @ 2025-01-22 3689/week @ 2025-01-29 3676/week @ 2025-02-05 2770/week @ 2025-02-12

14,882 downloads per month
Used in 4 crates (2 directly)

MIT/Apache

650KB
13K SLoC

aya-log - a logging library for eBPF programs

Overview

aya-log is a logging library for eBPF programs written using aya. Think of it as the log crate for eBPF.

Installation

User space

Add aya-log to Cargo.toml:

[dependencies]
aya-log = { git = "https://github.com/aya-rs/aya", branch = "main" }

eBPF side

Add aya-log-ebpf to Cargo.toml:

[dependencies]
aya-log-ebpf = { git = "https://github.com/aya-rs/aya", branch = "main" }

Example

Here's an example that uses aya-log in conjunction with the env_logger crate to log eBPF messages to the terminal.

User space code

use aya_log::EbpfLogger;

env_logger::init();

// Will log using the default logger, which is TermLogger in this case
EbpfLogger::init(&mut bpf).unwrap();

eBPF code

use aya_log_ebpf::info;

fn try_xdp_firewall(ctx: XdpContext) -> Result<u32, ()> {
    if let Some(port) = tcp_dest_port(&ctx)? {
        if block_port(port) {
            info!(&ctx, "❌ blocked incoming connection on port: {}", port);
            return Ok(XDP_DROP);
        }
    }

    Ok(XDP_PASS)
}

Dependencies

~5–14MB
~178K SLoC