The experiment lifecycle
Read time: 2 minutes
Last edited: Oct 22, 2021
This topic explains how to start recording data in an experiment and stop the experiment when you're finished.
Experiments do not start collecting data automatically. When you have a new experiment iteration you're ready to run, you must press the Start recording on the experiment itself.
Here is an image of the start recording screen:
The Start recording button only starts a new iteration of the experiment in that specific environment. If you wish to run the same experiment in multiple environments, you must press the Start recording button on each experiment in each environment. This behavior prevents you from being billed for events you don't want to track.
To learn more about creating an experiment, read Creating experiments.
After you start your experiment iteration, you can check on it at any time in the flag's Experimentation tab. Experiment data appears in the Experiments page after a few minutes. You may have to refresh the page to fetch new data for your experiment.
If you've discovered a winning variation, need to make changes to your experiment, or decided to stop running the experiment iteration for some other reason, you can stop collecting events by clicking Stop recording this metric on any running experiment.
Here is an image of the stop recording option:
You can stop recording an experiment at any time. Just like the start button, the stop button only impacts one experiment in one environment. If you wish to stop collecting data from every instance of an experiment, you must stop each experiment in each environment individually.
When you stop recording an experiment, LaunchDarkly ends the iteration and stops collecting data about user behavior for that experiment. The data collected for that iteration is available on the experiment's card.
To view the data, choose the iteration from the iteration dropdown:
Stopping an experiment is not the same as deleting an experiment. As a best practice, we recommend stopping experiments you're not using, rather than deleting them. This lets you retain the results and data the experiment has already collected.
If you want to start a new iteration of an experiment, click Start recording. The experiment begins collecting event data again in a new iteration, and its chart updates with new information.
Here is an image of the start recording option:
Alternatively, you can start a new iteration of an experiment by choosing Start new iteration from the experiment's overflow menu:
You can delete an experiment permanently from the flag's Experiments page.
Deleting an experiment means deleting all the event data collected for every iteration of that experiment in every environment. We recommend stopping experiments whenever possible, rather than deleting them.
To delete an experiment:
- Navigate to a flag's Experimentation tab and find the experiment you wish to delete.
- Click the overflow menu icon. A dropdown menu appears.
- Click Remove metric from this experiment.