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 which can be collected
+    // through archive generated with dumpLogs() call.
+    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);
+    // Dump all system and captured events into a .tar.gz file.
+    // The archive file will contain following top level directories:
+    //   /var/log/
+    //       ChromeOS system logs.
+    //   /home/chronos/user/log/
+    //       Session specific logs (chrome app logs).
+    //   /home/chronos/user/log/apps/<app_id>
+    //       Contains webapp specific logs including those collected with
+    //       startEventRecorder(..., sink="file") call.
+    static void dumpLogs(DumpLogsCallback callback);
   };
 
   interface Events {
-    static void onAddNetInternalsEntries(object[] entries);
+    // Receives events of type which is currently being captured.
+    static void onCapturedEvents(object[] entries);
   };
 };