base/metrics/histogram_snapshot_manager.h

   1 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 #ifndef BASE_METRICS_HISTOGRAM_SNAPSHOT_MANAGER_H_
   6 #define BASE_METRICS_HISTOGRAM_SNAPSHOT_MANAGER_H_
   7
   8 #include <map>
   9 #include <string>
  10
  11 #include "base/basictypes.h"
  12 #include "base/metrics/histogram.h"
  13
  14 namespace base {
  15
  16 class HistogramSamples;
  17 class HistogramFlattener;
  18
  19 // HistogramSnapshotManager handles the logistics of gathering up available
  20 // histograms for recording either to disk or for transmission (such as from
  21 // renderer to browser, or from browser to UMA upload). Since histograms can sit
  22 // in memory for an extended period of time, and are vulnerable to memory
  23 // corruption, this class also validates as much rendundancy as it can before
  24 // calling for the marginal change (a.k.a., delta) in a histogram to be
  25 // recorded.
  26 class BASE_EXPORT HistogramSnapshotManager {
  27  public:
  28   explicit HistogramSnapshotManager(HistogramFlattener* histogram_flattener);
  29   virtual ~HistogramSnapshotManager();
  30
  31   // Snapshot all histograms, and ask |histogram_flattener_| to record the
  32   // delta. The arguments allow selecting only a subset of histograms for
  33   // recording, or to set a flag in each recorded histogram.
  34   void PrepareDeltas(Histogram::Flags flags_to_set, bool record_only_uma);
  35
  36  private:
  37   // Snapshot this histogram, and record the delta.
  38   void PrepareDelta(const Histogram& histogram);
  39
  40   // Try to detect and fix count inconsistency of logged samples.
  41   void InspectLoggedSamplesInconsistency(
  42       const HistogramSamples& new_snapshot,
  43       HistogramSamples* logged_samples);
  44
  45   // For histograms, track what we've already recorded (as a sample for
  46   // each histogram) so that we can record only the delta with the next log.
  47   std::map<std::string, HistogramSamples*> logged_samples_;
  48
  49   // List of histograms found to be corrupt, and their problems.
  50   std::map<std::string, int> inconsistencies_;
  51
  52   // |histogram_flattener_| handles the logistics of recording the histogram
  53   // deltas.
  54   HistogramFlattener* histogram_flattener_;  // Weak.
  55
  56   DISALLOW_COPY_AND_ASSIGN(HistogramSnapshotManager);
  57 };
  58
  59 }  // namespace base
  60
  61 #endif  // BASE_METRICS_HISTOGRAM_SNAPSHOT_MANAGER_H_