Skip to main content
Version: 1.0.3


Automatic Logging

MLflow automatic logging allows you to log metrics, parameters, and models without the need for explicit log statements. SynapseML supports autologging for every model in the library.

To enable autologging for SynapseML:

  1. Download this customized log_model_allowlist file and put it at a place that your code has access to. For example:
  • In Synapse wasb://<containername>@<accountname>
  • In Databricks /dbfs/FileStore/PATH_TO_YOUR/log_model_allowlist.txt.
  1. Set spark configuration spark.mlflow.pysparkml.autolog.logModelAllowlistFile to the path of your log_model_allowlist.txt file.
  2. Call before your training code to enable autologging for all supported models.


  1. If you want to support autologging of PySpark models not present in the log_model_allowlist file, you can add such models to the file.
  2. If you've enabled autologging, then don't write explicit with mlflow.start_run() as it might cause multiple runs for one single model or one run for multiple models.

Configuration process in Databricks as an example

  1. Install latest MLflow via %pip install mlflow
  2. Upload your customized log_model_allowlist.txt file to dbfs by clicking File/Upload Data button on Databricks UI.
  3. Set Cluster Spark configuration following this documentation
spark.mlflow.pysparkml.autolog.logModelAllowlistFile /dbfs/FileStore/PATH_TO_YOUR/log_model_allowlist.txt
  1. Run the following line before your training code executes.

You can customize how autologging works by supplying appropriate parameters.

  1. To find your experiment's results via the Experiments tab of the MLFlow UI.

Example for ConditionalKNNModel

from import Vectors
from import *

df = spark.createDataFrame([
(Vectors.dense(2.0,2.0,2.0), "foo", 1),
(Vectors.dense(2.0,2.0,4.0), "foo", 3),
(Vectors.dense(2.0,2.0,6.0), "foo", 4),
(Vectors.dense(2.0,2.0,8.0), "foo", 3),
(Vectors.dense(2.0,2.0,10.0), "foo", 1),
(Vectors.dense(2.0,2.0,12.0), "foo", 2),
(Vectors.dense(2.0,2.0,14.0), "foo", 0),
(Vectors.dense(2.0,2.0,16.0), "foo", 1),
(Vectors.dense(2.0,2.0,18.0), "foo", 3),
(Vectors.dense(2.0,2.0,20.0), "foo", 0),
(Vectors.dense(2.0,4.0,2.0), "foo", 2),
(Vectors.dense(2.0,4.0,4.0), "foo", 4),
(Vectors.dense(2.0,4.0,6.0), "foo", 2),
(Vectors.dense(2.0,4.0,8.0), "foo", 2),
(Vectors.dense(2.0,4.0,10.0), "foo", 4),
(Vectors.dense(2.0,4.0,12.0), "foo", 3),
(Vectors.dense(2.0,4.0,14.0), "foo", 2),
(Vectors.dense(2.0,4.0,16.0), "foo", 1),
(Vectors.dense(2.0,4.0,18.0), "foo", 4),
(Vectors.dense(2.0,4.0,20.0), "foo", 4)
], ["features","values","labels"])

cnn = (ConditionalKNN().setOutputCol("prediction"))
cnnm =

test_df = spark.createDataFrame([
(Vectors.dense(2.0,2.0,2.0), "foo", 1, [0, 1]),
(Vectors.dense(2.0,2.0,4.0), "foo", 4, [0, 1]),
(Vectors.dense(2.0,2.0,6.0), "foo", 2, [0, 1]),
(Vectors.dense(2.0,2.0,8.0), "foo", 4, [0, 1]),
(Vectors.dense(2.0,2.0,10.0), "foo", 4, [0, 1])
], ["features","values","labels","conditioner"])


This code should log one run with a ConditionalKNNModel artifact and its parameters.