这篇文章旨在介绍我们使用MLflow的初步经验。
我们将通过记录所有探索性迭代,开始使用自己的跟踪服务器发现MLflow 。然后,我们将展示使用UDF将Spark与MLflow相关联的经验。

上下文

我们利用机器学习和人工智能的力量,使人们能够控制自己的健康和福祉。机器学习模型因此是我们正在开发的数据产品的核心,这就是为什么MLFLow,一个涵盖ML生命周期所有方面的开源平台引起了我们的注意。

MLflow

MLflow的主要目标是在ML之上提供额外的层,允许数据科学家与几乎任何机器学习库(h2o,keras,mleap,pytorch,sklearn和tensorflow)一起工作,同时,它将他们的工作带到另一个层次。
MLflow提供三个组件:

  • 跟踪  - 记录和查询实验:代码,数据,配置和结果。跟踪建模进度非常有用。
  • 项目  - 在任何平台( Sagemaker)上可重复运行的包装格式。
  • 模型  - 将模型发送到各种部署工具的通用格式。

MLflow(目前处于alpha版本)是一个管理ML生命周期的开源平台,包括实验,可重复性和部署。


设置MLflow

为了使用MLflow,我们首先需要设置所有Python环境以使用MLflow,我们将使用PyEnv 在Mac中设置Python)。这将提供一个虚拟环境,我们可以在其中安装运行它所需的所有库。

  1. pyenv install 3.7.0
  2. pyenv global 3.7.0 # Use Python 3.7
  3. mkvirtualenv mlflow # Create a Virtual Env with Python 3.7
  4. workon mlflow

安装所需的库

  1. pip install mlflow==0.7.0 \
  2. Cython==0.29 \
  3. numpy==1.14.5 \
  4. pandas==0.23.4 \
  5. pyarrow==0.11.0

注意:我们使用PyArrow将模型作为UDF启动。PyArrow和Numpy版本需要修复,因为最新的版本之间存在一些冲突。

启动跟踪UI

MLflow Tracking允许我们使用PythonREST API 记录和查询实验。此外,还可以定义我们将存储模型工件的位置(Localhost,Amazon S3Azure Blob存储Google云存储SFTP服务器)。由于我们使用AWS ,因此我们将尝试将S3作为工件存储。

  1. # Running a Tracking Server
  2. mlflow server \
  3. --file-store /tmp/mlflow/fileStore \
  4. --default-artifact-root s3://<bucket>/mlflow/artifacts/ \
  5. --host localhost
  6. --port 5000

MLflow建议使用持久性文件存储。这file-store是服务器存储运行和实验元数据的位置。因此,在运行服务器时,请确保这指向持久文件系统位置。在这里,我们只是/tmp用于实验。
请记住,如果我们想使用mlflow服务器运行旧实验,它们必须存在于文件存储中。但是,如果没有它们,我们仍然可以在UDF中使用它们,因为只需要模型路径。

注意:请记住跟踪UI,模型客户端必须能够访问工件位置。这意味着,无论跟踪UI是否在EC2实例上,如果我们在本地运行MLflow,我们的机器应该可以直接访问S3来编写工件模型。

1_z6iObWdxXOtcIj_cUk2gag.png

运行模型

跟踪服务器运行后,我们可以开始训练我们的模型。
作为一个例子,我们将使用MLflow Sklearn示例中提供的wine示例的修改。

  1. MLFLOW_TRACKING_URI=http://localhost:5000 python wine_quality.py \
  2. --alpha 0.9
  3. --l1_ration 0.5
  4. --wine_file ./data/winequality-red.csv

如前所述,MLflow允许记录模型的参数,度量和工件,因此我们可以跟踪这些在不同迭代中如何演变。此功能非常有用,因为我们可以通过检查Tracking Server来重现我们的最佳模型,或者验证哪些代码正在执行所需的迭代,因为它记录(免费)git哈希提交

  1. with mlflow.start_run():
  2. ... model ...
  3. mlflow.log_param("source", wine_path)
  4. mlflow.log_param("alpha", alpha)
  5. mlflow.log_param("l1_ratio", l1_ratio)
  6. mlflow.log_metric("rmse", rmse)
  7. mlflow.log_metric("r2", r2)
  8. mlflow.log_metric("mae", mae)
  9. mlflow.set_tag('domain', 'wine')
  10. mlflow.set_tag('predict', 'quality')
  11. mlflow.sklearn.log_model(lr, "model")

1_3soEGGuFumQXV5LSZNCnrA.png

服务模型

使用“ > mlflow服务器> 启动的> MLflow跟踪服务器还托管REST API,用于跟踪运行并将数据写入本地文件系统。您可以使用“ > MLFLOW_TRACKING_URI> 环境变量指定跟踪服务器URI,MLflow跟踪API会自动与该URI处的跟踪服务器通信,以创建/获取运行信息,记录指标等。
参考:文档//运行跟踪服务器
为了提供模型,我们只需要运行一个跟踪服务器参见启动UI)和一个模型运行ID

1_vBVbyT3F_YFjjfJuSDVrUA.png

  1. # Serve a sklearn model through 127.0.0.0:5005
  2. MLFLOW_TRACKING_URI=http://0.0.0.0:5000 mlflow sklearn serve \
  3. --port 5005 \
  4. --run_id 0f8691808e914d1087cf097a08730f17 \
  5. --model-path model

要使用MLflow服务功能为模型提供服务,我们需要访问跟踪UI,因此只需指定即可检索模型信息--run_id
一旦跟踪服务器为模型提供服务,我们就可以查询新的模型端点。

  1. # Query Tracking Server Endpoint
  2. curl -X POST \
  3. http://127.0.0.1:5005/invocations \
  4. -H 'Content-Type: application/json' \
  5. -d '[
  6. {
  7. "fixed acidity": 3.42,
  8. "volatile acidity": 1.66,
  9. "citric acid": 0.48,
  10. "residual sugar": 4.2,
  11. "chloridessssss": 0.229,
  12. "free sulfur dsioxide": 19,
  13. "total sulfur dioxide": 25,
  14. "density": 1.98,
  15. "pH": 5.33,
  16. "sulphates": 4.39,
  17. "alcohol": 10.8
  18. }
  19. ]'
  20. > {"predictions": [5.825055635303461]}

从Spark运行模型

虽然通过训练模型和使用服务功能(ref:mlflow // docs // models #local)实时为模型提供服务非常强大,但使用Spark(批量或流式传输)应用模型更是如此强大,因为它加入了分配力量。
想象一下,进行离线训练,然后以更简单的方式将输出模型应用于所有数据。这就是Spark和MLflow共同完美的地方。

安装PySpark + Jupyter + Spark

参考:PySpark开始 - Jupyter
展示我们如何将MLflow模型应用于Spark数据帧。我们需要使用PySpark设置Jupyter笔记本。

  1. 首先下载最新的稳定Apache Spark(当前版本2.3.2)。
  2. cd ~/Downloads/
  3. tar -xzf spark-2.3.2-bin-hadoop2.7.tgz
  4. mv ~/Downloads/spark-2.3.2-bin-hadoop2.7 ~/
  5. ln -s ~/spark-2.3.2-bin-hadoop2.7 ~/spark̀
  1. 在我们的virtualEnv中安装PySparkJupyter
  2. pip install pyspark jupyter
  1. 设置Environmnet变量
  2. export SPARK_HOME=~/spark
  3. export PATH=$SPARK_HOME/bin:$PATH
  4. export PYSPARK_DRIVER_PYTHON=jupyter
  5. export PYSPARK_DRIVER_PYTHON_OPTS="notebook --notebook-dir=${HOME}/Projects/notebooks"
  6. 通过定义notebook-dir,我们将能够将我们的笔记本存储和保存在所需的文件夹中。

从PySpark启动Jupyter

由于我们将Jupyter配置为PySpark驱动程序,现在我们可以使用附加到我们笔记本的PySpark上下文启动Jupyter。

  1. (mlflow) afranzi:~$ pyspark
  2. [I 19:05:01.572 NotebookApp] sparkmagic extension enabled!
  3. [I 19:05:01.573 NotebookApp] Serving notebooks from local directory: /Users/afranzi/Projects/notebooks
  4. [I 19:05:01.573 NotebookApp] The Jupyter Notebook is running at:
  5. [I 19:05:01.573 NotebookApp] http://localhost:8888/?token=c06252daa6a12cfdd33c1d2e96c8d3b19d90e9f6fc171745
  6. [I 19:05:01.573 NotebookApp] Use Control-C to stop this server and shut down all kernels (twice to skip confirmation).
  7. [C 19:05:01.574 NotebookApp]
  8. Copy/paste this URL into your browser when you connect for the first time,
  9. to login with a token:
  10. http://localhost:8888/?token=c06252daa6a12cfdd33c1d2e96c8d3b19d90e9f6fc171745

如上所示,MLflow提供了将模型工件记录到S3的功能。因此,一旦我们选择了一个模型,我们就可以使用该mlflow.pyfunc模块将其作为UDF导入。

  1. import mlflow.pyfunc
  2. model_path = 's3://<bucket>/mlflow/artifacts/1/0f8691808e914d1087cf097a08730f17/artifacts/model'
  3. wine_path = '/Users/afranzi/Projects/data/winequality-red.csv'
  4. wine_udf = mlflow.pyfunc.spark_udf(spark, model_path)
  5. df = spark.read.format("csv").option("header", "true").option('delimiter', ';').load(wine_path)
  6. columns = [ "fixed acidity", "volatile acidity", "citric acid",
  7. "residual sugar", "chlorides", "free sulfur dioxide",
  8. "total sulfur dioxide", "density", "pH",
  9. "sulphates", "alcohol"
  10. ]
  11. df.withColumn('prediction', wine_udf(*columns)).show(100, False)

1_hqSqC1493Tmu5-OHNcKhRg.png
到目前为止,我们已经展示了如何通过在我们所有的葡萄酒数据集中运行葡萄酒质量预测来将PySpark与MLflow结合使用。但是当您需要使用Scala Spark的Python MLflow模块时会发生什么?
我们还设法通过在Scala和Python之间共享Spark Context来测试它。这意味着我们注册的MLflow UDF在Python,然后从斯卡拉用它(叶氏,不是一个很好的解决方案,但至少它的东西🍭)。

Scala Spark + MLflow

对于此示例,我们将Toree 内核添加到现有的Jupyter中。
安装Spark + Toree + Jupyter

  1. pip install toree
  2. jupyter toree install --spark_home=/Users/afranzi/spark --sys-prefix
  3. jupyter kernelspec list
  1. Available kernels:
  2. apache_toree_scala /Users/afranzi/.virtualenvs/mlflow/share/jupyter/kernels/apache_toree_scala
  3. python3 /Users/afranzi/.virtualenvs/mlflow/share/jupyter/kernels/python3

正如您在附带的笔记本中看到的,UDF在Spark和PySpark之间共享。我们希望这最后一部分对那些喜欢Scala并且必须将ML模型投入生产的团队有所帮助。

  1. In [1]:
  2. import org.apache.spark.sql.functions.col
  3. import org.apache.spark.sql.types.StructType
  4. import org.apache.spark.sql.{Column, DataFrame}
  5. import scala.util.matching.Regex
  6. val FirstAtRe: Regex = "^_".r
  7. val AliasRe: Regex = "[\\s_.:@]+".r
  8. def getFieldAlias(field_name: String): String = {
  9. FirstAtRe.replaceAllIn(AliasRe.replaceAllIn(field_name, "_"), "")
  10. }
  11. def selectFieldsNormalized(columns: List[String])(df: DataFrame): DataFrame = {
  12. val fieldsToSelect: List[Column] = columns.map(field =>
  13. col(field).as(getFieldAlias(field))
  14. )
  15. df.select(fieldsToSelect: _*)
  16. }
  17. def normalizeSchema(df: DataFrame): DataFrame = {
  18. val schema = df.columns.toList
  19. df.transform(selectFieldsNormalized(schema))
  20. }
  21. FirstAtRe = ^_
  22. AliasRe = [\s_.:@]+
  23. getFieldAlias: (field_name: String)String
  24. selectFieldsNormalized: (columns: List[String])(df: org.apache.spark.sql.DataFrame)org.apache.spark.sql.DataFrame
  25. normalizeSchema: (df: org.apache.spark.sql.DataFrame)org.apache.spark.sql.DataFrame
  26. Out[1]:
  27. [\s_.:@]+
  28. In [2]:
  29. val winePath = "~/Research/mlflow-workshop/examples/wine_quality/data/winequality-red.csv"
  30. val modelPath = "/tmp/mlflow/artifactStore/0/96cba14c6e4b452e937eb5072467bf79/artifacts/model"
  31. winePath = ~/Research/mlflow-workshop/examples/wine_quality/data/winequality-red.csv
  32. modelPath = /tmp/mlflow/artifactStore/0/96cba14c6e4b452e937eb5072467bf79/artifacts/model
  33. Out[2]:
  34. /tmp/mlflow/artifactStore/0/96cba14c6e4b452e937eb5072467bf79/artifacts/model
  35. In [3]:
  36. val df = spark.read
  37. .format("csv")
  38. .option("header", "true")
  39. .option("delimiter", ";")
  40. .load(winePath)
  41. .transform(normalizeSchema)
  42. df = [fixed_acidity: string, volatile_acidity: string ... 10 more fields]
  43. Out[3]:
  44. [fixed_acidity: string, volatile_acidity: string ... 10 more fields]
  45. In [4]:
  46. %%PySpark
  47. import mlflow
  48. from mlflow import pyfunc
  49. model_path = "/tmp/mlflow/artifactStore/0/96cba14c6e4b452e937eb5072467bf79/artifacts/model"
  50. wine_quality_udf = mlflow.pyfunc.spark_udf(spark, model_path)
  51. spark.udf.register("wineQuality", wine_quality_udf)
  52. Out[4]:
  53. <function spark_udf.<locals>.predict at 0x1116a98c8>
  54. In [6]:
  55. df.createOrReplaceTempView("wines")
  56. In [10]:
  57. %%SQL
  58. SELECT
  59. quality,
  60. wineQuality(
  61. fixed_acidity,
  62. volatile_acidity,
  63. citric_acid,
  64. residual_sugar,
  65. chlorides,
  66. free_sulfur_dioxide,
  67. total_sulfur_dioxide,
  68. density,
  69. pH,
  70. sulphates,
  71. alcohol
  72. ) AS prediction
  73. FROM wines
  74. LIMIT 10
  75. Out[10]:
  76. +-------+------------------+
  77. |quality| prediction|
  78. +-------+------------------+
  79. | 5| 5.576883967129615|
  80. | 5| 5.50664776916154|
  81. | 5| 5.525504822954496|
  82. | 6| 5.504311247097457|
  83. | 5| 5.576883967129615|
  84. | 5|5.5556903912725755|
  85. | 5| 5.467882654744997|
  86. | 7| 5.710602976324739|
  87. | 7| 5.657319539336507|
  88. | 5| 5.345098606538708|
  89. +-------+------------------+
  90. In [17]:
  91. spark.catalog.listFunctions.filter('name like "%wineQuality%").show(20, false)
  92. +-----------+--------+-----------+---------+-----------+
  93. |name |database|description|className|isTemporary|
  94. +-----------+--------+-----------+---------+-----------+
  95. |wineQuality|null |null |null |true |
  96. +-----------+--------+-----------+---------+-----------+

下一步

尽管MLflow目前处于Alpha(🥁),但它看起来很有希望。只需能够运行多个机器学习框架并从同一端点使用它们,它就能将所有推荐系统提升到新的水平。
此外,MLflow 通过在它们之间建立公共层,使> 数据工程师和数据科学家> 更加接近 。>
在对MLflow进行这项研究之后,我们确信我们将进一步研究它并开始在Spark管道和我们的推荐系统中使用它。
让文件存储与数据库同步而不是使用FS会很好。这应该允许多个端点使用相同的文件存储。就像使用相同的Glue Metastore有多个PrestoAthena实例一样。
最后,感谢MLflow背后的所有社区,使其成为可能,让我们的数据更有趣。
如果您正在玩MLflow,请随时联系我们并提供有关您如何使用它的一些反馈!更重要的是,如果您在生产中使用MLflow。