Commit 67418ea3 authored by Ilya Sherman's avatar Ilya Sherman Committed by Commit Bot

[Docs] Update histogram expiry docs to clarify max expiry date

We strongly discourage histograms that have an expiry date more than 1 year out.

Also, add a link to the design doc for automatic expiry date management for
histograms that we can detect as actively in use.

R=bcwhite@chromium.org

Bug: none
Change-Id: Ifcfcd831c80e047799be49d6c14d21ba4bb4e49f
Reviewed-on: https://chromium-review.googlesource.com/c/chromium/src/+/1935728
Commit-Queue: Ilya Sherman <isherman@chromium.org>
Auto-Submit: Ilya Sherman <isherman@chromium.org>
Reviewed-by: default avatarBrian White <bcwhite@chromium.org>
Cr-Commit-Position: refs/heads/master@{#719455}
parent 27273fd1
...@@ -345,20 +345,27 @@ encouraged and enforced by Chrome metrics team through reviews. ...@@ -345,20 +345,27 @@ encouraged and enforced by Chrome metrics team through reviews.
#### How to choose expiry for histograms #### How to choose expiry for histograms
For new histograms if it is used for launching a project for which the timeline If you are adding a histogram that will be used to evaluate a feature launch,
is known then pick an expiry based on your project timeline. Otherwise, we set an expiry date consistent with the expected feature launch date. Otherwise,
recommend choosing 3-6 months. we recommend choosing 3-6 months.
For already existing histograms here are different scenarios: Here are some guidelines for common scenarios:
* Owner moved to different project - find new owner * If the listed owner moved to different project, find a new owner.
* Owner doesn’t use it, team doesn’t use it - remove * If neither the owner nor the team uses the histogram, remove it.
* Not in use now, but maybe useful in the far future - remove * If the histogram is not in use now, but might be useful in the far future,
* Not in use now, but maybe useful in the near future - pick 3 months or 2 remove it.
milestone ahead * If the histogram is not in use now, but might be useful in the near
* Actively in use now, useful for short term - pick 3-6 month or appropriate future, pick ~3 months or ~2 milestones ahead.
number of milestones ahead * If the histogram is actively in use now and useful for a short term, pick
* Actively in use, seems useful for indefinite time - pick 1 year or more 3-6 month or 2-4 milestones ahead.
* If the histogram is actively in use and seems useful for an indefinite time,
pick 1 year.
We also have a tool that automatically extends expiry dates. The 80% more
frequently accessed histograms are pushed out every Tuesday, to 6 months from
the date of the run. Googlers can view the [design
doc](https://docs.google.com/document/d/1IEAeBF9UnYQMDfyh2gdvE7WlUKsfIXIZUw7qNoU89A4).
### Expired histogram notifier ### Expired histogram notifier
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment