Skip to main content

Archiving and Deleting Metrics

Statsig offers two ways to manage the end-of-life for your metrics.

  • Archiving a metric: the metric will no longer be computed, but its history will be retained for your record. Use this for when a metric is no longer relevant, but you still wish to maintain the history of it. Use case example: you can archive older versions of a metric that continues to evolve so you have a record of how the metric has evolved over time.
  • Deleting a metric: the metric will be removed from Statsig completely, including its history. Use this for when you've made a mistake, logged or imported an irrelevant metric, or created a more accurate version of a metric. Use case examples include incorrect definition, incorrect name, duplicate metric that you don't want to confuse others with.

Archiving Metrics

Archiving a Metric​

There are two ways to archive a metric: 1) In your Metric Catalog, select the metric(s) you want to archive to see a toolbar of options appear to Archive, Compare, or Tag. Select the Archive icon. Bulk Archive

2) In the Metrics Detail View page, select the "..." in the upper right-hand corner, and select Archive. Archive

Once you select Archive, Statsig will check if this metric is used in any feature gates, experiments, or other metrics. archive dependencies While feature gate or experiment dependencies will be shown as soft warnings (no action necessary), metric dependencies will require you to remove the dependency first, before proceeding with the archival. This is because archival of a metric stops its computation, and we don't want other dependent metric values impacted by this archival.

Once you have no metric dependencies, you will start a 24-hour grace period during which you'll be able to undo the archival. In the Metrics Detail View page, you will see a new banner appear at the top of the page, indicating the start of the grace period.

After the 24-hour grace period, Statsig will stop computing this metric and the Metric Detail View page will update with a new banner indicating that the metric has been archived, and Metric Value will change to a disabled state to indicate that this metric is archived.

Implications of Archiving a Metric​

As soon as the Archive button is clicked,

  • 24-hour grace period will start
  • Owners of Experiments and Gates using this metric will receive an email notification to be notified of potential impact upstream

After the 24-hour grace period has ended,

  • Archived metrics will no longer be computed (when the 24-hour grace period ends).
  • Archived metrics will not show up in your Metric Catalog search. To access all archived metrics, go to the last page(s) of your Metrics Catalog.
  • Archived metrics will be removed from Pulse, including any time the archived metric has been added to the Scorecard of an experiment or the Monitoring Metrics section of a Feature Gate

Unarchiving a Metric​

If you mistakenly archived a metric you can undo your Archival.

  • During the 24-hour grace period: Click "undo" on the archival banner at the top of the Metrics Detail View page. Since you Unarchived before the grace period ended (when the metric is no longer computed), this will restore the metric to both your Metrics Catalog as well as any experiment results that include the metric.
    Archive Grace Period

  • After the 24-hour grace period: Either a) go to the last few pages of your Metrics Catalog, select the archived metric(s) you want to Unarchive to see a toolbar of options appear, and select the Unarchive icon OR b) in the Metrics Detail View page of an archived metric, select "Unarchive" in the banner indicating metric's archival Archive after grace period

Since the grace period has ended and the metric has stopped being computed already, its calculation will restart from scratch and history will not be restored.

Deleting Metrics

Deleting a Metric​

To delete a metric, go the Metrics Detail View page of a metric you wish to delete, select the "..." in the upper right-hand corner, and select Delete. delete metric

Once you select Delete, Statsig will check if this metric is used in any feature gates, experiments, or other metrics. While feature gate or experiment dependencies will be shown as soft warnings (no action necessary), metric dependencies will require you to remove the dependency first, before proceeding with the deletion, so that other dependent metric values are not impacted by this deletion. dependencies

Once you have no metric dependencies, you will start a 24-hour grace period during which you'll be able to undo the deletion. In the Metrics Detail View page, you will see a new banner appear at the top of the page, indicating the start of the grace period. undo delete

Metric Deletion cannot be undone after the grace period.

Implications of Deleting a Metric​

As soon as Delete button is clicked

  • 24-hour grace period will start
  • Owners of Experiments and Gates using this metric will receive an email notification to be notified of potential impact upstream

After the 24-hour grace period has ended,

  • Deleted metrics and their history will be removed from Statsig, and cannot be restored.
  • Deleted metrics will be removed from Pulse, including any time the deleted metric has been added to the Scorecard of an experiment or the Monitoring Metrics section of a Feature Gate