Regression Field Reference
Simscope Regressions are defined with a JSON input format.
Note the JSON fields can be in any order.
Fields with a ✅ are required fields.
Field | Description | Req | Example |
---|---|---|---|
changelist_path | (advanced: only used with integrate regressions) → see Commit Changelists for more details | "/path/to/changelist-abc.tsv" | |
command | Command which launched the regression | ✅ | "bin/flow tests/flow/selftest.flow.py -m10 -x4 BOOST=100 GRID=alpha" |
component | Component of the regression | ✅ | "alpha_cpu_icache" |
custom_metadata | Regression metadata array → see Custom Metadata for more details | [["Line coverage", "99.9"], ["func", "87.41"]] | |
dir | Path where the regression was run | "/proj1/mnt/uk12/daily4" | |
group | Regression Group (if using sub-regressions) | "smoke/1002" | |
host | Host (machine) where the regression was launched | "compute-100" | |
integrate | Whether this is an integrate regression. (This indicates whether the model_version this regression is running on has been integrated to your main branch.)→ see Commit vs Integrate | false (private/non-integrated model)true (integrated model) | |
model_branch | Model branch of the regression | ✅ | "master" |
model_timestamp | Timestamp of the regression model (ie timestamp when the model_version was committed to its repository) | ✅ | "2020-02-05T14:57:35-06:00" |
model_version | Model version of the regression (aka SHA or changelist) | ✅ | "abcd123" (Git SHA)"11024" (Subversion, Perforce) |
name | Unique name of the regression | ✅ | "nightly_ls/100" |
pending | true marks the regression as LIVE (still running) | false (aka finished)true (regression is still running) | |
project | Project name (parent of the component) | ✅ | "alpha" |
queue | Queue (grid) where the regression ran | "tx" | |
running | Number of jobs currently running on the grid (as opposed to number queued) | 9 | |
starttime | Timestamp when the regression was launched | "2020-02-05T15:01:02-06:00" | |
submitted | Number of jobs to be launched in this regression (used to show completion progress) | 1000 | |
tag | Regression tag/status/comment | (optional) "killed" | |
time_limit_hours | Regression duration time limit, in hours (floating point). - If not set, this uses the global autotimeouthours value. | 1.5 or 200 (hours)0 uses the global autotimeouthours value | |
tool_version | Version (or checkin ID) of scripting tool used on this regression | "1.11.13" or "abc123f" | |
userid | User which launched the regression | ✅ | "pdq" or "jenkins" |
warning | Custom warning string to display in the GUI for this regression (for example, if a run was killed) | "Terminated" or "Merge Fail" |