Evidently and MLflow

Search…

Log Evidently metrics in the MLflow UI.

TL;DR: You can use Evidently to calculate metrics, and MLflow Tracking to log and view the results. Here is a sample Jupyter notebook.
Overview
Many machine learning teams use MLflow for experiment management, deployment, and as a model registry. If you are already familiar with MLflow, you can integrate it with Evidently to track the performance of your models.
In this case, you use Evidently to calculate the metrics and MLflow to log the results. You can then access the metrics in the MLflow interface.
How it works
Evidently calculates a rich set of metrics and statistical tests. You can choose any of the pre-built reports to define the metrics you’d want to get.
You can then generate a JSON profile that will contain the defined metrics output. You can combine several profile sections (e.g., Data and Prediction Drift together).
You might not always need all metrics from the profile. You should explicitly define which parts of the output to send to MLflow Tracking.
Tutorial 1: Evaluating Data Drift with MLFlow and Evidently
In this example, we will use Evidently to check input features for Data Drift and log and visualize the results with MLflow.
Here is a Jupyter notebook with the example:
evidently/mlflow_integration.ipynb at main · evidentlyai/evidently
GitHub
Step 1. Install MLflow and Evidently
Evidently is available as a PyPI package:
1
$ pip install evidently
Copied!
For more details, refer to the Evidently installation guide.
To install MLflow, run:
1
$ pip install mlflow
Copied!
Or install MLflow with scikit-learn via
1
$pip install mlflow[extras] 
Copied!
For more details, refer to MLflow documentation.
Step 2. Load the data
Load the data from UCI repository (link) and save it locally.
For demonstration purposes, we treat this data as the input data for a live model. To use with production models, you should make your prediction logs available.
This is how it looks:
Step 3. Define column mapping
We specify the categorical and numerical features so that Evidently performs the correct statistical test for each of them.
1
data_columns = {}
2
data_columns['numerical_features'] = ['weather', 'temp', 'atemp', 'humidity', 'windspeed']
3
data_columns['categorical_features'] = ['holiday', 'workingday']
Copied!
Step 4. Define what to log
We specify which metrics we want to see. In this case, we want to get the p-value of the statistical test performed to evaluate the drift for each feature.
1
def eval_drift(reference, production, column_mapping):
2
    data_drift_profile = Profile(sections=[DataDriftProfileSection])
3
    data_drift_profile.calculate(reference, production, column_mapping=column_mapping)
4
    report = data_drift_profile.json()
5
    json_report = json.loads(report)
6
​
7
    drifts = []
8
    for feature in column_mapping['numerical_features'] + column_mapping['categorical_features']:
9
        drifts.append((feature, json_report['data_drift']['data']['metrics'][feature]['p_value'])) 
10
    return drifts
Copied!
Step 5. Define the comparison windows
We specify the period that is considered reference: we will use it as the base for the comparison. Then, we choose the periods that we treat as experiments that emulate production model runs.
1
#set reference dates
2
reference_dates = ('2011-01-01 00:00:00','2011-01-28 23:00:00')
3
​
4
#set experiment batches dates
5
experiment_batches = [
6
    ('2011-01-01 00:00:00','2011-01-29 23:00:00'),
7
    ('2011-01-29 00:00:00','2011-02-07 23:00:00'),
8
    ('2011-02-07 00:00:00','2011-02-14 23:00:00'),
9
    ('2011-02-15 00:00:00','2011-02-21 23:00:00'),  
10
]
Copied!
Step 6. Run and log experiments in MLflow
We initiate the experiments and log the metrics calculated with Evidently on each run.
1
#log into MLflow
2
client = MlflowClient()
3
​
4
#set experiment
5
mlflow.set_experiment('Data Drift Evaluation with Evidently')
6
​
7
#start new run
8
for date in experiment_batches:
9
    with mlflow.start_run() as run: #inside brackets run_name='test'
10
        
11
        # Log parameters
12
        mlflow.log_param("begin", date[0])
13
        mlflow.log_param("end", date[1])
14
​
15
        # Log metrics
16
        metrics = eval_drift(raw_data.loc[reference_dates[0]:reference_dates[1]], 
17
                             raw_data.loc[date[0]:date[1]], 
18
                             column_mapping=data_columns)
19
        for feature in metrics:
20
            mlflow.log_metric(feature[0], round(feature[1], 3))
21
​
22
        print(run.info)
Copied!
Step 7. View the results in MLflow web UI
You can then use the MLflow UI to see the results of the runs.
With a large number of metrics, you can use the expanded view.
Tutorial 2: Evaluating Historical Data Drift with Evidently, Plotly and MLflow
See a tutorial here.