README.md
1 This folder contains tools to be used in the testing lab.
2
3 NOTE: The config.json file in this folder contains random values - for the full
4 config file, look at the corresponding folder in google3
5
6 Python dependencies:
7 - subprocess32
8 - shellescape
9 - psutil
10 - IPy
11
12 Metrics that can be gathered, listed by name of file and then key to response
13 dict:
14
15 * adb_hash:
16 env: whether $ADB_VENDOR_KEYS is set (bool)
17 hash: hash of keys in $ADB_VENDOR_KEYS (string)
18 * cpu:
19 cpu: list of CPU core percents (float)
20 * disk:
21 total: total space in 1k blocks (int)
22 used: total used in 1k blocks (int)
23 avail: total available in 1k blocks (int)
24 percent_used: percentage space used (0-100) (int)
25 * name:
26 name: system's hostname(string)
27 * network:
28 connected: whether the network is connected (list of bools)
29 * num_users:
30 num_users: number of users (int)
31 * process_time:
32 adb_processes, fastboot_processes: a list of (PID, serialnumber)
33 tuples
34 num_adb_processes, num_fastboot_processes: the number of tuples
35 in the previous lists
36 * ram:
37 total: total physical RAM available in KB (int)
38 used: total RAM used by system in KB (int)
39 free: total RAM free for new process in KB (int)
40 buffers: total RAM buffered by different applications in KB
41 cached: total RAM for caching of data in KB
42 * read:
43 cached_read_rate: cached reads in MB/sec (float)
44 buffered_read_rate: buffered disk reads in MB/sec (float)
45 * system_load:
46 load_avg_1_min: system load average for past 1 min (float)
47 load_avg_5_min: system load average for past 5 min (float)
48 load_avg_15_min: system load average for past 15 min (float)
49 * time:
50 date_time: system date and time (string)
51 * time_sync:
52 is_synchronized: whether NTP synchronized (bool)
53 * uptime:
54 time_seconds: uptime in seconds (float)
55 * usb:
56 devices: a list of Device objects, each with name of device, number of bytes
57 transferred, and the usb bus number/device id.
58 * verify:
59 unauthorized: list of phone sn's that are unauthorized
60 offline: list of phone sn's that are offline
61 recovery: list of phone sn's that are in recovery mode
62 question: list of phone sn's in ??? mode
63 device: list of phone sn's that are in device mode
64 total: total number of offline, recovery, question or unauthorized devices
65 * version:
66 fastboot_version: which version of fastboot (string)
67 adb_version: which version of adb (string)
68 python_version: which version of python (string)
69 kernel_version: which version of kernel (string)
70 * zombie:
71 adb_zombies, fastboot_zombies, other_zombies: lists of
72 (PID, serial number) tuples
73 num_adb_zombies, num_fastboot_zombies, num_other_zombies: int
74