Home | History | Annotate | only in /external/chromium-trace/catapult/netlog_viewer
Up to higher level directory
NameDateSize
bin/06-Dec-2016
netlog_viewer/06-Dec-2016
netlog_viewer_build/06-Dec-2016
netlog_viewer_project.py06-Dec-20162K
OWNERS06-Dec-201640
README.md06-Dec-20162.3K

README.md

      1 A standalone WebApp for viewing chrome://net-export
      2 [NetLog](https://www.chromium.org/developers/design-documents/network-stack/netlog) dump files
      3 ============
      4 
      5 Introduction
      6 ------------
      7 This is a WebApp that allows someone to perform post-mortem analysis of a
      8 saved NetLog dump. The initial code was taken out of Chromium.
      9 The full design doc can be found
     10 [here](https://docs.google.com/document/d/1Ll7T5cguj5m2DqkUTad5DWRCqtbQ3L1q9FRvTN5-Y28/edit#).
     11 
     12 Motivation
     13 ------------
     14 There are a few problems with the current system of logging network events
     15 within Chromium (see chrome://net-internals) that motivated the design and 
     16 creation of this new project:
     17 - Attempting to add new and improved functionalities to network logging within
     18 Chromium comes at the cost of bloating the Chromium binaries.
     19 - The renderer process behind chrome://net-internals is privileged meaning it
     20 can ask the browser process to do more--monitoring networking events in this
     21 case. Generally, privileged UI on Chrome should be minmially complex and
     22 small in size, but a large chunk of chrome://net-internals is neither leaving
     23 behind a rather large attack surface.
     24 - The lack of chrome://net-export on desktop as outlined in an
     25 [issue](https://bugs.chromium.org/p/chromium/issues/detail?id=472706)
     26 
     27 Workflow
     28 --------------
     29 To use this WebApp effectively, the first step is having a NetLog dump to use.
     30 To export a NetLog dump you can capture events and load them into a file
     31 using chrome://net-internals/#export (soon to be chrome://net-export).
     32 
     33 Once you have a log file you can use this WebApp to load it for analysis.
     34 To do that you need to first git clone into the catapult repository:
     35 
     36 git clone https://github.com/catapult-project/catapult.git
     37 
     38 Then go to the directory that contains this WebApp by using the cd command:
     39 
     40 cd path_to_catapult/catapult/netlog_viewer
     41 
     42 Serve the files from an HTTP localhost server with:
     43 
     44 python -m SimpleHTTPServer 8080
     45 
     46 Visit http://localhost:8080/index.html in your web browser to view the
     47 netlog viewer. You will be able to click "Choose File" which will allow you to
     48 select the file you exported earlier. From there your NetLog dump will appear
     49 as a table filled with all the dump's information. Visit the other tabs to
     50 view additional information! There are seven tabs that are currently fully
     51 functional (Import, Events, Proxy, Timeline, DNS, Sockets, Cache).
     52