Baseline Generation
#
IntroductionThis tool is to generate a baseline json file based on the raw benchmark results of multiple machines.
#
UsageInstall SuperBench on the local machine.
Prepare the raw data and rule files on the local machine.
Generate the baseline file automatically using
sb result generate-baseline
command. The detailed command can be found from SuperBench CLI.sb result generate-baseline --data-file ./results-summary.jsonl --summary-rule-file ./summary-rule.yaml --diagnosis-rule-file ./diagnosis-rule.yaml --output-dir ${output-dir}
Find the output result file named 'baseline.json' under ${output_dir}.
#
InputThe input includes 4 files:
- Raw Data: jsonl file including multiple nodes' results automatically generated by SuperBench runner.
Tips
Raw data file can be found at ${output-dir}/results-summary.jsonl after each successful run.
Summary Rule File: It uses YAML format and defines how to generate the result summary including how to classify the metrics and what statistical methods (P50, mean, etc.) are applied.
Diagnosis Rule File(optional): It uses YAML format and includes each metrics' rules to filter defective machines for diagnosis, and will not filter machines if not specified.
Previous Baseline File(optional): It is baseline file in json format that got from previous run and plan to merge into the latest baseline.
#
Rule FileSummary Rule File is the same with rule file defined in Result Summary
Diagnosis Rule File is the same with rule file defined in Data Diagnosis
#
OutputThe baseline file (baseline.json) from multiple machines will be generated under ${output_dir}.