Knowledge Base Administration Guide

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.

FieldDescriptionReqExample
changelist_path(advanced: only used with integrate regressions)
→ see Commit Changelists for more details
"/path/to/changelist-abc.tsv"
commandCommand which launched the regression"bin/flow tests/flow/selftest.flow.py -m10 -x4 BOOST=100 GRID=alpha"
componentComponent of the regression"alpha_cpu_icache"
custom_metadataRegression metadata array
see Custom Metadata for more details
[["Line coverage", "99.9"], ["func", "87.41"]]
dirPath where the regression was run"/proj1/mnt/uk12/daily4"
groupRegression Group (if using sub-regressions)"smoke/1002"
hostHost (machine) where the regression was launched"compute-100"
integrateWhether 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_branchModel branch of the regression"master"
model_timestampTimestamp of the regression model (ie timestamp when the model_version was committed to its repository)"2020-02-05T14:57:35-06:00"
model_versionModel version of the regression (aka SHA or changelist)"abcd123" (Git SHA)
"11024" (Subversion, Perforce)
nameUnique name of the regression"nightly_ls/100"
pendingtrue marks the regression as LIVE (still running)false (aka finished)
true (regression is still running)
projectProject name (parent of the component)"alpha"
queueQueue (grid) where the regression ran"tx"
runningNumber of jobs currently running on the grid (as opposed to number queued)9
starttimeTimestamp when the regression was launched"2020-02-05T15:01:02-06:00"
submittedNumber of jobs to be launched in this regression (used to show completion progress)1000
tagRegression tag/status/comment(optional) "killed"
time_limit_hoursLive Regression duration time limit, in hours (floating point).
- If not set, this uses the global autotimeouthours value.
12.5time limit, in hours
0 → use the global autotimeouthours value
tool_versionVersion (or checkin ID) of scripting tool used on this regression"1.11.13" or "abc123f"
useridUser which launched the regression"pdq" or "jenkins"
warningCustom warning string to display in the GUI for this regression (for example, if a run was killed)"Terminated" or "Merge Fail"