ODH Logo

Quantify Time to Test

In this notebook, the Key Performance Indicator that we capture is the time to test for the test Overall or the total runtime for builds as it would help filter and observe builds with longer than expected runtimes.

By measuring this metric, we can observe the trend of build runtimes and check if the execution time of the builds exceed the specified values. If the execution of the test suite takes a long time, we may wish to optimize our test code or track down tests that are taking too long. This metric can also be used to draw a correlation to the tests turning out to be flaky.

In this notebook, we capture:

  • Time taken to run builds over time

Linked issues: issue1

[1]
import os
import json
import datetime
import gzip
import pandas as pd
import matplotlib.pyplot as plt
import seaborn as sns

from ipynb.fs.defs.metric_template import testgrid_labelwise_encoding
from ipynb.fs.defs.metric_template import CephCommunication
from ipynb.fs.defs.metric_template import save_to_disk, read_from_disk
from dotenv import load_dotenv, find_dotenv

load_dotenv(find_dotenv())
True

For extracting this metric, we will dig into the time series data in the detailed test grids. In this notebook, we use the Overall tests as our proxy for builds.

There are inbuilt Graphs within TestGrid for each Test in the job, which capture the time taken for running each test.

As a part of our data download and extraction process we are capturing time taken not for all tests but the test Overall which can be used as a proxy for a Build since time durations are not consistently captured for all tests. Thus in this notebook, we capture time elapsed for each Build.

[2]
## Specify variables

METRIC_NAME = "time_to_test"

# Specify the path for input grid data,
INPUT_DATA_PATH = "../../../../data/raw/testgrid_183.json.gz"

# Specify the path for output metric data
OUTPUT_DATA_PATH = f"../../../../data/processed/metrics/{METRIC_NAME}"

## CEPH Bucket variables
## Create a .env file on your local with the correct configs,
s3_endpoint_url = os.getenv("S3_ENDPOINT")
s3_access_key = os.getenv("S3_ACCESS_KEY")
s3_secret_key = os.getenv("S3_SECRET_KEY")
s3_bucket = os.getenv("S3_BUCKET")
s3_path = os.getenv("S3_PROJECT_KEY", "ai4ci/testgrid/metrics")
s3_input_data_path = "raw_data"
AUTOMATION = os.getenv("IN_AUTOMATION")
[3]
## Import data
timestamp = datetime.datetime.today()

if AUTOMATION:
    filename = f"testgrid_{timestamp.day}{timestamp.month}.json"
    cc = CephCommunication(s3_endpoint_url, s3_access_key, s3_secret_key, s3_bucket)
    s3_object = cc.s3_resource.Object(s3_bucket, f"{s3_input_data_path}/{filename}")
    file_content = s3_object.get()["Body"].read().decode("utf-8")
    testgrid_data = json.loads(file_content)

else:
    with gzip.open(INPUT_DATA_PATH, "rb") as read_file:
        testgrid_data = json.load(read_file)

Metric Calculation

We find runtimes for each Test or Build

[4]
# We pass status code as None since we are not filtering by Status here
testgrid_list = testgrid_labelwise_encoding(testgrid_data, None, False)
[5]
len(testgrid_list)
34000772
[6]
testgrid_list[0]
(datetime.datetime(2021, 8, 16, 23, 3, 14),
 '"redhat-assisted-installer"',
 'periodic-ci-openshift-release-master-nightly-4.6-e2e-metal-assisted',
 'Overall',
 20.016666666666666)
[7]
# Convert to dataframe
testgrid_df = pd.DataFrame(
    testgrid_list, columns=["timestamp", "tab", "grid", "test", "test_duration"]
)
testgrid_df.head()
timestamp tab grid test test_duration
0 2021-08-16 23:03:14 "redhat-assisted-installer" periodic-ci-openshift-release-master-nightly-4... Overall 20.016667
1 2021-08-16 01:00:30 "redhat-assisted-installer" periodic-ci-openshift-release-master-nightly-4... Overall 77.500000
2 2021-08-16 00:01:05 "redhat-assisted-installer" periodic-ci-openshift-release-master-nightly-4... Overall 108.233333
3 2021-08-14 01:11:53 "redhat-assisted-installer" periodic-ci-openshift-release-master-nightly-4... Overall 118.166667
4 2021-08-11 23:19:08 "redhat-assisted-installer" periodic-ci-openshift-release-master-nightly-4... Overall 96.750000
[8]
testgrid_df = testgrid_df.loc[testgrid_df.test_duration.notnull()]
[9]
testgrid_df.head()
timestamp tab grid test test_duration
0 2021-08-16 23:03:14 "redhat-assisted-installer" periodic-ci-openshift-release-master-nightly-4... Overall 20.016667
1 2021-08-16 01:00:30 "redhat-assisted-installer" periodic-ci-openshift-release-master-nightly-4... Overall 77.500000
2 2021-08-16 00:01:05 "redhat-assisted-installer" periodic-ci-openshift-release-master-nightly-4... Overall 108.233333
3 2021-08-14 01:11:53 "redhat-assisted-installer" periodic-ci-openshift-release-master-nightly-4... Overall 118.166667
4 2021-08-11 23:19:08 "redhat-assisted-installer" periodic-ci-openshift-release-master-nightly-4... Overall 96.750000
[10]
len(testgrid_df)
19054666

Metric Calculation

We want to calcluate the average time duration for the job/build

[11]
average_time = (
    testgrid_df.groupby(["tab", "grid", "test"])["test_duration"].mean().reset_index()
)
[12]
average_time.head()
tab grid test test_duration
0 "redhat-assisted-installer" periodic-ci-openshift-release-master-nightly-4... Overall 98.698889
1 "redhat-assisted-installer" periodic-ci-openshift-release-master-nightly-4... TestInstall_test_install.cluster 0.000340
2 "redhat-assisted-installer" periodic-ci-openshift-release-master-nightly-4... TestInstall_test_install.cluster[openshift_ver... 0.000774
3 "redhat-assisted-installer" periodic-ci-openshift-release-master-nightly-4... TestInstall_test_install.generate_and_download... 0.333156
4 "redhat-assisted-installer" periodic-ci-openshift-release-master-nightly-4... TestInstall_test_install.generate_and_download... 0.332048

Visualization

Plot of time elapsed for Builds over time.

[13]
df = (
    testgrid_df.groupby(["tab", "grid", "test"])
    .apply(lambda x: [list(x["test_duration"]), list(x["timestamp"])])
    .apply(pd.Series)
    .reset_index()
)
df.columns = ["tab", "grid", "test", "test_duration", "timestamp"]
[14]
df.head()
tab grid test test_duration timestamp
0 "redhat-assisted-installer" periodic-ci-openshift-release-master-nightly-4... Overall [20.016666666666666, 77.5, 108.23333333333333,... [2021-08-16 23:03:14, 2021-08-16 01:00:30, 202...
1 "redhat-assisted-installer" periodic-ci-openshift-release-master-nightly-4... TestInstall_test_install.cluster [0.00035538333333333334, 0.0003228833333333333... [2021-08-09 09:37:34, 2021-08-09 08:51:10, 202...
2 "redhat-assisted-installer" periodic-ci-openshift-release-master-nightly-4... TestInstall_test_install.cluster[openshift_ver... [0.0006529666666666666, 0.00065455, 0.0006794,... [2021-08-16 01:00:30, 2021-08-16 00:01:05, 202...
3 "redhat-assisted-installer" periodic-ci-openshift-release-master-nightly-4... TestInstall_test_install.generate_and_download... [0.29335791666666666, 0.30938418333333334, 0.2... [2021-08-09 09:37:34, 2021-08-09 08:51:10, 202...
4 "redhat-assisted-installer" periodic-ci-openshift-release-master-nightly-4... TestInstall_test_install.generate_and_download... [0.28357965, 0.2936913, 0.34528433333333336, 0... [2021-08-16 01:00:30, 2021-08-16 00:01:05, 202...
[15]
def plot_build_graph(tab, grid, dataframe):

    test_duration = dataframe.loc[
        (df["tab"] == tab) & (dataframe["grid"] == grid), "test_duration"
    ].iloc[0]
    timestamp = dataframe.loc[
        (df["tab"] == tab) & (dataframe["grid"] == grid), "timestamp"
    ].iloc[0]

    time_taken_df = pd.DataFrame(
        {"timestamp": timestamp, "time_duration": test_duration}
    )

    sns.set(rc={"figure.figsize": (17, 10)})
    sns.lineplot(x="timestamp", y="time_duration", data=time_taken_df)
    plt.xlabel("Timestamps")
    plt.ylabel("Time Taken to Run Job or Build (mins)")
    plt.title("Job/Build Duration over time ")
    plt.show()
[16]
plot_build_graph(
    '"redhat-assisted-installer"',
    "periodic-ci-openshift-release-master-nightly-4.7-e2e-metal-assisted",
    df,
)

In the above graph, we see how the time taken to run a build changes over time and we notice when there are spikes or when irregular builds occur.

Save to Ceph or local

[17]
timestamp = datetime.datetime.now()

if AUTOMATION:
    cc = CephCommunication(s3_endpoint_url, s3_access_key, s3_secret_key, s3_bucket)
    cc.upload_to_ceph(
        average_time,
        s3_path,
        f"{METRIC_NAME}/{METRIC_NAME}-{timestamp.year}-{timestamp.month}-{timestamp.day}.parquet",
    )
else:
    save_to_disk(
        average_time,
        OUTPUT_DATA_PATH,
        f"{METRIC_NAME}-{timestamp.year}-{timestamp.month}-{timestamp.day}.parquet",
    )
[18]
## Sanity check to see if the dataset is the same
if AUTOMATION:
    sanity_check = cc.read_from_ceph(
        s3_path,
        f"{METRIC_NAME}/{METRIC_NAME}-{timestamp.year}-{timestamp.month}-{timestamp.day}.parquet",
    )
else:
    sanity_check = read_from_disk(
        OUTPUT_DATA_PATH,
        f"{METRIC_NAME}-{timestamp.year}-{timestamp.month}-{timestamp.day}.parquet",
    )

sanity_check
tab grid test test_duration
0 "redhat-assisted-installer" periodic-ci-openshift-release-master-nightly-4... Overall 98.698889
1 "redhat-assisted-installer" periodic-ci-openshift-release-master-nightly-4... TestInstall_test_install.cluster 0.000340
2 "redhat-assisted-installer" periodic-ci-openshift-release-master-nightly-4... TestInstall_test_install.cluster[openshift_ver... 0.000774
3 "redhat-assisted-installer" periodic-ci-openshift-release-master-nightly-4... TestInstall_test_install.generate_and_download... 0.333156
4 "redhat-assisted-installer" periodic-ci-openshift-release-master-nightly-4... TestInstall_test_install.generate_and_download... 0.332048
... ... ... ... ...
371522 "redhat-single-node" periodic-ci-openshift-release-master-nightly-4... operator.Run multi-stage test e2e-metal-single... 0.016667
371523 "redhat-single-node" periodic-ci-openshift-release-master-nightly-4... operator.Run multi-stage test e2e-metal-single... 28.399033
371524 "redhat-single-node" periodic-ci-openshift-release-master-nightly-4... operator.Run multi-stage test e2e-metal-single... 40.368485
371525 "redhat-single-node" periodic-ci-openshift-release-master-nightly-4... operator.Run multi-stage test e2e-metal-single... 4.320330
371526 "redhat-single-node" periodic-ci-openshift-release-master-nightly-4... operator.Run multi-stage test e2e-metal-single... 0.017125

371527 rows × 4 columns

Conclusion

In this Notebook, we use the "Overall" as a proxy for a build. Testgrid refers an aggregate of multiple tests performed at a certain timestamp within a Job as a Build and each build has a unique Build ID. In this notebook, we went ahead and used the captured time duration for Test Overalls and averged them out for each Job. We also plotted the time taken for builds to complete over time for each Job.