Slow Reports - Embed Metadata in Traces

content/public/browser/background_tracing_manager.h

 // Copyright 2015 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 CONTENT_PUBLIC_BROWSER_BACKGROUND_TRACING_MANAGER_H_
 #define CONTENT_PUBLIC_BROWSER_BACKGROUND_TRACING_MANAGER_H_
 
 #include "base/trace_event/trace_event_impl.h"
 #include "base/values.h"
 #include "content/common/content_export.h"
 
 namespace content {
 struct BackgroundTracingConfig;
 struct BackgroundTracingUploadConfig;
 
 // BackgroundTracingManager is used on the browser process to trigger the
 // collection of trace data and upload the results. Only the browser UI thread
 // is allowed to interact with the BackgroundTracingManager. All callbacks are
 // called on the UI thread.
 class BackgroundTracingManager {
  public:
   CONTENT_EXPORT static BackgroundTracingManager* GetInstance();
 
   // ReceiveCallback will will be called on the UI thread every time the
   // BackgroundTracingManager finalizes a trace. The first parameter of
-  // this callback is the trace data. The second is a callback to
+  // this callback is the trace data. The second is metadata that was
+  // generated and embedded into the trace. The third is a callback to
   // notify the BackgroundTracingManager that you've finished processing
   // the trace data.
   //
   // Example:
   //
-  // void Upload(const base::RefCountedString* data,
+  // void Upload(const scoped_refptr<base::RefCountedString>& data,
+  //             scoped_ptr<base::DictionaryValue>,
   //             base::Closure done_callback) {
   //   BrowserThread::PostTaskAndReply(
   //       BrowserThread::FILE,
   //       FROM_HERE,
   //       base::Bind(&DoUploadOnFileThread, data),
   //       done_callback
   //     );
   // }
   //
   typedef base::Callback<void(const scoped_refptr<base::RefCountedString>&,
+                              scoped_ptr<base::DictionaryValue>,
                               base::Closure)> ReceiveCallback;
 
   // Set the triggering rules for when to start recording.
   //
   // In preemptive mode, recording begins immediately and any calls to
   // TriggerNamedEvent() will potentially trigger the trace to finalize and get
   // uploaded to the specified upload_sink. Once the trace has been uploaded,
   // tracing will be enabled again.
   //
   // In reactive mode, recording begins when TriggerNamedEvent() is called, and
@@ skipping 39 matching lines @@
       const base::Closure& callback) = 0;
   virtual void FireTimerForTesting() = 0;
 
  protected:
   virtual ~BackgroundTracingManager() {}
 };
 
 }  // namespace content
 
 #endif  // CONTENT_PUBLIC_BROWSER_BACKGROUND_TRACING_MANAGER_H_