Skip to content

Commit c2b6d0f

Browse files
authored
Update reference-migrate-sdk-v1-mlflow-tracking.md
1 parent 5cc9415 commit c2b6d0f

File tree

1 file changed

+9
-12
lines changed

1 file changed

+9
-12
lines changed

articles/machine-learning/reference-migrate-sdk-v1-mlflow-tracking.md

Lines changed: 9 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -22,22 +22,19 @@ If you're migrating from SDK v1 to SDK v2, use the information in this section t
2222

2323
## Why MLflow?
2424

25-
MLflow, with over 13 million monthly downloads, has become the standard platform for end-to-end MLOps, enabling teams of all sizes to track, share, package and deploy any model for batch or real-time inference. By integrating with MLflow, your training code will not need to hold any specific code related to Azure Machine Learning, achieving true portability and seamless integration with other open-source platforms.
25+
MLflow, with over 13 million monthly downloads, has become the standard platform for end-to-end MLOps, enabling teams of all sizes to track, share, package and deploy any model for batch or real-time inference. Azure Machine Learning integrates with MLflow, which enables your training code to achieve true portability and seamless integration with other platforms since it doesn't hold any Azure Machine Learning specific instructions.
2626

2727
## Prepare for migrating to MLflow
2828

29-
To use MLflow tracking, you will need to install `mlflow` and `azureml-mlflow` Python packages. All Azure Machine Learning environments have these packages already available for you but you will need to include them if creating your own environment.
29+
To use MLflow tracking, you need to install Mlflow SDK package `mlflow` and Azure Machine Learning plug-in for MLflow `azureml-mlflow`. All Azure Machine Learning environments have these packages already available for you but you need to include them if creating your own environment.
3030

3131
```bash
3232
pip install mlflow azureml-mlflow
3333
```
3434

35-
> [!TIP]
36-
> You can use the [`mlflow-skinny`](https://github.com/mlflow/mlflow/blob/master/README_SKINNY.rst) which is a lightweight MLflow package without SQL storage, server, UI, or data science dependencies. This is recommended for users who primarily need the tracking and logging capabilities without importing the full suite of MLflow features including deployments.
37-
3835
## Connect to your workspace
3936

40-
Azure Machine Learning allows users to perform tracking in training jobs running on your workspace or running remotely (tracking experiments running outside Azure Machine Learning). If performing remote tracking, you will need to indicate the workspace you want to connect MLflow to.
37+
Azure Machine Learning allows users to perform tracking in training jobs running on your workspace or running remotely (tracking experiments running outside Azure Machine Learning). If performing remote tracking, you need to indicate the workspace you want to connect MLflow to.
4138

4239
# [Azure Machine Learning compute](#tab/aml)
4340

@@ -51,7 +48,7 @@ You are already connected to your workspace when running on Azure Machine Learni
5148

5249
**Configure authentication**
5350

54-
Once the tracking is configured, you'll also need to configure how the authentication needs to happen to the associated workspace. By default, the Azure Machine Learning plugin for MLflow will perform interactive authentication by opening the default browser to prompt for credentials. Refer to [Configure MLflow for Azure Machine Learning: Configure authentication](how-to-use-mlflow-configure-tracking.md#configure-authentication) for more ways to configure authentication for MLflow in Azure Machine Learning workspaces.
51+
Once the tracking is configured, you also need to configure how the authentication needs to happen to the associated workspace. By default, the Azure Machine Learning plugin for MLflow performs interactive authentication by opening the default browser to prompt for credentials. Refer to [Configure MLflow for Azure Machine Learning: Configure authentication](how-to-use-mlflow-configure-tracking.md#configure-authentication) for more ways to configure authentication for MLflow in Azure Machine Learning workspaces.
5552

5653
[!INCLUDE [configure-mlflow-auth](../../includes/machine-learning-mlflow-configure-auth.md)]
5754

@@ -121,7 +118,7 @@ __SDK v2 with MLflow__
121118
mlflow.log_text("sample_string_text", "string.txt")
122119
```
123120

124-
* The string will be logged as an _artifact_, not as a metric. In Azure Machine Learning studio, the value will be displayed in the __Outputs + logs__ tab.
121+
* The string is logged as an _artifact_, not as a metric. In Azure Machine Learning studio, the value is displayed in the __Outputs + logs__ tab.
125122

126123
### Log an image to a PNG or JPEG file
127124

@@ -137,7 +134,7 @@ __SDK v2 with MLflow__
137134
mlflow.log_artifact("Azure.png")
138135
```
139136

140-
The image is logged as an artifact and will appear in the __Images__ tab in Azure Machine Learning Studio.
137+
The image is logged as an artifact and it appears in the __Images__ tab in Azure Machine Learning Studio.
141138

142139
### Log a matplotlib.pyplot
143140

@@ -161,7 +158,7 @@ ax.plot([0, 1], [2, 3])
161158
mlflow.log_figure(fig, "sample_pyplot.png")
162159
```
163160

164-
* The image is logged as an artifact and will appear in the __Images__ tab in Azure Machine Learning Studio.
161+
* The image is logged as an artifact and it appears in the __Images__ tab in Azure Machine Learning Studio.
165162

166163
### Log a list of metrics
167164

@@ -345,7 +342,7 @@ mlflow.log_dict(RESIDUALS, 'mlflow_residuals.json')
345342
You can access run information using the properties `data` and `info` of the MLflow [run (mlflow.entities.Run)](https://mlflow.org/docs/latest/python_api/mlflow.entities.html#mlflow.entities.Run) object.
346343

347344
> [!TIP]
348-
> Experiments and runs tracking information in Azure Machine Learning can be queried using MLflow, which provides a comprehensive search API to query and search for experiments and runs easily, and quickly compare results. For more information about all the capabilities in MLflow in this dimension see [Query & compare experiments and runs with MLflow](how-to-track-experiments-mlflow.md)
345+
> Experiments and runs tracking information in Azure Machine Learning can be queried using MLflow, which provides a comprehensive search API to query and search for experiments and runs easily, and quickly compare results. For more information about all the capabilities in MLflow in this dimension, see [Query & compare experiments and runs with MLflow](how-to-track-experiments-mlflow.md)
349346
350347
The following example shows how to retrieve a finished run:
351348

@@ -406,7 +403,7 @@ mlflow.artifacts.download_artifacts(run_id=finished_mlflow_run.info.run_id, arti
406403
## Next steps
407404
408405
* [Track ML experiments and models with MLflow](how-to-use-mlflow-cli-runs.md).
409-
* [Log metrics, parameters and files with MLflow](how-to-log-view-metrics).
406+
* [Log metrics, parameters and files with MLflow](how-to-log-view-metrics.md).
410407
* [Logging MLflow models](how-to-log-mlflow-models.md).
411408
* [Query & compare experiments and runs with MLflow](how-to-track-experiments-mlflow.md).
412409
* [Manage models registries in Azure Machine Learning with MLflow](how-to-manage-models-mlflow.md).

0 commit comments

Comments
 (0)