47 releases

Uses new Rust 2024

new 0.2.1 Mar 27, 2025
0.2.0 Mar 27, 2025
0.1.156 Mar 19, 2025
0.1.20 Feb 28, 2025

#69 in Unix APIs

Download history 1142/week @ 2025-02-26 263/week @ 2025-03-05 1972/week @ 2025-03-12 1409/week @ 2025-03-19

4,786 downloads per month

Custom license

410KB
10K SLoC

Lueur Proxy CLI

Demo

lueur is here to help you uncover and address resiliency issues early in your development cycle. By easily injecting network faults into your application’s daily workflows, lueur encourages you to shift resiliency concerns to the left, long before reaching production. The result: more confident engineering teams and applications that gracefully handle the unexpected.

At its core, lueur acts as a local proxy you can route traffic through, giving you fine-grained control over conditions like latency, jitter, and faults. Rather than waiting until late-stage testing or worse, customer reports, you can quickly see how your application responds when the network isn’t perfect.

Why lueur?

  • Speed: Quickly stand up a local test environment with minimal setup.
  • Simplicity: Just a few commands let you inject latency or run complex scenarios. No steep learning curve required.
  • Extensibility: Tweak parameters, plug into automated tests, and integrate with your existing CI/CD pipelines.
  • Insight: Generate structured reports that help pinpoint issues and identify ways to improve resiliency.

Install

Using built binaries

lueur is distributed as built bianries on GitHub. Please refer to the documentation.

Using cargo

The lueur proxy is installed as follows

cargo +nightly install lueur-cli

If you want to enable ebpf support (highly experimental and likely broken):

cargo +nightly install lueur-cli --features stealth

In that case you will also need to install the lueur ebpf programs.

Run

Once installed, you can start a latency fault inkjection proxy (for instance):

lueur run --with-latency --latency-mean 300 --latency-direction ingress --upstream localhost:9090

This is will inject 300ms (mean) latency on network coming back from the host localhost:9090.

Dependencies

~52–90MB
~1.5M SLoC