12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152 |
- // Copyright 2014 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 COMPONENTS_METRICS_METRICS_LOG_UPLOADER_H_
- #define COMPONENTS_METRICS_METRICS_LOG_UPLOADER_H_
- #include <string>
- #include "base/callback.h"
- #include "base/strings/string_piece.h"
- namespace metrics {
- class ReportingInfo;
- // MetricsLogUploader is an abstract base class for uploading UMA logs on behalf
- // of MetricsService.
- class MetricsLogUploader {
- public:
- // Type for OnUploadComplete callbacks. These callbacks will receive three
- // parameters: A response code, a net error code, and a boolean specifying
- // if the connection was secure (over HTTPS).
- using UploadCallback = base::RepeatingCallback<void(int, int, bool)>;
- // Possible service types. This should correspond to a type from
- // DataUseUserData.
- enum MetricServiceType {
- UMA,
- UKM,
- };
- virtual ~MetricsLogUploader() {}
- // Uploads a log with the specified |compressed_log_data|, a |log_hash| and
- // |log_signature| for data validation, and |reporting_info|. |log_hash| is
- // expected to be the hex-encoded SHA1 hash of the log data before compression
- // and |log_signature| is expected to be a base64-encoded HMAC-SHA256
- // signature of the log data before compression. When the server receives an
- // upload it recomputes the hash and signature of the upload and compares it
- // to the ones inlcuded in the upload. If there is a missmatched, the upload
- // is flagged. If an Uploader implementation uploads to a server that doesn't
- // do this validation then |log_hash| and |log_signature| can be ignored.
- virtual void UploadLog(const std::string& compressed_log_data,
- const std::string& log_hash,
- const std::string& log_signature,
- const ReportingInfo& reporting_info) = 0;
- };
- } // namespace metrics
- #endif // COMPONENTS_METRICS_METRICS_LOG_UPLOADER_H_
|