1# bootstat #
2
3The bootstat command records boot events (e.g., `firmware_loaded`,
4`boot_complete`) and the relative time at which these events occurred. The
5command also aggregates boot event metrics locally and logs the metrics for
6analysis.
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
19The timestamp recorded by bootstat is the uptime of the system, i.e., the
20number of seconds since the system booted.
21
22## Recording boot events ##
23
24To record the relative time of an event during the boot phase, call `bootstat`
25with the `-r` option and the name of the boot event.
26
27    $ bootstat -r boot_complete
28
29The relative time at which the command runs is recorded along with the name of
30the boot event to be persisted.
31
32## Logging boot events ##
33
34To log the persisted boot events, call `bootstat` with the `-l` option.
35
36    $ bootstat -l
37
38bootstat logs all boot events recorded using the `-r` option to the EventLog
39using the Tron histogram. These logs may be uploaded by interested parties
40for aggregation and analysis of boot time across different devices and
41versions.
42
43## Printing boot events ##
44
45To 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