Keyval files in Autotest

There are several “keyval” files in the results directory. These take the simple form

key1=value1
key2=value2

Below we describe what information is in which file.

Job level keyval

This file contains high level information about the job such as when it was queued, started, finished, the username of the submitter, and what machines are involved.

Synchronous multi-machine jobs

When running a multi-machine job synchronously, you will end up with multiple “job level” keyval files; at the very least, one upper-level keyval file in the root results directory, and one in each machine subdirectory. In the results database each machine will be interpreted as a separate set of results, with the total job keyval data being composed of data from the “uppermost” of the keyval files (i.e. the single job level keyval in the root dir). The single exception to this is the hostname field - this is taken from the machine directory.

Test level keyval

This file contains the version of the test, and some per-test system information (parsed from the sysinfo dir) so that we can load it up into the database easily.

Results level keyval

This file contains performance information for a test. Maybe something like

throughput=100
latency=12

If we ran multiple iterations of a test, there will be repeteaed keyvals in there, separated by a blank line:

throughput=101
latency=12.9

throughput=100
latency=11.2

throughput=96
latency=13.1