Support saving browser metrics to disk and reading them during next run.

base/metrics/histogram_snapshot_manager.h

 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef BASE_METRICS_HISTOGRAM_SNAPSHOT_MANAGER_H_
 #define BASE_METRICS_HISTOGRAM_SNAPSHOT_MANAGER_H_
 
 #include <stdint.h>
 
 #include <map>
@@ skipping 22 matching lines @@
   virtual ~HistogramSnapshotManager();
 
   // Snapshot all histograms, and ask |histogram_flattener_| to record the
   // delta. |flags_to_set| is used to set flags for each histogram.
   // |required_flags| is used to select histograms to be recorded.
   // Only histograms that have all the flags specified by the argument will be
   // chosen. If all histograms should be recorded, set it to
   // |Histogram::kNoFlags|. Though any "forward" iterator will work, the
   // histograms over which it iterates *must* remain valid until this method
   // returns; the iterator cannot deallocate histograms once it iterates past
-  // them.
+  // them and FinishDeltas() has been called after.  StartDeltas() must be
+  // called before.
+  template <class ForwardHistogramIterator>
+  void PrepareDeltasWithoutStartFinish(ForwardHistogramIterator begin,
+                                       ForwardHistogramIterator end,
+                                       HistogramBase::Flags flags_to_set,
+                                       HistogramBase::Flags required_flags) {
+    for (ForwardHistogramIterator it = begin; it != end; ++it) {
+      (*it)->SetFlags(flags_to_set);
+      if (((*it)->flags() & required_flags) == required_flags)
+        PrepareDelta(*it);
+    }
+  }
+
+  // As above but also calls StartDeltas() and FinishDeltas().
   template <class ForwardHistogramIterator>
   void PrepareDeltas(ForwardHistogramIterator begin,
                      ForwardHistogramIterator end,
                      HistogramBase::Flags flags_to_set,
                      HistogramBase::Flags required_flags) {
     StartDeltas();
-    for (ForwardHistogramIterator it = begin; it != end; ++it) {
-      (*it)->SetFlags(flags_to_set);
-      if (((*it)->flags() & required_flags) == required_flags)
-        PrepareDelta(*it);
-    }
+    PrepareDeltasWithoutStartFinish(begin, end, flags_to_set, required_flags);
     FinishDeltas();
   }
 
   // When the collection is not so simple as can be done using a single
   // iterator, the steps can be performed separately. Call PerpareDelta()
   // as many times as necessary with a single StartDeltas() before and
   // a single FinishDeltas() after. All passed histograms must live
   // until FinishDeltas() completes. PrepareAbsolute() works the same
   // but assumes there were no previous logged values and no future deltas
   // will be created (and thus can work on read-only histograms).
+  // PrepareFinalDelta() works like PrepareDelta() except that it does
+  // not update the previous logged values and can thus be used with
+  // read-only files.
   // Use Prepare*TakingOwnership() if it is desireable to have this class
   // automatically delete the histogram once it is "finished".
   void StartDeltas();
   void PrepareDelta(HistogramBase* histogram);
   void PrepareDeltaTakingOwnership(std::unique_ptr<HistogramBase> histogram);
   void PrepareAbsolute(const HistogramBase* histogram);
   void PrepareAbsoluteTakingOwnership(
       std::unique_ptr<const HistogramBase> histogram);
+  void PrepareFinalDeltaTakingOwnership(
+      std::unique_ptr<const HistogramBase> histogram);
   void FinishDeltas();
 
  private:
   FRIEND_TEST_ALL_PREFIXES(HistogramSnapshotManagerTest, CheckMerge);
 
   // During a snapshot, samples are acquired and aggregated. This structure
   // contains all the information collected for a given histogram. Once a
   // snapshot operation is finished, it is generally emptied except for
   // information that must persist from one report to the next, such as
   // the "inconsistencies".
@@ skipping 38 matching lines @@
   // |histogram_flattener_| handles the logistics of recording the histogram
   // deltas.
   HistogramFlattener* histogram_flattener_;  // Weak.
 
   DISALLOW_COPY_AND_ASSIGN(HistogramSnapshotManager);
 };
 
 }  // namespace base
 
 #endif  // BASE_METRICS_HISTOGRAM_SNAPSHOT_MANAGER_H_