diff options
Diffstat (limited to 'en/devices/tech/debug/netstats.html')
| -rw-r--r-- | en/devices/tech/debug/netstats.html | 151 |
1 files changed, 0 insertions, 151 deletions
diff --git a/en/devices/tech/debug/netstats.html b/en/devices/tech/debug/netstats.html deleted file mode 100644 index 78ddef02..00000000 --- a/en/devices/tech/debug/netstats.html +++ /dev/null @@ -1,151 +0,0 @@ -<html devsite> - <head> - <title>Viewing Network Usage Data</title> - <meta name="project_path" value="/_project.yaml" /> - <meta name="book_path" value="/_book.yaml" /> - </head> - <body> - <!-- - Copyright 2017 The Android Open Source Project - - Licensed under the Apache License, Version 2.0 (the "License"); - you may not use this file except in compliance with the License. - You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, software - distributed under the License is distributed on an "AS IS" BASIS, - WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - See the License for the specific language governing permissions and - limitations under the License. - --> - - - -<p>Using the command <code>adb shell dumpsys netstats detail</code> provides -network usage statistics collected since the device booted up.</p> - -<h2 id=input>Input</h2> - - -<p>To view network usage statistics, run the following command:</p> - -<pre class="devsite-terminal devsite-click-to-copy"> -adb shell dumpsys netstats detail -</pre> - - -<h2 id=output>Output</h2> - - -<p>The set of information reported varies depending on the version of Android but -consists of several sections: </p> - -<ul> - <li> Active interfaces - <li> Active UID interfaces - <li> Dev statistics - <li> Xt statistics - <li> UID statistics (sometimes also called "Detailed UID statistics") - <li> UID tag statistics -</ul> - -<h3 id=active_interfaces_active_uid_interfaces>Active interfaces/Active UID interfaces</h3> - -<p>Here is sample output for the active interfaces and active UID interfaces -sections:</p> - -<pre class="devsite-click-to-copy"> -Active interfaces: - iface=wlan0 ident=[{type=WIFI, subType=COMBINED, networkId="GoogleGuest"}] -Active UID interfaces: - iface=wlan0 ident=[{type=WIFI, subType=COMBINED, networkId="GoogleGuest"}] -</pre> - - -<p>This shows network statistics for the whole device. In most cases, the -information in these two section is the same.</p> - -<h3 id=dev_stats_xt_stats>Dev statistics/Xt statistics</h3> - - -<p>Here is sample output for the Dev statistics section:</p> - -<pre class="devsite-click-to-copy"> -Dev stats: - Pending bytes: 170775 - Complete history: - ident=[[type=MOBILE_HIPRI, subType=COMBINED, subscriberId=311111...]] uid=-1 set=ALL tag=0x0 - NetworkStatsHistory: bucketDuration=3600000 - bucketStart=1406138400000 activeTime=3603995 rxBytes=19467 rxPackets=53 txBytes=7500 txPackets=61 operations=0 - bucketStart=1406142000000 activeTime=20730 rxBytes=25403 rxPackets=66 txBytes=9140 txPackets=74 operations=0 - bucketStart=1406145600000 activeTime=29161 rxBytes=9263 rxPackets=37 txBytes=5180 txPackets=38 operations=0 - bucketStart=1406149200000 activeTime=9054 rxBytes=12387 rxPackets=31 txBytes=4052 txPackets=35 operations=0 - ident=[[type=WIFI, subType=COMBINED, networkId="MySSID"]] uid=-1 set=ALL tag=0x0 - NetworkStatsHistory: bucketDuration=3600000 - bucketStart=1406138400000 activeTime=4811082 rxBytes=335913292 rxPackets=265144 txBytes=9729261 txPackets=117220 operations=0 - bucketStart=1406142000000 activeTime=3513477 rxBytes=1193606876 rxPackets=956855 txBytes=29450792 txPackets=306634 operations=0 - bucketStart=1406145600000 activeTime=3297986 rxBytes=729381849 rxPackets=586396 txBytes=24247211 txPackets=237438 operations=0 - bucketStart=1406149200000 activeTime=3580941 rxBytes=57168575 rxPackets=51610 txBytes=5291167 txPackets=29260 operations=0 - ident=[[type=WIFI, subType=COMBINED, networkId="MySecondSSID"]] uid=-1 set=ALL tag=0x0 - NetworkStatsHistory: bucketDuration=3600000 -</pre> - -<h3 id=uid_stats>UID stats</h3> - -<pre class="devsite-click-to-copy"> -UID stats: - Pending bytes: 744 - Complete history: - ident=[[type=MOBILE_SUPL, subType=COMBINED, subscriberId=311111...], [type=MOBILE, subType=COMBINED, subscriberId=311111...]] uid=10007 set=DEFAULT tag=0x0 - NetworkStatsHistory: bucketDuration=7200000 - bucketStart=1406167200000 activeTime=7200000 rxBytes=4666 rxPackets=7 txBytes=1597 txPackets=10 operations=0 - ident=[[type=WIFI, subType=COMBINED, networkId="MySSID"]] uid=10007 set=DEFAULT tag=0x0 - NetworkStatsHistory: bucketDuration=7200000 - bucketStart=1406138400000 activeTime=7200000 rxBytes=17086802 rxPackets=15387 txBytes=1214969 txPackets=8036 operations=28 - bucketStart=1406145600000 activeTime=7200000 rxBytes=2396424 rxPackets=2946 txBytes=464372 txPackets=2609 operations=70 - bucketStart=1406152800000 activeTime=7200000 rxBytes=200907 rxPackets=606 txBytes=187418 txPackets=739 operations=0 - bucketStart=1406160000000 activeTime=7200000 rxBytes=826017 rxPackets=1126 txBytes=267342 txPackets=1175 operations=35 -</pre> - - -<h3 id=interpreting_the_results>Interpreting the results</h3> - - -<p>To find the UID for your application, you can run this command: -<code>adb shell dumpsys package <your package name></code>. -Then look for the line labeled <code>userId</code>.</p> - -<p>In our example, suppose we are trying to find network usage for our app -“com.example.myapp”. We would run the following command:</p> - -<pre class="devsite-terminal devsite-click-to-copy"> -adb shell dumpsys package com.example.myapp | grep userId -</pre> -<p>This returns the following output:</p> -<pre class="devsite-click-to-copy"> - userId=10007 gids=[3003, 1028, 1015] -</pre> - -<p>Looking at the dump above, we look for lines that have uid=10007. Two such -lines exist, the first indicating a mobile connection, and the second a Wi-Fi -connection. Underneath each line, the number of bytes and packets sent and -received can be seen, bucketed into two-hour windows. </p> - -<p>A bit more explanation:</p> - -<ul> - <li> <code>set=DEFAULT</code> indicates foreground - network usage, while <code>set=BACKGROUND</code> indicates -background usage. <code>set=ALL</code> implies both. - <li> <code>tag=0x0</code> indicates the socket tag associated with the traffic. - <li> <code>rxBytes</code> and <code>rxPackets</code> represent received bytes and received packets in the -corresponding time interval. - <li> <code>txBytes</code> and <code>txPackets</code> represent sent (transmitted) bytes and sent packets in -the corresponding time interval. -</ul> - - - </body> -</html> |