| OLD | NEW | 
|---|
|  | (Empty) | 
| 1 // Copyright 2014 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 CHROME_BROWSER_METRICS_METRICS_STATE_MANAGER_H_ |  | 
| 6 #define CHROME_BROWSER_METRICS_METRICS_STATE_MANAGER_H_ |  | 
| 7 |  | 
| 8 #include <string> |  | 
| 9 |  | 
| 10 #include "base/basictypes.h" |  | 
| 11 #include "base/callback.h" |  | 
| 12 #include "base/gtest_prod_util.h" |  | 
| 13 #include "base/memory/scoped_ptr.h" |  | 
| 14 #include "base/metrics/field_trial.h" |  | 
| 15 |  | 
| 16 class PrefService; |  | 
| 17 class PrefRegistrySimple; |  | 
| 18 |  | 
| 19 namespace metrics { |  | 
| 20 |  | 
| 21 class ClonedInstallDetector; |  | 
| 22 |  | 
| 23 // Responsible for managing MetricsService state prefs, specifically the UMA |  | 
| 24 // client id and low entropy source. Code outside the metrics directory should |  | 
| 25 // not be instantiating or using this class directly. |  | 
| 26 class MetricsStateManager { |  | 
| 27  public: |  | 
| 28   virtual ~MetricsStateManager(); |  | 
| 29 |  | 
| 30   // Returns true if the user opted in to sending metric reports. |  | 
| 31   bool IsMetricsReportingEnabled(); |  | 
| 32 |  | 
| 33   // Returns the client ID for this client, or the empty string if the user is |  | 
| 34   // not opted in to metrics reporting. |  | 
| 35   const std::string& client_id() const { return client_id_; } |  | 
| 36 |  | 
| 37   // Forces the client ID to be generated. This is useful in case it's needed |  | 
| 38   // before recording. |  | 
| 39   void ForceClientIdCreation(); |  | 
| 40 |  | 
| 41   // Checks if this install was cloned or imaged from another machine. If a |  | 
| 42   // clone is detected, resets the client id and low entropy source. This |  | 
| 43   // should not be called more than once. |  | 
| 44   void CheckForClonedInstall( |  | 
| 45       scoped_refptr<base::SingleThreadTaskRunner> task_runner); |  | 
| 46 |  | 
| 47   // Returns the preferred entropy provider used to seed persistent activities |  | 
| 48   // based on whether or not metrics reporting is permitted on this client. |  | 
| 49   // |  | 
| 50   // If metrics reporting is enabled, this method returns an entropy provider |  | 
| 51   // that has a high source of entropy, partially based on the client ID. |  | 
| 52   // Otherwise, it returns an entropy provider that is based on a low entropy |  | 
| 53   // source. |  | 
| 54   scoped_ptr<const base::FieldTrial::EntropyProvider> CreateEntropyProvider(); |  | 
| 55 |  | 
| 56   // Creates the MetricsStateManager, enforcing that only a single instance |  | 
| 57   // of the class exists at a time. Returns NULL if an instance exists already. |  | 
| 58   static scoped_ptr<MetricsStateManager> Create( |  | 
| 59       PrefService* local_state, |  | 
| 60       const base::Callback<bool(void)>& is_reporting_enabled_callback); |  | 
| 61 |  | 
| 62   // Registers local state prefs used by this class. |  | 
| 63   static void RegisterPrefs(PrefRegistrySimple* registry); |  | 
| 64 |  | 
| 65  private: |  | 
| 66   FRIEND_TEST_ALL_PREFIXES(MetricsStateManagerTest, EntropySourceUsed_Low); |  | 
| 67   FRIEND_TEST_ALL_PREFIXES(MetricsStateManagerTest, EntropySourceUsed_High); |  | 
| 68   FRIEND_TEST_ALL_PREFIXES(MetricsStateManagerTest, LowEntropySource0NotReset); |  | 
| 69   FRIEND_TEST_ALL_PREFIXES(MetricsStateManagerTest, |  | 
| 70                            PermutedEntropyCacheClearedWhenLowEntropyReset); |  | 
| 71   FRIEND_TEST_ALL_PREFIXES(MetricsStateManagerTest, ResetMetricsIDs); |  | 
| 72 |  | 
| 73   // Designates which entropy source was returned from this class. |  | 
| 74   // This is used for testing to validate that we return the correct source |  | 
| 75   // depending on the state of the service. |  | 
| 76   enum EntropySourceType { |  | 
| 77     ENTROPY_SOURCE_NONE, |  | 
| 78     ENTROPY_SOURCE_LOW, |  | 
| 79     ENTROPY_SOURCE_HIGH, |  | 
| 80   }; |  | 
| 81 |  | 
| 82   // Creates the MetricsStateManager with the given |local_state|. Calls |  | 
| 83   // |is_reporting_enabled_callback| to query whether metrics reporting is |  | 
| 84   // enabled. Clients should instead use Create(), which enforces a single |  | 
| 85   // instance of this class is alive at any given time. |  | 
| 86   MetricsStateManager( |  | 
| 87       PrefService* local_state, |  | 
| 88       const base::Callback<bool(void)>& is_reporting_enabled_callback); |  | 
| 89 |  | 
| 90   // Returns the low entropy source for this client. This is a random value |  | 
| 91   // that is non-identifying amongst browser clients. This method will |  | 
| 92   // generate the entropy source value if it has not been called before. |  | 
| 93   int GetLowEntropySource(); |  | 
| 94 |  | 
| 95   // Returns the first entropy source that was returned by this service since |  | 
| 96   // start up, or NONE if neither was returned yet. This is exposed for testing |  | 
| 97   // only. |  | 
| 98   EntropySourceType entropy_source_returned() const { |  | 
| 99     return entropy_source_returned_; |  | 
| 100   } |  | 
| 101 |  | 
| 102   // Reset the client id and low entropy source if the kMetricsResetMetricIDs |  | 
| 103   // pref is true. |  | 
| 104   void ResetMetricsIDsIfNecessary(); |  | 
| 105 |  | 
| 106   // Whether an instance of this class exists. Used to enforce that there aren't |  | 
| 107   // multiple instances of this class at a given time. |  | 
| 108   static bool instance_exists_; |  | 
| 109 |  | 
| 110   // Weak pointer to the local state prefs store. |  | 
| 111   PrefService* const local_state_; |  | 
| 112 |  | 
| 113   const base::Callback<bool(void)> is_reporting_enabled_callback_; |  | 
| 114 |  | 
| 115   // The identifier that's sent to the server with the log reports. |  | 
| 116   std::string client_id_; |  | 
| 117 |  | 
| 118   // The non-identifying low entropy source value. |  | 
| 119   int low_entropy_source_; |  | 
| 120 |  | 
| 121   // The last entropy source returned by this service, used for testing. |  | 
| 122   EntropySourceType entropy_source_returned_; |  | 
| 123 |  | 
| 124   scoped_ptr<ClonedInstallDetector> cloned_install_detector_; |  | 
| 125 |  | 
| 126   DISALLOW_COPY_AND_ASSIGN(MetricsStateManager); |  | 
| 127 }; |  | 
| 128 |  | 
| 129 }  // namespace metrics |  | 
| 130 |  | 
| 131 #endif  // CHROME_BROWSER_METRICS_METRICS_STATE_MANAGER_H_ |  | 
| OLD | NEW | 
|---|