No results for ""
EXPAND ALL
  • Home
  • API docs

GIVE DOCS FEEDBACK

Metric groups

Read time: 5 minutes
Last edited: Jun 15, 2024

Overview

This topic explains how to create and use metric groups. A metric group is a reusable list of metrics you can use to standardize metrics across multiple flags or experiments.

For example, if you have a standard user sign-up flow, you could create four metrics that track customers clicking the sign up button, entering their personal information, adding payment information, and clicking the submit button. By combining these four metrics into a funnel metric group, you can then attach that group to all of your sign-up funnel experiments, ensuring you're tracking the correct metrics for each step within each funnel.

You can view your metric groups from the Metrics list:

The Metrics list.
The Metrics list.

There are two types of metric groups: funnel metric groups and standard metric groups.

Funnel metric groups

Funnel metric groups are for use with funnel optimization experiments. A "funnel" is a marketing model that describes a customer's journey through your purchasing or conversion cycle, typically from the awareness stage to the purchasing stage. LaunchDarkly's funnel optimization experiments use multiple metrics to track the performance of each of the steps in your funnel over time.

The order of metrics within funnel metric groups affects how LaunchDarkly analyzes the metrics. When you create a funnel metric group, each metric should measure a required step in the user journey. Users should not be able to skip any steps the funnel group is measuring, or take any steps out of order. Doing so will skew your experiment results.

You can include only custom conversion/binary, click, and page view metrics in a funnel metric group. You cannot include custom numeric metrics in a funnel metric group.

To learn more, read Creating funnel experiments.

Standard metric groups

Standard metric groups are for use with feature experiments and guarded rollouts. Metrics in standard metric groups can appear in any order. To learn more, read Creating feature change experiments and Release Guardian.

You can also use the REST API: List metric groups

View a metric group

From the Metrics list, click on a metric group name to view its details page. The metric group details page lists all of the metrics in the group.

The "Metric group connections" section includes information on any experiments or flags the metric group is connected to:

A metric group details page.
A metric group details page.

You can also use the REST API: Get metric group

Create a metric group

Before you create a metric group, you must create each metric you want to include within the group. To learn how, read Metrics.

Funnel metric groups cannot include custom numeric metrics

Funnel metric groups can include only custom conversion/binary, click, and page view metrics.

To create a metric group:

  1. Navigate to the Metrics list, which includes both metrics and metric groups.
  2. Click Create.
  3. Select Create metric group. The "Create metric group" dialog appears.
  4. Enter a Name.
  5. (Optional) Enter a Description.
  6. (Optional) Update the Maintainer.
  7. Select either a "Standard" or a "Funnel" Metric group.
  8. (Optional) If you are creating a funnel metric group, enter the first Step name. If you are creating a standard metric group, you do not need to name the steps.
  9. Choose a metric from the Metric menu.
  10. Add a second Step name (optional) and Metric.
  11. (Optional) Click Add metric for each additional metric in your group.
  12. (Optional) For funnel metric groups, drag and drop the steps up or down to reorder them as needed.
  13. Click Create metric group.

You can also use the REST API: Create metric group

Edit a metric group

You can update an existing metric group's name, description, maintainer, metrics, and, for funnel metric groups, step order.

Click the pencil edit icon next to a metric group's name, maintainer, or description to update it.

To edit a metric group's metrics or step order:

  1. Navigate to the Metrics list, which includes both metrics and metric groups.
  2. Click the name of the metric group you want to edit. The metric group details page opens.
  3. Click Edit metric group.
  4. (Optional) Click + Add metric to add additional metrics to the group.
  5. (Optional) Click the - icon next to an individual metric to remove it. You must have at least two metrics in the metric group.
  6. (Optional) For funnel metric groups, click and hold the grab handle (dotted lines) to drag and drop the existing steps into your desired order.
  7. Click Save metric group.

You can also use the REST API: Patch metric group

Delete a metric group

To delete a metric group, navigate to the metric group's details page and click Delete metric group. Deleting a metric group removes it from all of the environments within the project.

You cannot delete a metric group if it is connected to an experiment or a flag.

You can also use the REST API: Delete a metric group