1 # bootstat # 2 3 The bootstat command records boot events (e.g., `firmware_loaded`, 4 `boot_complete`) and the relative time at which these events occurred. The 5 command also aggregates boot event metrics locally and logs the metrics for 6 analysis. 7 8 Usage: bootstat [options] 9 options include: 10 -h, --help Show this help 11 -l, --log Log all metrics to logstorage 12 -p, --print Dump the boot event records to the console 13 -r, --record Record the timestamp of a named boot event 14 --record_boot_reason Record the reason why the device booted 15 --record_time_since_factory_reset Record the time since the device was reset 16 17 ## Relative time ## 18 19 The timestamp recorded by bootstat is the uptime of the system, i.e., the 20 number of seconds since the system booted. 21 22 ## Recording boot events ## 23 24 To record the relative time of an event during the boot phase, call `bootstat` 25 with the `-r` option and the name of the boot event. 26 27 $ bootstat -r boot_complete 28 29 The relative time at which the command runs is recorded along with the name of 30 the boot event to be persisted. 31 32 ## Logging boot events ## 33 34 To log the persisted boot events, call `bootstat` with the `-l` option. 35 36 $ bootstat -l 37 38 bootstat logs all boot events recorded using the `-r` option to the EventLog 39 using the Tron histogram. These logs may be uploaded by interested parties 40 for aggregation and analysis of boot time across different devices and 41 versions. 42 43 ## Printing boot events ## 44 45 To print the set of persisted boot events, call `bootstat` with the `-p` option. 46 47 $ bootstat -p 48 Boot events: 49 ------------ 50 boot_complete 71
