你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

分析模型,确定资源利用率

适用于:Azure CLI ml 扩展 v1Python SDK azureml v1

本文介绍如何分析机器学习模型,以确定在将模型部署为 Web 服务时需要为该模型分配多少 CPU 和内存。

重要

本文适用于 CLI v1 和 SDK v1。 此分析技术不适用于 v2 版本的 CLI 或 SDK。

重要

本文中的一些 Azure CLI 命令使用适用于 Azure 机器学习的 azure-cli-ml 或 v1 扩展。 对 v1 扩展的支持将于 2025 年 9 月 30 日结束。 在该日期之前,你将能够安装和使用 v1 扩展。

建议在 2025 年 9 月 30 日之前转换为 ml 或 v2 扩展。 有关 v2 扩展的详细信息,请参阅 Azure ML CLI 扩展和 Python SDK v2

必备条件

本文假设你已通过 Azure 机器学习训练并注册了一个模型。 有关使用 Azure 机器学习训练和注册 scikit-learn 模型的示例,请参阅此处的示例教程

限制

  • 当工作区的 Azure 容器注册表 (ACR) 位于虚拟网络之后时,分析将不起作用。

运行探查器

注册模型并准备好部署所需的其他组件后,即可确定部署的服务将需要的 CPU 和内存。 分析可测试运行模型并返回 CPU 使用情况、内存使用情况和响应延迟等信息的服务。 它还根据资源使用情况提供 CPU 和内存建议。

若要分析模型,你需要:

  • 已注册的模型。
  • 基于入口脚本和推理环境定义的推理配置。
  • 单列表格数据集,其中的每行都包含一个表示示例请求数据的字符串。

重要

目前,我们仅支持分析预期其请求数据为字符串的服务,例如:字符串序列化 json、文本、字符串序列化图像等。数据集的每一行的内容(字符串)都会放入 HTTP 请求的正文中,然后会被发送到可以对评分模型进行封装的服务。

重要

我们仅支持在 ChinaEast2 和 USGovArizona 区域中对最多 2 个 CPU 进行分析。

下面是一个示例,说明了如何构造用于分析服务的输入数据集,该服务预期其传入请求数据包含序列化 json。 在此示例中,我们创建了一个数据集,该数据集基于 100 个请求数据内容相同的实例。 在实际方案中,建议使用包含各种输入的更大数据集,尤其是在模型资源使用/行为是依赖于输入的情况下。

适用于:Python SDK azureml v1

import json
from azureml.core import Datastore
from azureml.core.dataset import Dataset
from azureml.data import dataset_type_definitions

input_json = {'data': [[1, 2, 3, 4, 5, 6, 7, 8, 9, 10],
                       [10, 9, 8, 7, 6, 5, 4, 3, 2, 1]]}
# create a string that can be utf-8 encoded and
# put in the body of the request
serialized_input_json = json.dumps(input_json)
dataset_content = []
for i in range(100):
    dataset_content.append(serialized_input_json)
dataset_content = '\n'.join(dataset_content)
file_name = 'sample_request_data.txt'
f = open(file_name, 'w')
f.write(dataset_content)
f.close()

# upload the txt file created above to the Datastore and create a dataset from it
data_store = Datastore.get_default(ws)
data_store.upload_files(['./' + file_name], target_path='sample_request_data')
datastore_path = [(data_store, 'sample_request_data' +'/' + file_name)]
sample_request_data = Dataset.Tabular.from_delimited_files(
    datastore_path, separator='\n',
    infer_column_types=True,
    header=dataset_type_definitions.PromoteHeadersBehavior.NO_HEADERS)
sample_request_data = sample_request_data.register(workspace=ws,
                                                   name='sample_request_data',
                                                   create_new_version=True)

准备好包含示例请求数据的数据集后,即可创建推理配置。 推理配置基于 score.py 和环境定义。 以下示例演示如何创建推理配置和运行分析:

from azureml.core.model import InferenceConfig, Model
from azureml.core.dataset import Dataset


model = Model(ws, id=model_id)
inference_config = InferenceConfig(entry_script='path-to-score.py',
                                   environment=myenv)
input_dataset = Dataset.get_by_name(workspace=ws, name='sample_request_data')
profile = Model.profile(ws,
            'unique_name',
            [model],
            inference_config,
            input_dataset=input_dataset)

profile.wait_for_completion(True)

# see the result
details = profile.get_details()

适用于:Azure CLI ml 扩展 v1

以下命令演示如何使用 CLI 分析模型:

az ml model profile -g <resource-group-name> -w <workspace-name> --inference-config-file <path-to-inf-config.json> -m <model-id> --idi <input-dataset-id> -n <unique-name>

提示

要保留分析步骤所返回的信息,请为模型使用标记或属性。 使用标记或属性在模型注册表中存储模型数据。 以下示例演示添加包含 requestedCpurequestedMemoryInGb 信息的新标记:

model.add_tags({'requestedCpu': details['requestedCpu'],
                'requestedMemoryInGb': details['requestedMemoryInGb']})
az ml model profile -g <resource-group-name> -w <workspace-name> --i <model-id> --add-tag requestedCpu=1 --add-tag requestedMemoryInGb=0.5

后续步骤