Skip to content

Run lueur as a Reliably Plan

This guide will walk you through running lueur as part of a Reliably Plan.

Prerequisites

This guide assumes you have an account on a Reliably platform instance.

Run as part of a Reliably Plan

  • Create the Reliably Experiment

    To create the Experiment, go to the Builder page. Look for the Lueur target and select the Run Network Fault Proxy action.

    Reliably Builder

    Once select, a new page opens and allows you to fill the details of your experiment.

    • Set a meaninful title and description
    • Set tags that will allow members to filter experiments
    • Set contributions which define the dimensions impacted by the experiment

    Next, fill the experiment's activities:

    Reliably Experiment Form

    Pass the proxy CLI arguments as you would to the lueur run command itself. For instance, let's use the following argument line:

        --with-latency \ # (1)!
        --latency-mean 300 \ # (2)!
        --latency-sched "duration:20%;start:50%,duration:40%" # (3)!
    
    1. Run lueur with a latency fault
    2. Inject a 300ms delay on responses
    3. Inject the fault only for around 60% of the total duration of the run

    We suggest you run the action in background so that other activities can take place while it is running.

    Finally, if you did not set the --duration flag, you want to keep the Stop Network Proxy action so that your proxy is properly terminated.

    At that stage you may want to insert new activities once the proxy has started by clicking the little + icon on the right of the Run Network Fault Proxy activity.

    For instance, you could run a basic load test and send its traffic via the proxy. Choose the Run Simple Load Test action from the Reliably target provider. Fill the target URL and, at the bottom of the action, set the proxy url to http://localhost:3180 which is the proxy's address.

    Save now the experiment which redirects you to its page.

    Reliably Experiment

  • Schedule the Reliably Plan

    Click now on the Run experiment button which leads you to the Reliably Plan form.

    Reliably Plan Form

    Select now the appropriate deployment to run the experiment. If, you need to pass specific Environment variables, you may set the Environment as well.

    On this example, we also enable the Open AI extension which will send the experiment's questions to OpenAI while the plan runs.

    Info

    No other information is ever sent to OpenAI.

    The plan will then be scheduled to start immediately.

    Reliably Plan

  • Review the Reliably Execution

    Once the plan has completed, you may review its execution. Below is the timeline of this execution:

    Reliably Execution Timeline

    Zooming into the Run Simple Load Test step, we can indeed see how around 60% of the requests were impacted by our latency.

    Reliably Plan Load Test

    As a bonus point, we can also see that our questions to OpenAI were keenly answered:

    Reliably Plan Assistant

    The assistant exposes the theory behind exploring latency and moves on to show us a Chaos Toolkit experiment. Remember that a Chaos Toolkit experiment can be imported and used as a Reliably Experiment.

    Critical thinking remains your best strategy

    LLM models are known to hallucinate at times. Here, the model shows us an action that does not exist in the catalog of Chaos Toolkit known activities. Nonetheless, it's a valuable discussion starting point.

    Reliably Plan Assistant Follow up

    The assistant expands on its reply with more useful context about what to look for as your run such an experiment.

    Overall, the assistant is here to support your own analysis and you should use it as a data point only, not as the one truth.

Next Steps

  • Explore Reliably to understand how you can run a plan on various deployment targets.