Additional methods for chrome.logPrivate API

chrome/common/extensions/api/log_private.idl

 // Copyright 2013 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.
 
 // Use chrome.logPrivate API to retrieve log information from multiple
 // resources in a consistent format.
 namespace logPrivate {
 
   // A filter class that filters log entries by different fields
   dictionary Filter {
@@ skipping 28 matching lines @@
   // The class that is returned to callback function.
   dictionary Result {
     // The filter specified to filter log result.
     Filter filter;
     // Log entries returned based on the filter.
     LogEntry[] data;
   };
 
   callback GetHistoricalCallback = void (Result res);
 
+  callback DumpLogsCallback = void ([instanceOf=FileEntry] object logs);
+
+  callback CompletionCallback = void ();
+
+  // The type of the events to be recorded.
+  enum EventType { network };
+
+  // The type of the event sink where captured events will be sent.
+  enum EventSink {
+    // Events will be sent to the webapp via onCapturedEvents. 
+    capture,
+    // Events will be sent to a log file.

[not at google - send to devlin, 2014/07/18 22:45:09]

mention that they are written when dumpLogs is called.

[zel, 2014/07/22 01:26:35]

Done.

[zel, 2014/07/22 01:26:35]

Done.

+    file
+  };
+
   interface Functions {
     // Get the existing logs from ChromeOS system.
     static void getHistorical(Filter filter, GetHistoricalCallback callback);
-    static void startNetInternalsWatch();
-    static void stopNetInternalsWatch();
+    // Start capturing events of specific type.
+    static void startEventRecorder(EventType eventType, EventSink sink, CompletionCallback callback);
+    // Stop  capturing events of specific type.
+    static void stopEventRecorder(EventType eventType, CompletionCallback callback);

[not at google - send to devlin, 2014/07/18 22:45:09]

keep these to < 80 chars.

[zel, 2014/07/22 01:26:35]

Done.

+    // Dump all system and captured events into a .tar.gz file.
+    static void dumpLogs(DumpLogsCallback callback);

[not at google - send to devlin, 2014/07/18 22:45:09]

mention the structure of the tar

[zel, 2014/07/22 01:26:35]

Done.

   };
 
   interface Events {
-    static void onAddNetInternalsEntries(object[] entries);
+    // Receives events of type which is currently being captured.
+    static void onCapturedEvents(object[] entries);
   };
 };