blob: 3b7bad994c95616b01067a6d927ba37ec10a6353 [file] [log] [blame]
// 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.
#include <string>
#include "base/callback.h"
#include "base/macros.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 {
// 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).
typedef base::Callback<void(int, int, bool)> UploadCallback;
// Possible service types. This should correspond to a type from
// DataUseUserData.
enum MetricServiceType {
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