enso-org/enso
1
1
Fork 0
mirror of https://github.com/enso-org/enso.git synced 2024-12-23 04:33:15 +03:00
Code Issues Projects Releases Wiki Activity

Collect stdlib benchmarks results (#7599)

Browse Source
This commit is contained in:
Pavel Marek 2023-09-06 16:30:52 +02:00 committed by GitHub
parent fff1386c6d
commit 50a9b39c24
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
6 changed files with 715 additions and 444 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
.gitignore vendored
View File

@ -69,6 +69,7 @@ node_modules/
*.iml *.iml
.enso-sources* .enso-sources*
.metals .metals
tools/performance/engine-benchmarks/generated_site
############################ ############################
## Rendered Documentation ## ## Rendered Documentation ##

8
tools/performance/engine-benchmarks/README.md
View File

@ -1,8 +1,8 @@
# Engine benchmarks # Engine benchmarks
This directory contains a python script `bench_download.py` for downloading This directory contains a python script `bench_download.py` for downloading
Engine benchmark results from GitHub and `Engine_Benchs` Enso project for Engine and stdlib benchmark results from GitHub, and `Engine_Benchs` Enso
analysing the downloaded data. project for analysing the downloaded data.
Dependencies for `bench_download.py`: Dependencies for `bench_download.py`:
@ -14,7 +14,9 @@ Dependencies for `bench_download.py`:
`sudo apt-get install gh` `sudo apt-get install gh`
Check `bench_download -h` for documentation and usage. Ensure that your Check `bench_download -h` for documentation and usage. Ensure that your
`/usr/bin/env python` links to Python version at least 3.7. `/usr/bin/env python` links to Python version at least 3.7. `bench_download.py`
creates `generated_site` directory with HTML files for visualizing the benchmark
results.
One can also analyze the benchmarks in Enso IDE by running One can also analyze the benchmarks in Enso IDE by running
`bench_download.py --create-csv` and then running `Engine_Benchs` project. The `bench_download.py --create-csv` and then running `Engine_Benchs` project. The

438
tools/performance/engine-benchmarks/bench_download.py
View File

@ -3,16 +3,28 @@
""" """
Script for downloading Engine benchmark results into a single static web page Script for downloading Engine benchmark results into a single static web page
that visualizes all the benchmarks. Without any options, downloads and that visualizes all the benchmarks. Without any options, downloads and
visualizes benchmark data for the last 14 days. visualizes benchmark data for the last 14 days. By default, no data is written
to the disk except for the generated web page, and the data are downloaded
asynchronously.
It downloads the data synchronously and uses a cache directory by default. Set the `--source` parameter to either `engine` or `stdlib`.
It is advised to use `-v|--verbose` option all the time.
The generated website is placed under "generated_site" directory
The default GH artifact retention period is 3 months, which means that all
the artifacts older than 3 months are dropped. If you wish to gather the data
for benchmarks older than 3 months, make sure that the `use_cache` parameter
is set to true, and that the cache directory is populated with older data.
If the script encounters an expired artifact, it prints a warning.
This script is under continuous development, so it is advised to use
`-v|--verbose` option all the time.
It queries only successful benchmark runs. If there are no successful benchmarks It queries only successful benchmark runs. If there are no successful benchmarks
in a given period, no results will be written. in a given period, no results will be written.
The process of the script is roughly as follows: The process of the script is roughly as follows:
- Gather all the benchmark results from GH API into job reports (JobReport dataclass) - Asynchronously gather all the benchmark results from GH API into job reports (JobReport dataclass)
- Use cache if possible to avoid unnecessary GH API queries - Use cache if possible to avoid unnecessary GH API queries
- Transform the gathered results into data for a particular benchmark sorted - Transform the gathered results into data for a particular benchmark sorted
by an appropriate commit timestamp. by an appropriate commit timestamp.
@ -33,9 +45,11 @@ Dependencies for the script:
- Used as a template engine for the HTML. - Used as a template engine for the HTML.
""" """
import asyncio
import json import json
import logging import logging
import logging.config import logging.config
import math
import os import os
import re import re
import shutil import shutil
@ -45,10 +59,13 @@ import tempfile
import zipfile import zipfile
from argparse import ArgumentParser, RawDescriptionHelpFormatter from argparse import ArgumentParser, RawDescriptionHelpFormatter
from csv import DictWriter from csv import DictWriter
from datetime import datetime, timedelta, date from datetime import datetime, timedelta
from enum import Enum
from os import path from os import path
from typing import List, Dict, Optional, Any, Union, Set from typing import List, Dict, Optional, Any, Union, Set
from dataclasses import dataclass from dataclasses import dataclass
import xml.etree.ElementTree as ET
if not (sys.version_info.major >= 3 and sys.version_info.minor >= 7): if not (sys.version_info.major >= 3 and sys.version_info.minor >= 7):
print("ERROR: python version lower than 3.7") print("ERROR: python version lower than 3.7")
@ -58,18 +75,48 @@ try:
import numpy as np import numpy as np
import jinja2 import jinja2
except ModuleNotFoundError as err: except ModuleNotFoundError as err:
print("ERROR: One of pandas, numpy, or jinja2 packages not installed") print("ERROR: One of pandas, numpy, or jinja2 packages not installed", file=sys.stderr)
exit(1) exit(1)
BENCH_RUN_NAME = "Benchmark Engine"
DATE_FORMAT = "%Y-%m-%d" DATE_FORMAT = "%Y-%m-%d"
# Workflod ID of engine benchmarks, got via `gh api '/repos/enso-org/enso/actions/workflows'` ENGINE_BENCH_WORKFLOW_ID = 29450898
BENCH_WORKFLOW_ID = 29450898 """
Workflow ID of engine benchmarks, got via `gh api
'/repos/enso-org/enso/actions/workflows'`.
The name of the workflow is 'Benchmark Engine'
"""
NEW_ENGINE_BENCH_WORKFLOW_ID = 67075764
"""
Workflow ID for 'Benchmark Engine' workflow, which is the new workflow
since 2023-08-22.
"""
STDLIBS_BENCH_WORKFLOW_ID = 66661001
"""
Workflow ID of stdlibs benchmarks, got via `gh api
'/repos/enso-org/enso/actions/workflows'`.
The name is 'Benchmark Standard Libraries'
"""
GH_DATE_FORMAT = "%Y-%m-%dT%H:%M:%SZ" GH_DATE_FORMAT = "%Y-%m-%dT%H:%M:%SZ"
""" Date format as returned from responses in GH API""" """ Date format as returned from responses in GH API"""
ENSO_COMMIT_BASE_URL = "https://github.com/enso-org/enso/commit/" ENSO_COMMIT_BASE_URL = "https://github.com/enso-org/enso/commit/"
JINJA_TEMPLATE = "template_jinja.html" JINJA_TEMPLATE = "templates/template_jinja.html"
""" Path to the Jinja HTML template """ """ Path to the Jinja HTML template """
TEMPLATES_DIR = "templates"
GENERATED_SITE_DIR = "generated_site"
GH_ARTIFACT_RETENTION_PERIOD = timedelta(days=90)
class Source(Enum):
ENGINE = "engine"
STDLIB = "stdlib"
def workflow_ids(self) -> List[int]:
if self == Source.ENGINE:
return [ENGINE_BENCH_WORKFLOW_ID, NEW_ENGINE_BENCH_WORKFLOW_ID]
elif self == Source.STDLIB:
return [STDLIBS_BENCH_WORKFLOW_ID]
else:
raise ValueError(f"Unknown source {self}")
@dataclass @dataclass
@ -155,16 +202,21 @@ class TemplateBenchData:
""" Data for one benchmark label (with a unique name and ID) """ """ Data for one benchmark label (with a unique name and ID) """
id: str id: str
""" ID of the benchmark, must not contain dots """ """ ID of the benchmark, must not contain dots """
name: str
""" Human readable name of the benchmark """
branches_datapoints: Dict[str, List[BenchDatapoint]] branches_datapoints: Dict[str, List[BenchDatapoint]]
""" Mapping of branches to datapoints for that branch """ """ Mapping of branches to datapoints for that branch """
@dataclass @dataclass
class JinjaData: class JinjaData:
bench_source: Source
bench_datas: List[TemplateBenchData] bench_datas: List[TemplateBenchData]
branches: List[str] branches: List[str]
since: datetime since: datetime
until: datetime until: datetime
display_since: datetime
""" The date from which all the datapoints are first displayed """
def _parse_bench_run_from_json(obj: Dict[Any, Any]) -> JobRun: def _parse_bench_run_from_json(obj: Dict[Any, Any]) -> JobRun:
@ -213,24 +265,22 @@ def _bench_report_to_json(bench_report: JobReport) -> Dict[Any, Any]:
} }
def _parse_bench_report_from_xml(bench_report_xml: str, bench_run: JobRun) -> "JobReport": def _parse_bench_report_from_xml(bench_report_xml_path: str, bench_run: JobRun) -> "JobReport":
logging.debug(f"Parsing BenchReport from {bench_report_xml}") logging.debug(f"Parsing BenchReport from {bench_report_xml_path}")
with open(bench_report_xml, "r") as f: tree = ET.parse(bench_report_xml_path)
lines = f.readlines() root = tree.getroot()
label_pattern = re.compile("<label>(?P<label>.+)</label>") label_score_dict: Dict[str, float] = dict()
score_pattern = re.compile("<score>(?P<score>.+)</score>") for cases in root:
label_score_dict = {} assert cases.tag == "cases"
label: Optional[str] = None for case in cases:
for line in lines: assert case.tag == "case"
line = line.strip() label = case.findtext("label").strip()
label_match = label_pattern.match(line) scores = case.find("scores")
score_match = score_pattern.match(line) scores_float = [float(score.text.strip()) for score in scores]
if label_match: if len(scores_float) > 1:
label = label_match.group("label") logging.warning(f"More than one score for benchmark {label}, "
if score_match: f"using the best one (the smallest one).")
score = score_match.group("score") label_score_dict[label] = min(scores_float)
assert label, "label element must be before score element"
label_score_dict[label] = float(score)
return JobReport( return JobReport(
label_score_dict=label_score_dict, label_score_dict=label_score_dict,
bench_run=bench_run bench_run=bench_run
@ -247,7 +297,7 @@ def _read_json(json_file: str) -> Dict[Any, Any]:
return json.load(f) return json.load(f)
def _invoke_gh_api(endpoint: str, async def _invoke_gh_api(endpoint: str,
query_params: Dict[str, str] = {}, query_params: Dict[str, str] = {},
result_as_text: bool = True) -> Union[Dict[str, Any], bytes]: result_as_text: bool = True) -> Union[Dict[str, Any], bytes]:
query_str_list = [key + "=" + value for key, value in query_params.items()] query_str_list = [key + "=" + value for key, value in query_params.items()]
@ -257,18 +307,21 @@ def _invoke_gh_api(endpoint: str,
"api", "api",
f"/repos/enso-org/enso{endpoint}" + ("" if len(query_str) == 0 else "?" + query_str) f"/repos/enso-org/enso{endpoint}" + ("" if len(query_str) == 0 else "?" + query_str)
] ]
logging.info(f"Running subprocess `{' '.join(cmd)}`") logging.info(f"Starting subprocess `{' '.join(cmd)}`")
try: proc = await asyncio.create_subprocess_exec("gh", *cmd[1:],
ret = subprocess.run(cmd, check=True, text=result_as_text, capture_output=True) stdout=subprocess.PIPE,
if result_as_text: stderr=subprocess.PIPE)
return json.loads(ret.stdout) out, err = await proc.communicate()
else: logging.info(f"Finished subprocess `{' '.join(cmd)}`")
return ret.stdout if proc.returncode != 0:
except subprocess.CalledProcessError as err: print("Command `" + " ".join(cmd) + "` FAILED with errcode " + str(
print("Command `" + " ".join(cmd) + "` FAILED with errcode " + str(err.returncode)) proc.returncode))
print(err.stdout) print(err.decode())
print(err.stderr) exit(proc.returncode)
exit(err.returncode) if result_as_text:
return json.loads(out.decode())
else:
return out
class Cache: class Cache:
@ -331,7 +384,7 @@ class FakeCache:
return None return None
def __setitem__(self, key, value): def __setitem__(self, key, value):
raise NotImplementedError() pass
def __contains__(self, item): def __contains__(self, item):
return False return False
@ -340,12 +393,13 @@ class FakeCache:
return 0 return 0
def get_bench_runs(since: datetime, until: datetime, branch: str) -> List[JobRun]: async def get_bench_runs(since: datetime, until: datetime, branch: str, workflow_id: int) -> List[JobRun]:
""" """
Fetches the list of all the job runs from the GH API for the specified `branch`. Fetches the list of all the job runs from the GH API for the specified `branch`.
""" """
logging.info(f"Looking for all successful Engine benchmark workflow run " logging.info(f"Looking for all successful Engine benchmark workflow run "
f"actions from {since} to {until} for branch {branch}") f"actions from {since} to {until} for branch {branch} "
f"and workflow ID {workflow_id}")
query_fields = { query_fields = {
"branch": branch, "branch": branch,
"status": "success", "status": "success",
@ -353,29 +407,36 @@ def get_bench_runs(since: datetime, until: datetime, branch: str) -> List[JobRun
# Start with 1, just to determine the total count # Start with 1, just to determine the total count
"per_page": "1" "per_page": "1"
} }
res = _invoke_gh_api(f"/actions/workflows/{BENCH_WORKFLOW_ID}/runs", query_fields) res = await _invoke_gh_api(f"/actions/workflows/{workflow_id}/runs", query_fields)
total_count = int(res["total_count"]) total_count = int(res["total_count"])
per_page = 30 per_page = 3
logging.debug(f"Total count of all runs: {total_count}, will process {per_page} runs per page") logging.debug(f"Total count of all runs: {total_count} for workflow ID "
f"{workflow_id}. Will process {per_page} runs per page")
query_fields["per_page"] = str(per_page) async def get_and_parse_run(page: int, parsed_bench_runs) -> None:
processed = 0 _query_fields = query_fields.copy()
page = 1 _query_fields["page"] = str(page)
parsed_bench_runs = [] res = await _invoke_gh_api(f"/actions/workflows/{workflow_id}/runs", _query_fields)
while processed < total_count:
logging.debug(f"Processing page {page}, processed={processed}, total_count={total_count}")
query_fields["page"] = str(page)
res = _invoke_gh_api(f"/actions/workflows/{BENCH_WORKFLOW_ID}/runs", query_fields)
bench_runs_json = res["workflow_runs"] bench_runs_json = res["workflow_runs"]
parsed_bench_runs += [_parse_bench_run_from_json(bench_run_json) _parsed_bench_runs = [_parse_bench_run_from_json(bench_run_json)
for bench_run_json in bench_runs_json] for bench_run_json in bench_runs_json]
processed += per_page parsed_bench_runs.extend(_parsed_bench_runs)
page += 1
# Now we know the total count, so we can fetch all the runs
query_fields["per_page"] = str(per_page)
num_queries = math.ceil(total_count / per_page)
parsed_bench_runs = []
tasks = []
# Page is indexed from 1
for page in range(1, num_queries + 1):
tasks.append(get_and_parse_run(page, parsed_bench_runs))
await asyncio.gather(*tasks)
return parsed_bench_runs return parsed_bench_runs
def get_bench_report(bench_run: JobRun, cache: Cache, temp_dir: str) -> Optional[JobReport]: async def get_bench_report(bench_run: JobRun, cache: Cache, temp_dir: str) -> Optional[JobReport]:
""" """
Extracts some data from the given bench_run, which was fetched via the GH API, Extracts some data from the given bench_run, which was fetched via the GH API,
optionally getting it from the cache. optionally getting it from the cache.
@ -389,16 +450,13 @@ def get_bench_report(bench_run: JobRun, cache: Cache, temp_dir: str) -> Optional
logging.info(f"Getting bench run with ID {bench_run.id} from cache") logging.info(f"Getting bench run with ID {bench_run.id} from cache")
return cache[bench_run.id] return cache[bench_run.id]
logging.info(f"Getting bench run with ID {bench_run.id} from GitHub API")
# There might be multiple artifacts in the artifact list for a benchmark run # There might be multiple artifacts in the artifact list for a benchmark run
# We are looking for the one named 'Runtime Benchmark Report', which will # We are looking for the one named 'Runtime Benchmark Report', which will
# be downloaded as a ZIP file. # be downloaded as a ZIP file.
obj = _invoke_gh_api(f"/actions/runs/{bench_run.id}/artifacts") obj: Dict[str, Any] = await _invoke_gh_api(f"/actions/runs/{bench_run.id}/artifacts")
artifacts = obj["artifacts"] artifacts = obj["artifacts"]
bench_report_artifact = None assert len(artifacts) == 1, "There should be exactly one artifact for a benchmark run"
for artifact in artifacts: bench_report_artifact = artifacts[0]
if artifact["name"] == "Runtime Benchmark Report":
bench_report_artifact = artifact
assert bench_report_artifact, "Benchmark Report artifact not found" assert bench_report_artifact, "Benchmark Report artifact not found"
artifact_id = str(bench_report_artifact["id"]) artifact_id = str(bench_report_artifact["id"])
if bench_report_artifact["expired"]: if bench_report_artifact["expired"]:
@ -410,7 +468,7 @@ def get_bench_report(bench_run: JobRun, cache: Cache, temp_dir: str) -> Optional
return None return None
# Get contents of the ZIP artifact file # Get contents of the ZIP artifact file
artifact_ret = _invoke_gh_api(f"/actions/artifacts/{artifact_id}/zip", result_as_text=False) artifact_ret = await _invoke_gh_api(f"/actions/artifacts/{artifact_id}/zip", result_as_text=False)
zip_file_name = os.path.join(temp_dir, artifact_id + ".zip") zip_file_name = os.path.join(temp_dir, artifact_id + ".zip")
logging.debug(f"Writing artifact ZIP content into {zip_file_name}") logging.debug(f"Writing artifact ZIP content into {zip_file_name}")
with open(zip_file_name, "wb") as zip_file: with open(zip_file_name, "wb") as zip_file:
@ -565,6 +623,7 @@ def create_template_data(
logging.debug(f"Template data for benchmark {bench_label} created") logging.debug(f"Template data for benchmark {bench_label} created")
template_bench_datas.append(TemplateBenchData( template_bench_datas.append(TemplateBenchData(
id=_label_to_id(bench_label), id=_label_to_id(bench_label),
name=_label_to_name(bench_label),
branches_datapoints=branch_datapoints, branches_datapoints=branch_datapoints,
)) ))
return template_bench_datas return template_bench_datas
@ -574,6 +633,22 @@ def _label_to_id(label: str) -> str:
return label.replace(".", "_") return label.replace(".", "_")
def _label_to_name(label: str) -> str:
items = label.split(".")
assert len(items) >= 2
filtered_items = \
[item for item in items if item not in (
"org",
"enso",
"benchmark",
"benchmarks",
"semantic",
"interpreter",
"bench"
)]
return "_".join(filtered_items)
def _gather_all_bench_labels(job_reports: List[JobReport]) -> Set[str]: def _gather_all_bench_labels(job_reports: List[JobReport]) -> Set[str]:
""" """
Iterates through all the job reports and gathers all the benchmark labels Iterates through all the job reports and gathers all the benchmark labels
@ -590,89 +665,76 @@ def _gather_all_bench_labels(job_reports: List[JobReport]) -> Set[str]:
def render_html(jinja_data: JinjaData, template_file: str, html_out_fname: str) -> None: def render_html(jinja_data: JinjaData, template_file: str, html_out_fname: str) -> None:
jinja_env = jinja2.Environment(loader=jinja2.FileSystemLoader(".")) jinja_env = jinja2.Environment(loader=jinja2.FileSystemLoader("."))
jinja_template = jinja_env.get_template(template_file) jinja_template = jinja_env.get_template(template_file)
generated_html = jinja_template.render({ generated_html = jinja_template.render(jinja_data.__dict__)
"since": jinja_data.since, if path.exists(html_out_fname):
"until": jinja_data.until, logging.info(f"{html_out_fname} already exist, rewritting")
"bench_datas": jinja_data.bench_datas,
"branches": jinja_data.branches
})
with open(html_out_fname, "w") as html_file: with open(html_out_fname, "w") as html_file:
html_file.write(generated_html) html_file.write(generated_html)
def compare_runs(bench_run_id_1: str, bench_run_id_2: str, cache: Cache, tmp_dir: str) -> None: def ensure_gh_installed() -> None:
def perc_str(perc: float) -> str: try:
s = "+" if perc > 0 else "" out = subprocess.run(["gh", "--version"], check=True, capture_output=True)
s += "{:.5f}".format(perc) if out.returncode != 0:
s += "%" print("`gh` command not found - GH CLI utility is not installed. "
return s "See https://cli.github.com/", file=sys.stderr)
exit(1)
def percent_change(old_val: float, new_val: float) -> float: except subprocess.CalledProcessError:
return ((new_val - old_val) / old_val) * 100 print("`gh` command not found - GH CLI utility is not installed. "
"See https://cli.github.com/", file=sys.stderr)
def commit_to_str(commit: Commit) -> str: exit(1)
return f"{commit.timestamp} {commit.author.name} '{commit.message.splitlines()[0]}'"
res_1 = _invoke_gh_api(f"/actions/runs/{bench_run_id_1}")
bench_run_1 = _parse_bench_run_from_json(res_1)
res_2 = _invoke_gh_api(f"/actions/runs/{bench_run_id_2}")
bench_run_2 = _parse_bench_run_from_json(res_2)
bench_report_1 = get_bench_report(bench_run_1, cache, tmp_dir)
bench_report_2 = get_bench_report(bench_run_2, cache, tmp_dir)
# Check that the runs have the same labels, and get their intersection
bench_labels_1 = set(bench_report_1.label_score_dict.keys())
bench_labels_2 = set(bench_report_2.label_score_dict.keys())
if bench_labels_1 != bench_labels_2:
logging.warning(
f"Benchmark labels are not the same in both runs. This means that "
f"there will be some missing numbers in one of the runs. "
f"The set difference is {bench_labels_1.difference(bench_labels_2)}")
all_labels: List[str] = sorted(
list(bench_labels_1.intersection(bench_labels_2)))
bench_report_2.label_score_dict.keys()
df = pd.DataFrame(columns=["bench_label", "score-run-1", "score-run-2"])
for bench_label in all_labels:
df = pd.concat([df, pd.DataFrame([{
"bench_label": bench_label,
"score-run-1": bench_report_1.label_score_dict[bench_label],
"score-run-2": bench_report_2.label_score_dict[bench_label],
}])], ignore_index=True)
df["score-diff"] = np.diff(df[["score-run-1", "score-run-2"]], axis=1)
df["score-diff-perc"] = df.apply(lambda row: perc_str(
percent_change(row["score-run-1"], row["score-run-2"])),
axis=1)
print("================================")
print(df.to_string(index=False, header=True, justify="center", float_format="%.5f"))
print("================================")
print("Latest commit on bench-run-id-1: ")
print(" " + commit_to_str(bench_run_1.head_commit))
print("Latest commit on bench-run-id-2: ")
print(" " + commit_to_str(bench_run_2.head_commit))
if __name__ == '__main__': async def main():
default_since: date = (datetime.now() - timedelta(days=14)).date() default_since: datetime = (datetime.now() - timedelta(days=14))
default_until: date = datetime.now().date() default_until: datetime = datetime.now()
default_cache_dir = path.expanduser("~/.cache/enso_bench_download") default_cache_dir = path.expanduser("~/.cache/enso_bench_download")
default_csv_out = "Engine_Benchs/data/benchs.csv"
date_format_help = DATE_FORMAT.replace("%", "%%") date_format_help = DATE_FORMAT.replace("%", "%%")
def _parse_bench_source(_bench_source: str) -> Source:
try:
return Source(_bench_source)
except ValueError:
print(f"Invalid benchmark source {_bench_source}.", file=sys.stderr)
print(f"Available sources: {[source.value for source in Source]}", file=sys.stderr)
exit(1)
arg_parser = ArgumentParser(description=__doc__, arg_parser = ArgumentParser(description=__doc__,
formatter_class=RawDescriptionHelpFormatter) formatter_class=RawDescriptionHelpFormatter)
arg_parser.add_argument("-s", "--since", action="store", arg_parser.add_argument("-v", "--verbose", action="store_true")
arg_parser.add_argument("-s", "--source",
action="store",
required=True,
metavar=f"({Source.ENGINE.value}|{Source.STDLIB.value})",
type=lambda s: _parse_bench_source(s),
help=f"The source of the benchmarks. Available sources: "
f"{[source.value for source in Source]}")
arg_parser.add_argument("--since", action="store",
default=default_since, default=default_since,
metavar="SINCE_DATE", metavar="SINCE_DATE",
type=lambda s: datetime.strptime(s, DATE_FORMAT).date(), type=lambda s: datetime.strptime(s, DATE_FORMAT),
help=f"The date from which the benchmark results will be gathered. " help=f"The date from which the benchmark results will be gathered. "
f"Format is {date_format_help}. " f"Format is {date_format_help}. "
f"The default is 14 days before") f"The default is 14 days before")
arg_parser.add_argument("-u", "--until", action="store", arg_parser.add_argument("--until", action="store",
default=default_until, default=default_until,
metavar="UNTIL_DATE", metavar="UNTIL_DATE",
type=lambda s: datetime.strptime(s, DATE_FORMAT).date(), type=lambda s: datetime.strptime(s, DATE_FORMAT),
help=f"The date until which the benchmark results will be gathered. " help=f"The date until which the benchmark results will be gathered. "
f"Format is {date_format_help}. " f"Format is {date_format_help}. "
f"The default is today") f"The default is today")
arg_parser.add_argument("--use-cache",
default=False,
metavar="(true|false)",
type=lambda input: True if input in ("true", "True") else False,
help="Whether the cache directory should be used. The default is False.")
arg_parser.add_argument("-c", "--cache", action="store",
default=default_cache_dir,
metavar="CACHE_DIR",
help=f"Cache directory. Makes sense only iff specified with --use-cache argument. "
f"The default is {default_cache_dir}. If there are any troubles with the "
f"cache, just do `rm -rf {default_cache_dir}`.")
arg_parser.add_argument("-b", "--branches", action="store", arg_parser.add_argument("-b", "--branches", action="store",
nargs="+", nargs="+",
default=["develop"], default=["develop"],
@ -683,38 +745,18 @@ if __name__ == '__main__':
default=set(), default=set(),
help="List of labels to gather the benchmark results from." help="List of labels to gather the benchmark results from."
"The default behavior is to gather all the labels") "The default behavior is to gather all the labels")
arg_parser.add_argument("--compare",
nargs=2,
default=[],
metavar=("<Bench action ID 1>", "<Bench action ID 2>"),
help="Compare two benchmark actions runs. Choose an action from https://github.com/enso-org/enso/actions/workflows/benchmark.yml, "
"and copy its ID from the URL. For example ID 4602465427 from URL https://github.com/enso-org/enso/actions/runs/4602465427. "
"This option excludes --since, --until, --output, and --create-csv options."
" Note: THIS OPTION IS DEPRECATED, use --branches instead")
arg_parser.add_argument("-o", "--output",
default="Engine_Benchs/data/benchs.csv",
metavar="CSV_OUTPUT",
help="Output CSV file. Makes sense only when used with --create-csv argument")
arg_parser.add_argument("-c", "--cache", action="store",
default=default_cache_dir,
metavar="CACHE_DIR",
help=f"Cache directory. Makes sense only iff specified with --use-cache argument. "
f"The default is {default_cache_dir}. If there are any troubles with the "
f"cache, just do `rm -rf {default_cache_dir}`.")
arg_parser.add_argument("-t", "--tmp-dir", action="store", arg_parser.add_argument("-t", "--tmp-dir", action="store",
default=None, default=None,
help="Temporary directory with default created by `tempfile.mkdtemp()`") help="Temporary directory with default created by `tempfile.mkdtemp()`")
arg_parser.add_argument("--use-cache",
default=True,
metavar="(true|false)",
type=lambda input: True if input in ("true", "True") else False,
help="Whether the cache directory should be used. The default is True.")
arg_parser.add_argument("--create-csv", action="store_true", arg_parser.add_argument("--create-csv", action="store_true",
default=False, default=False,
help="Whether an intermediate `benchs.csv` should be created. " help="Whether an intermediate `benchs.csv` should be created. "
"Appropriate to see whether the benchmark downloading was successful. " "Appropriate to see whether the benchmark downloading was successful. "
"Or if you wish to inspect the CSV with Enso") "Or if you wish to inspect the CSV with Enso")
arg_parser.add_argument("-v", "--verbose", action="store_true") arg_parser.add_argument("--csv-output",
default=default_csv_out,
metavar="CSV_OUTPUT",
help="Output CSV file. Makes sense only when used with --create-csv argument")
args = arg_parser.parse_args() args = arg_parser.parse_args()
if args.verbose: if args.verbose:
log_level = logging.DEBUG log_level = logging.DEBUG
@ -731,40 +773,66 @@ if __name__ == '__main__':
temp_dir: str = args.tmp_dir temp_dir: str = args.tmp_dir
use_cache: bool = args.use_cache use_cache: bool = args.use_cache
assert cache_dir and temp_dir assert cache_dir and temp_dir
csv_fname: str = args.output bench_source: Source = args.source
csv_output: str = args.csv_output
create_csv: bool = args.create_csv create_csv: bool = args.create_csv
compare: List[str] = args.compare
branches: List[str] = args.branches branches: List[str] = args.branches
labels_override: Set[str] = args.labels labels_override: Set[str] = args.labels
logging.info(f"parsed args: since={since}, until={until}, cache_dir={cache_dir}, " logging.debug(f"parsed args: since={since}, until={until}, cache_dir={cache_dir}, "
f"temp_dir={temp_dir}, use_cache={use_cache}, output={csv_fname}, " f"temp_dir={temp_dir}, use_cache={use_cache}, bench_source={bench_source}, "
f"create_csv={create_csv}, compare={compare}, branches={branches}, " f"csv_output={csv_output}, "
f"create_csv={create_csv}, branches={branches}, "
f"labels_override={labels_override}") f"labels_override={labels_override}")
ensure_gh_installed()
# If the user requires benchmarks for which artifacts are not retained
# anymore, then cache should be used.
min_since_without_cache = datetime.today() - GH_ARTIFACT_RETENTION_PERIOD
if not use_cache and since < min_since_without_cache:
logging.warning(f"The default GH artifact retention period is "
f"{GH_ARTIFACT_RETENTION_PERIOD.days} days. "
f"This means that all the artifacts older than "
f"{min_since_without_cache.date()} are expired."
f"The use_cache parameter is set to False, so no "
f"expired artifacts will be fetched.")
logging.warning(f"The `since` parameter is reset to "
f"{min_since_without_cache.date()} to prevent "
f"unnecessary GH API queries.")
since = min_since_without_cache
if use_cache: if use_cache:
cache = populate_cache(cache_dir) cache = populate_cache(cache_dir)
else: else:
cache = FakeCache() cache = FakeCache()
if len(compare) > 0:
compare_runs(compare[0], compare[1], cache, temp_dir)
exit(0)
bench_labels: Optional[Set[str]] = None bench_labels: Optional[Set[str]] = None
""" Set of all gathered benchmark labels from all the job reports """ """ Set of all gathered benchmark labels from all the job reports """
job_reports_per_branch: Dict[str, List[JobReport]] = {} job_reports_per_branch: Dict[str, List[JobReport]] = {}
for branch in branches: for branch in branches:
bench_runs = get_bench_runs(since, until, branch) bench_runs: List[JobRun] = []
for workflow_id in bench_source.workflow_ids():
bench_runs.extend(
await get_bench_runs(since, until, branch, workflow_id)
)
if len(bench_runs) == 0: if len(bench_runs) == 0:
print( print(
f"No successful benchmarks found within period since {since}" f"No successful benchmarks found within period since {since}"
f" until {until} for branch {branch}") f" until {until} for branch {branch}")
exit(1) exit(1)
job_reports: List[JobReport] = [] job_reports: List[JobReport] = []
async def _process_report(_bench_run):
_job_report = await get_bench_report(_bench_run, cache, temp_dir)
if _job_report:
job_reports.append(_job_report)
tasks = []
for bench_run in bench_runs: for bench_run in bench_runs:
job_report = get_bench_report(bench_run, cache, temp_dir) tasks.append(_process_report(bench_run))
if job_report: await asyncio.gather(*tasks)
job_reports.append(job_report)
logging.debug(f"Got {len(job_reports)} job reports for branch {branch}") logging.debug(f"Got {len(job_reports)} job reports for branch {branch}")
if len(job_reports) == 0: if len(job_reports) == 0:
print(f"There were 0 job_reports in the specified time interval, " print(f"There were 0 job_reports in the specified time interval, "
@ -774,20 +842,18 @@ if __name__ == '__main__':
logging.debug("Sorting job_reports by commit date") logging.debug("Sorting job_reports by commit date")
def _get_timestamp(job_report: JobReport) -> datetime:
def get_timestamp(job_report: JobReport) -> datetime:
return datetime.strptime( return datetime.strptime(
job_report.bench_run.head_commit.timestamp, job_report.bench_run.head_commit.timestamp,
GH_DATE_FORMAT GH_DATE_FORMAT
) )
job_reports.sort(key=lambda report: _get_timestamp(report))
job_reports.sort(key=lambda report: get_timestamp(report))
if create_csv: if create_csv:
write_bench_reports_to_csv(job_reports, csv_fname) write_bench_reports_to_csv(job_reports, csv_output)
logging.info(f"Benchmarks written to {csv_fname}") logging.info(f"Benchmarks written to {csv_output}")
print(f"The generated CSV is in {csv_fname}") print(f"The generated CSV is in {csv_output}")
exit(0) exit(0)
# Gather all the benchmark labels from all the job reports # Gather all the benchmark labels from all the job reports
@ -812,14 +878,34 @@ if __name__ == '__main__':
jinja_data = JinjaData( jinja_data = JinjaData(
since=since, since=since,
display_since=max(until - timedelta(days=30), since),
until=until, until=until,
bench_datas=template_bench_datas, bench_datas=template_bench_datas,
bench_source=bench_source,
branches=branches, branches=branches,
) )
# Render Jinja template with jinja_data # Render Jinja template with jinja_data
render_html(jinja_data, JINJA_TEMPLATE, "index.html") if not path.exists(GENERATED_SITE_DIR):
index_html_path = os.path.join(os.getcwd(), "index.html") os.mkdir(GENERATED_SITE_DIR)
print(f"The generated HTML is in {index_html_path}") logging.debug(f"Rendering HTML from {JINJA_TEMPLATE} to {GENERATED_SITE_DIR}")
print(f"Open file://{index_html_path} in the browser") site_path = path.join(GENERATED_SITE_DIR, bench_source.value + "-benchs.html")
render_html(
jinja_data,
JINJA_TEMPLATE,
site_path
)
logging.debug(f"Copying static site content from {TEMPLATES_DIR} to {GENERATED_SITE_DIR}")
shutil.copy(
path.join(TEMPLATES_DIR, "styles.css"),
path.join(GENERATED_SITE_DIR, "styles.css")
)
index_html_abs_path = path.abspath(site_path)
print(f"The generated HTML is in {index_html_abs_path}")
print(f"Open file://{index_html_abs_path} in the browser")
if __name__ == "__main__":
asyncio.run(main())

265
tools/performance/engine-benchmarks/template_jinja.html
View File

@ -1,265 +0,0 @@
{# Input data to this template: JinjaData as defined by `bench_download.py` #}
<!DOCTYPE html>
<html lang="en">
<head>
<title>Engine benchmark results</title>
<!--Load the AJAX API-->
<script
type="text/javascript"
src="https://www.gstatic.com/charts/loader.js"
></script>
<!-- Include Bootstrap -->
<link
href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0-alpha1/dist/css/bootstrap.min.css"
rel="stylesheet"
integrity="sha384-GLhlTQ8iRABdZLl6O3oVMWSktQOp6b7In1Zl3/Jr59b6EGGoI1aFkw7cmDA6j6gD"
crossorigin="anonymous"
/>
<script
src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0-alpha1/dist/js/bootstrap.bundle.min.js"
integrity="sha384-w76AqPfDkMBDXo30jS1Sgez6pr3x5MlQ1ZAGC+nuZB+EYdgRZgiwxhTBTkF7CXvN"
crossorigin="anonymous"
></script>
<script type="text/javascript">
// Load the Visualization API and the corechart package.
google.charts.load('current', {'packages':['corechart']});
// Global variable declarations
const dateColIdx = 0;
const branchNames = ['{{ branches|join('\',\n \'') }}'];
const tooltipColIdx = branchNames.length + 1;
/**
* A helper function, not used in the production code.
* @param dataTable Google chart DataTable
* @returns {string} representation of the data table.
*/
function dataTableToString(dataTable) {
let dataTableString = "";
for (let rowIdx = 0; rowIdx < dataTable.getNumberOfRows(); rowIdx++) {
for (let colIdx = 0; colIdx < dataTable.getNumberOfColumns(); colIdx++) {
let value = dataTable.getValue(rowIdx, colIdx);
if (typeof(value) === 'string') {
value = value.replace("\n", " ");
}
dataTableString += value + " | ";
}
dataTableString += "\n";
}
return dataTableString;
}
{% for bench_data in bench_datas %}
let chart_{{ bench_data.id }} = null;
let data_table_{{ bench_data.id }} = null;
const bench_data_{{ bench_data.id }} = {
{% for branch_name, datapoints in bench_data.branches_datapoints.items() %}
'{{ branch_name }}': [
{% for datapoint in datapoints %}
{
"date": new Date(
{{ datapoint.timestamp.year }},
{{ datapoint.timestamp.month - 1 }},
{{ datapoint.timestamp.day }},
{{ datapoint.timestamp.hour }},
{{ datapoint.timestamp.minute }}
),
"score": {{ datapoint.score }},
"score-diff": "{{ datapoint.score_diff }}",
"score-diff-perc": "{{ datapoint.score_diff_perc }}",
"tooltip": "{{ datapoint.tooltip }}",
"bench-run-url": "{{ datapoint.bench_run_url }}",
"commit-id": "{{ datapoint.commit_id }}",
"commit-msg": "{{ datapoint.commit_msg }}",
"commit-author": "{{ datapoint.commit_author }}",
"commit-url": "{{ datapoint.commit_url }}",
"commit-date": new Date(
{{ datapoint.timestamp.year }},
{{ datapoint.timestamp.month - 1 }},
{{ datapoint.timestamp.day }},
{{ datapoint.timestamp.hour }},
{{ datapoint.timestamp.minute }}
),
},
{% endfor %}
],
{% endfor %}
};
function draw_{{ bench_data.id }}() {
chart_{{ bench_data.id }} = new google.visualization.LineChart(document.getElementById('{{ bench_data.id }}'));
data_table_{{ bench_data.id }} = new google.visualization.DataTable();
data_table_{{ bench_data.id }}.addColumn('datetime', 'commit_timestamp');
for (let branchName of branchNames) {
data_table_{{ bench_data.id }}.addColumn({type: "number", role:"data", label:branchName});
}
data_table_{{ bench_data.id }}.addColumn({type:'string', role:'tooltip'});
for (let branchName of branchNames) {
bench_data_{{ bench_data.id }}[branchName].forEach(function (benchRowData) {
let branchColIdx = data_table_{{ bench_data.id }}.getColumnIndex(branchName)
let row = new Array(2 + branchNames.length);
row.fill(null);
row[dateColIdx] = benchRowData["date"]
row[tooltipColIdx] = benchRowData["tooltip"]
row[branchColIdx] = benchRowData["score"]
data_table_{{ bench_data.id }}.addRow(row)
})
}
let options = {
'title': '{{ bench_data.id }}',
// So that points are visible, with pointSize=0, there is only a line
'pointSize': 5,
'explorer': {
'axis': 'horizontal',
'actions': ['dragToZoom', 'rightClickToReset']
}
};
chart_{{ bench_data.id }}.draw(data_table_{{ bench_data.id }}, options);
// Attach selection event listener to the chart
google.visualization.events.addListener(chart_{{ bench_data.id }}, 'select', select_callback_{{ bench_data.id }});
}
function select_callback_{{ bench_data.id }}() {
let selection = chart_{{ bench_data.id }}.getSelection();
// Check if a specific element is selected, and not the whole line
// More points can be selected, but we care only about the first one
if (selection.length > 0 && selection[0].row != null && selection[0].column != null) {
let rowIdx = selection[0].row;
let selectedDate = data_table_{{ bench_data.id }}.getValue(rowIdx, dateColIdx);
let tooltip = data_table_{{ bench_data.id }}.getValue(rowIdx, tooltipColIdx);
let branchRegexp = new RegExp("branch = (.+)\n")
let match = tooltip.match(branchRegexp)
console.assert(match !== undefined)
let selectedBranch = match[1]
let selectedBranchData = bench_data_{{ bench_data.id }}[selectedBranch].find(function (benchRowData) {
return benchRowData["date"] === selectedDate
})
let commitId = selectedBranchData["commit-id"];
let commitAuthor = selectedBranchData["commit-author"];
let commitMsg = selectedBranchData["commit-msg"];
let benchRunURL = selectedBranchData["bench-run-url"];
let commitURL = selectedBranchData["commit-url"];
let score = selectedBranchData["score"];
let scoreDiff = selectedBranchData["score-diff"];
let scoreDiffPerc = selectedBranchData["score-diff-perc"];
let commitDate = selectedBranchData["commit-date"];
console.assert(commitId !== undefined)
console.assert(commitAuthor !== undefined)
console.assert(commitMsg !== undefined)
console.assert(benchRunURL !== undefined)
console.assert(commitURL !== undefined)
console.assert(score !== undefined)
console.assert(scoreDiff !== undefined)
console.assert(commitDate !== undefined)
// Fill in the selection details
document.getElementById('{{ bench_data.id }}-sel-info-score').innerHTML = score;
document.getElementById('{{ bench_data.id }}-sel-info-score-diff').innerHTML = scoreDiff;
document.getElementById('{{ bench_data.id }}-sel-info-score-diff-perc').innerHTML = scoreDiffPerc;
document.getElementById('{{ bench_data.id }}-sel-info-date').innerHTML = commitDate;
document.getElementById('{{ bench_data.id }}-sel-info-author').innerHTML = commitAuthor;
document.getElementById('{{ bench_data.id }}-sel-info-com-id').innerHTML = commitId;
document.getElementById('{{ bench_data.id }}-sel-info-com-msg').innerHTML = commitMsg;
document.getElementById('{{ bench_data.id }}-sel-info-url').innerHTML = `
<a target="_blank" rel="noreferrer noopener" href="${commitURL}"> ${commitURL} </a>
`;
document.getElementById('{{ bench_data.id }}-sel-info-bench-url').innerHTML = `
<a target="_blank" rel="noreferrer noopener" href="${benchRunURL}"> ${benchRunURL} </a>
`;
}
}
google.charts.setOnLoadCallback(draw_{{ bench_data.id }});
{# end of bench_data #}
{% endfor %}
</script>
</head>
<body>
<h1 class="text-center">Engine benchmark results</h1>
<h2>Since {{ since }} until {{ until }}</h2>
<p>
<b>Score</b> represents the amount of milliseconds it takes for one
iteration of the benchmark to finish.
<br />
The smaller the score, the better.
</p>
<br />
Note that only successful benchmark jobs are processed, so if there is a gap
in the chart, it might be caused by failing jobs during that time period.
<br />
<p>
Hovering over some point in a graph displays score, score diff (difference
with the previous score value) and date in a tooltip. You can click on a
particular point in the graph to display some additional information under
the graph like a link to PR, a commit message, commit author, etc.
</p>
<p>
The charts can be zoomed in by <code>dragToZoom</code> which means that
you can left-click on the chart, hold it, and release it to zoom into a
rectangular area. Then right-clicking to reset to the original zoom. See
<code>explorer</code> configuration options in
<a
href="https://developers.google.com/chart/interactive/docs/gallery/linechart#configuration-options"
>
https://developers.google.com/chart/interactive/docs/gallery/linechart#configuration-options
</a>
.
</p>
<br />
Generated by the <code>bench_download.py</code> script. {% for bench_data in
bench_datas %}
<h3>{{ bench_data.id }}</h3>
<div id="{{ bench_data.id }}"></div>
<!-- selection-info div will be shown once user selects a point in the chart -->
<div class="border">
<p class="text-center">Selection info:</p>
<dl class="row">
<dt class="col-sm-3">Score</dt>
<dd class="col-sm-9" id="{{ bench_data.id }}-sel-info-score">
No selection
</dd>
<dt class="col-sm-3">Score difference</dt>
<dd class="col-sm-9" id="{{ bench_data.id }}-sel-info-score-diff">
No selection
</dd>
<dt class="col-sm-3">Score difference percentage</dt>
<dd class="col-sm-9" id="{{ bench_data.id }}-sel-info-score-diff-perc">
No selection
</dd>
<dt class="col-sm-3">Commit date</dt>
<dd class="col-sm-9" id="{{ bench_data.id }}-sel-info-date">
No selection
</dd>
<dt class="col-sm-3">Commit author</dt>
<dd class="col-sm-9" id="{{ bench_data.id }}-sel-info-author">
No selection
</dd>
<dt class="col-sm-3">Commit message</dt>
<dd class="col-sm-9" id="{{ bench_data.id }}-sel-info-com-msg">
No selection
</dd>
<dt class="col-sm-3">Commit ID</dt>
<dd class="col-sm-9" id="{{ bench_data.id }}-sel-info-com-id">
No selection
</dd>
<dt class="col-sm-3">Commit URL</dt>
<dd class="col-sm-9" id="{{ bench_data.id }}-sel-info-url">
No selection
</dd>
<dt class="col-sm-3">Bench run URL</dt>
<dd class="col-sm-9" id="{{ bench_data.id }}-sel-info-bench-url">
No selection
</dd>
</dl>
</div>
{% endfor %}
</body>
</html>

59
tools/performance/engine-benchmarks/templates/styles.css Normal file
View File

@ -0,0 +1,59 @@
/*
Generic description at the top of the site.
*/
#description {
margin: 40px 10%;
font-family: serif;
font-size: 1.2em;
}
/* Top panel with filters */
#top-panel {
display: flex;
flex-flow: column;
padding-left: 15%;
padding-right: 15%;
padding-bottom: 50px;
}
#top-panel-filters {
margin-bottom: 20px;
display: flex;
flex-flow: column;
background-color: #f5f5f5;
box-shadow: 0 1px 0 #fff;
}
#top-panel-applied-filters {
margin-top: 30px;
display: flex;
flex-flow: column;
background-color: #f5f5f5;
box-shadow: 0 1px 0 #fff;
}
/* Container for all the benchmarks */
#benchmarks-container {
display: flex;
flex-direction: column;
margin-left: 5%;
margin-right: 5%;
}
/*
Container for a single benchmark
*/
.bench-container {
margin-top: 20px;
margin-bottom: 20px;
max-width: 95%;
}
.bench-chart {
max-width: 95%;
}
/* Selection info for a singel benchmark */
.selection-info {
margin-top: 10px;
}

388
tools/performance/engine-benchmarks/templates/template_jinja.html Normal file
View File

@ -0,0 +1,388 @@
{# Input data to this template: JinjaData as defined by `bench_download.py` #}
<!DOCTYPE html>
<meta charset="UTF-8" />
<html lang="en">
<head>
<title>{{ bench_source.value }} benchmark results</title>
<!--Load the AJAX API-->
<script
type="text/javascript"
src="https://www.gstatic.com/charts/loader.js"
></script>
<!-- Include Bootstrap -->
<link
href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0-alpha1/dist/css/bootstrap.min.css"
rel="stylesheet"
integrity="sha384-GLhlTQ8iRABdZLl6O3oVMWSktQOp6b7In1Zl3/Jr59b6EGGoI1aFkw7cmDA6j6gD"
crossorigin="anonymous"
/>
<link href="styles.css" rel="stylesheet" />
<script
src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0-alpha1/dist/js/bootstrap.bundle.min.js"
integrity="sha384-w76AqPfDkMBDXo30jS1Sgez6pr3x5MlQ1ZAGC+nuZB+EYdgRZgiwxhTBTkF7CXvN"
crossorigin="anonymous"
></script>
<script type="text/javascript">
// Load the Visualization API and the corechart package.
google.charts.load('current', {'packages':['corechart']});
// Global variable declarations
const dateColIdx = 0;
const branchNames = ['{{ branches|join('\',\n \'') }}'];
const tooltipColIdx = branchNames.length + 1;
// Availability of the data.
const sinceDate = new Date(
{{ since.year }},
{{ since.month - 1 }},
{{ since.day }},
{{ since.hour }},
{{ since.minute }}
);
const untilDate = new Date(
{{ until.year }},
{{ until.month - 1 }},
{{ until.day }},
{{ until.hour }},
{{ until.minute }}
);
// This var will be rewritten once a filter is applied
let displaySinceDate = new Date(
{{ display_since.year }},
{{ display_since.month - 1 }},
{{ display_since.day }},
{{ display_since.hour }},
{{ display_since.minute }}
);
/**
* A helper function, not used in the production code.
* @param dataTable Google chart DataTable
* @returns {string} representation of the data table.
*/
function dataTableToString(dataTable) {
let dataTableString = "";
for (let rowIdx = 0; rowIdx < dataTable.getNumberOfRows(); rowIdx++) {
for (let colIdx = 0; colIdx < dataTable.getNumberOfColumns(); colIdx++) {
let value = dataTable.getValue(rowIdx, colIdx);
if (typeof(value) === 'string') {
value = value.replace("\n", " ");
}
dataTableString += value + " | ";
}
dataTableString += "\n";
}
return dataTableString;
}
{% for bench_data in bench_datas %}
let chart_{{ bench_data.id }} = null;
let data_table_{{ bench_data.id }} = null;
const bench_data_{{ bench_data.id }} = {
{% for branch_name, datapoints in bench_data.branches_datapoints.items() %}
'{{ branch_name }}': [
{% for datapoint in datapoints %}
{
"date": new Date(
{{ datapoint.timestamp.year }},
{{ datapoint.timestamp.month - 1 }},
{{ datapoint.timestamp.day }},
{{ datapoint.timestamp.hour }},
{{ datapoint.timestamp.minute }}
),
"score": {{ datapoint.score }},
"score-diff": "{{ datapoint.score_diff }}",
"score-diff-perc": "{{ datapoint.score_diff_perc }}",
"tooltip": "{{ datapoint.tooltip }}",
"bench-run-url": "{{ datapoint.bench_run_url }}",
"commit-id": "{{ datapoint.commit_id }}",
"commit-msg": "{{ datapoint.commit_msg }}",
"commit-author": "{{ datapoint.commit_author }}",
"commit-url": "{{ datapoint.commit_url }}",
"commit-date": new Date(
{{ datapoint.timestamp.year }},
{{ datapoint.timestamp.month - 1 }},
{{ datapoint.timestamp.day }},
{{ datapoint.timestamp.hour }},
{{ datapoint.timestamp.minute }}
),
},
{% endfor %}
],
{% endfor %}
};
/**
* Draws a chart for {{ bench_data.id }} benchmark.
*/
function draw_{{ bench_data.id }}() {
if (data_table_{{ bench_data.id }} === null) {
data_table_{{ bench_data.id }} = new google.visualization.DataTable();
data_table_{{ bench_data.id }}.addColumn('datetime', 'commit_timestamp');
for (let branchName of branchNames) {
data_table_{{ bench_data.id }}.addColumn({type: "number", role:"data", label:branchName});
}
data_table_{{ bench_data.id }}.addColumn({type:'string', role:'tooltip'});
} else {
// Clear data_table
let rowNum = data_table_{{ bench_data.id }}.getNumberOfRows();
data_table_{{ bench_data.id }}.removeRows(0, rowNum);
}
for (let branchName of branchNames) {
bench_data_{{ bench_data.id }}[branchName].forEach(function (benchRowData) {
if (benchRowData["date"] > displaySinceDate) {
let branchColIdx = data_table_{{ bench_data.id }}.getColumnIndex(branchName)
let row = new Array(2 + branchNames.length);
row.fill(null);
row[dateColIdx] = benchRowData["date"]
row[tooltipColIdx] = benchRowData["tooltip"]
row[branchColIdx] = benchRowData["score"]
data_table_{{ bench_data.id }}.addRow(row)
}
})
}
let options = {
// So that points are visible, with pointSize=0, there is only a line
'pointSize': 5,
'explorer': {
'axis': 'horizontal',
'actions': ['dragToZoom', 'rightClickToReset']
}
};
if (chart_{{ bench_data.id }} === null) {
chart_{{ bench_data.id }} = new google.visualization.LineChart(document.getElementById('{{ bench_data.id }}'));
// Attach selection event listener to the chart
google.visualization.events.addListener(chart_{{ bench_data.id }}, 'select', select_callback_{{ bench_data.id }});
} else {
chart_{{ bench_data.id }}.clearChart();
}
chart_{{ bench_data.id }}.draw(data_table_{{ bench_data.id }}, options);
}
function select_callback_{{ bench_data.id }}() {
let selection = chart_{{ bench_data.id }}.getSelection();
// Check if a specific element is selected, and not the whole line
// More points can be selected, but we care only about the first one
if (selection.length > 0 && selection[0].row != null && selection[0].column != null) {
let rowIdx = selection[0].row;
let selectedDate = data_table_{{ bench_data.id }}.getValue(rowIdx, dateColIdx);
let tooltip = data_table_{{ bench_data.id }}.getValue(rowIdx, tooltipColIdx);
let branchRegexp = new RegExp("branch = (.+)\n")
let match = tooltip.match(branchRegexp)
console.assert(match !== undefined)
let selectedBranch = match[1]
let selectedBranchData = bench_data_{{ bench_data.id }}[selectedBranch].find(function (benchRowData) {
return benchRowData["date"] === selectedDate
})
let commitId = selectedBranchData["commit-id"];
let commitAuthor = selectedBranchData["commit-author"];
let commitMsg = selectedBranchData["commit-msg"];
let benchRunURL = selectedBranchData["bench-run-url"];
let commitURL = selectedBranchData["commit-url"];
let score = selectedBranchData["score"];
let scoreDiff = selectedBranchData["score-diff"];
let scoreDiffPerc = selectedBranchData["score-diff-perc"];
let commitDate = selectedBranchData["commit-date"];
console.assert(commitId !== undefined)
console.assert(commitAuthor !== undefined)
console.assert(commitMsg !== undefined)
console.assert(benchRunURL !== undefined)
console.assert(commitURL !== undefined)
console.assert(score !== undefined)
console.assert(scoreDiff !== undefined)
console.assert(commitDate !== undefined)
// Fill in the selection details
document.getElementById('{{ bench_data.id }}-sel-info-score').innerHTML = score;
document.getElementById('{{ bench_data.id }}-sel-info-score-diff').innerHTML = scoreDiff;
document.getElementById('{{ bench_data.id }}-sel-info-score-diff-perc').innerHTML = scoreDiffPerc;
document.getElementById('{{ bench_data.id }}-sel-info-date').innerHTML = commitDate;
document.getElementById('{{ bench_data.id }}-sel-info-author').innerHTML = commitAuthor;
document.getElementById('{{ bench_data.id }}-sel-info-com-id').innerHTML = commitId;
document.getElementById('{{ bench_data.id }}-sel-info-com-msg').innerHTML = commitMsg;
document.getElementById('{{ bench_data.id }}-sel-info-url').innerHTML = `
<a target="_blank" rel="noreferrer noopener" href="${commitURL}"> ${commitURL} </a>
`;
document.getElementById('{{ bench_data.id }}-sel-info-bench-url').innerHTML = `
<a target="_blank" rel="noreferrer noopener" href="${benchRunURL}"> ${benchRunURL} </a>
`;
}
}
google.charts.setOnLoadCallback(draw_{{ bench_data.id }});
{# end of bench_data #}
{% endfor %}
function sinceDateClickHandler() {
let val = document.getElementById("since-date-input").value;
if (val !== null && val !== "") {
let date = new Date(val);
displaySinceDate = date;
console.log("sinceDateClickHandler: new sinceDate set to: ", date);
// Iterate all the redraw charts
{% for bench_data in bench_datas %}
draw_{{ bench_data.id }}();
document.getElementById("{{ bench_data.id }}-sel-info-score").innerHTML = "No selection";
document.getElementById("{{ bench_data.id }}-sel-info-score-diff").innerHTML = "No selection";
document.getElementById("{{ bench_data.id }}-sel-info-score-diff-perc").innerHTML = "No selection";
document.getElementById("{{ bench_data.id }}-sel-info-date").innerHTML = "No selection";
document.getElementById("{{ bench_data.id }}-sel-info-author").innerHTML = "No selection";
document.getElementById("{{ bench_data.id }}-sel-info-com-msg").innerHTML = "No selection";
document.getElementById("{{ bench_data.id }}-sel-info-com-id").innerHTML = "No selection";
document.getElementById("{{ bench_data.id }}-sel-info-url").innerHTML = "No selection";
document.getElementById("{{ bench_data.id }}-sel-info-bench-url").innerHTML = "No selection";
{% endfor %}
document.getElementById("applied-since-filter").innerHTML = date.toDateString();
}
}
</script>
</head>
<body>
<h1 class="text-center">{{ bench_source.value }} benchmark results</h1>
<h2 class="text-center">
Since {{ since.date() }} until {{ until.date() }}
</h2>
<div id="description">
<p>
<b>Score</b> represents the amount of milliseconds it takes for one
iteration of the benchmark to finish.
<br />
The smaller the score, the better.
</p>
<br />
Note that only successful benchmark jobs are processed, so if there is a
gap in the chart, it might be caused by failing jobs during that time
period.
<br />
<p>
Hovering over some point in a graph displays score, score diff
(difference with the previous score value) and date in a tooltip. You
can click on a particular point in the graph to display some additional
information under the graph like a link to PR, a commit message, commit
author, etc.
</p>
<p>
The charts can be zoomed in by <code>dragToZoom</code> which means that
you can left-click on the chart, hold it, and release it to zoom into a
rectangular area. Then right-clicking to reset to the original zoom. See
<code>explorer</code> configuration options in
<a
href="https://developers.google.com/chart/interactive/docs/gallery/linechart#configuration-options"
>
https://developers.google.com/chart/interactive/docs/gallery/linechart#configuration-options
</a>
.
</p>
<br />
Generated by the <code>bench_download.py</code> script.
</div>
<div id="top-panel" class="container">
<div id="top-panel-filters" class="card">
<h3 class="card-header text-center">Filters</h3>
<div class="card-body">
<form class="row">
<label
for="since-date-input"
class="col fs-4 text-center form-label"
>
Since date:
</label>
<input
type="date"
id="since-date-input"
class="col form-control form-control-lg"
name="since-date"
min="{{ since.date() }}"
max="{{ until.date() }}"
/>
</form>
<div class="row">
<div class="col"></div>
<button
id="reset-since-date-btn"
class="col btn btn-primary"
style="margin-top: 10px"
onclick="sinceDateClickHandler()"
>
Apply filters
</button>
<div class="col"></div>
</div>
</div>
</div>
<div id="top-panel-applied-filters" class="card">
<h3 class="card-header text-center">Applied filters</h3>
<div class="card-body">
<div class="row">
<div class="col text-center fs-4">Since date:</div>
<div id="applied-since-filter" class="col fs-4 text-center">
{{ display_since.date() }}
</div>
</div>
</div>
</div>
</div>
<div id="benchmarks-container" class="container-fluid">
{% for bench_data in bench_datas %}
<div class="bench-container card">
<h3 class="card-header text-center">{{ bench_data.id }}</h3>
<!-- This is a placeholder div for a bench chart -->
<div id="{{ bench_data.id }}" class="bench-chart"></div>
<!-- selection-info div will be shown once user selects a point in the chart -->
<div class="selection-info card-body">
<dl class="row card-text">
<dt class="col-sm-3">Score</dt>
<dd class="col-sm-9" id="{{ bench_data.id }}-sel-info-score">
No selection
</dd>
<dt class="col-sm-3">Score difference</dt>
<dd class="col-sm-9" id="{{ bench_data.id }}-sel-info-score-diff">
No selection
</dd>
<dt class="col-sm-3">Score difference percentage</dt>
<dd
class="col-sm-9"
id="{{ bench_data.id }}-sel-info-score-diff-perc"
>
No selection
</dd>
<dt class="col-sm-3">Commit date</dt>
<dd class="col-sm-9" id="{{ bench_data.id }}-sel-info-date">
No selection
</dd>
<dt class="col-sm-3">Commit author</dt>
<dd class="col-sm-9" id="{{ bench_data.id }}-sel-info-author">
No selection
</dd>
<dt class="col-sm-3">Commit message</dt>
<dd class="col-sm-9" id="{{ bench_data.id }}-sel-info-com-msg">
No selection
</dd>
<dt class="col-sm-3">Commit ID</dt>
<dd class="col-sm-9" id="{{ bench_data.id }}-sel-info-com-id">
No selection
</dd>
<dt class="col-sm-3">Commit URL</dt>
<dd class="col-sm-9" id="{{ bench_data.id }}-sel-info-url">
No selection
</dd>
<dt class="col-sm-3">Bench run URL</dt>
<dd class="col-sm-9" id="{{ bench_data.id }}-sel-info-bench-url">
No selection
</dd>
</dl>
</div>
</div>
{% endfor %}
</div>
</body>
</html>