From db68067befac5ae2cec8572268f6520922b07138 Mon Sep 17 00:00:00 2001 From: Brian White Date: Wed, 13 Oct 2021 18:27:28 +0000 Subject: [PATCH] Update documentation on histogram expiry. Change-Id: I08bcbf642698a8eaacb278efe97a23c801244af0 Reviewed-on: https://chromium-review.googlesource.com/c/chromium/src/+/3217937 Auto-Submit: Brian White Commit-Queue: Robert Kaplow Reviewed-by: Robert Kaplow Cr-Commit-Position: refs/heads/main@{#931150} --- tools/metrics/histograms/README.md | 15 +++++++++------ 1 file changed, 9 insertions(+), 6 deletions(-) diff --git a/tools/metrics/histograms/README.md b/tools/metrics/histograms/README.md index b933c86c850f42..ffe16f3816a90c 100644 --- a/tools/metrics/histograms/README.md +++ b/tools/metrics/histograms/README.md @@ -413,16 +413,19 @@ Here are some guidelines for common scenarios: * If the histogram is not in use now, but might be useful in the far future, remove it. * If the histogram is not in use now, but might be useful in the near - future, pick ~3 months or ~2 milestones ahead. + future, pick ~3 months (also ~3 milestones) ahead. * If the histogram is actively in use now and is useful in the short term, - pick 3-6 months or 2-4 milestones ahead. + pick 3-6 months (3-6 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). +We also have a tool that automatically extends expiry dates. The most frequently +accessed histograms, currently 99%, have their expirations automatically +extended every Tuesday to 6 months from the date of the run. Googlers can view +the [design +doc](https://docs.google.com/document/d/1IEAeBF9UnYQMDfyh2gdvE7WlUKsfIXIZUw7qNoU89A4) +of the program that does this. The bottom line is: If the histogram is being +checked, it should be extended without developer interaction. #### How to extend an expired histogram {#extending}