監視部署至實際執行環境的模型效能

發行項
10/16/2024

適用於：Azure CLI ml 延伸模組 v2 (目前)Python SDK azure-ai-ml v2 (目前)

瞭解如何使用 Azure Machine Learning 的模型監視，持續追蹤生產環境中機器學習模型的效能。模型監視可讓您廣泛檢視監視訊號和警示，以發現潛在問題。您監視生產階段模型的訊號和效能計量時，可以對與其相關聯的固有風險進行審慎評估，並找出可能對您的業務造成負面影響的盲點。

在本文中，您將瞭解如何執行下列工作：

針對部署至 Azure Machine Learning 線上端點的模型執行立即可用和進階監視設定
針對生產環境中的模型監視效能計量
針對部署在 Azure Machine Learning 外部或部署至 Azure Machine Learning 批次端點的模型設定監視
使用自訂訊號和計量設定模型監視
解譯監視結果
整合 Azure Machine Learning 模型監視與 Azure 事件方格

必要條件

遵循本文中的步驟之前，請確定您已滿足下列必要條件：

Azure CLI 和 Azure CLI 的 ml 擴充功能。如需詳細資訊，請參閱安裝、設定和使用 CLI (v2)。

重要

本文中的 CLI 範例假設您使用 Bash (或相容的) 殼層。例如，從 Linux 系統或 Windows 子系統 Linux 版。
Azure Machine Learning 工作區。如果沒有，請依安裝、設定和使用 CLI (v2) 中的步驟建立。

遵循本文中的步驟之前，請確定您已滿足下列必要條件：

Azure Machine Learning 工作區。如果您沒有工作區資源，請依快速入門：建立工作區資源一文中的步驟來建立工作區資源。
若要安裝 Python SDK v2，請使用下列命令：
```
pip install azure-ai-ml azure-identity
```
若要將現有的 SDK 安裝更新為最新版本，請使用下列命令：
```
pip install --upgrade azure-ai-ml azure-identity
```
如需詳細資訊，請參閱安裝適用於 Azure Machine Learning 的 Python SDK 第 2 版。

Azure 角色型存取控制 (Azure RBAC) 可用來授與 Azure Machine Learning 作業的存取權。若要執行本文中的步驟，您必須為使用者帳戶指派 Azure Machine Learning 工作區的擁有者或參與者角色，或允許 Microsoft.MachineLearningServices/workspaces/onlineEndpoints/* 的自訂角色。如需詳細資訊，請參閱管理對 Azure Machine Learning 工作區的存取。
若要監視部署至 Azure Machine Learning 線上端點的模型 (受控線上端點或 Kubernetes 線上端點)，請務必：
- 已將模型部署至 Azure Machine Learning 線上端點。支援受控線上端點和 Kubernetes 線上端點。如果您沒有部署至 Azure Machine Learning 線上端點的模型，請參閱使用線上端點部署和評分機器學習模型。
- 啟用模型部署的資料收集。您可以在 Azure Machine Learning 線上端點的部署步驟期間啟用資料收集。如需詳細資訊，請參閱從部署至即時端點的模型收集生產資料。
若要監視部署至 Azure Machine Learning 批次端點或部署在 Azure Machine Learning 外部的模型，請務必：
- 有方法可以收集生產資料，並將其註冊為 Azure Machine Learning 資料資產。
- 持續更新已註冊的資料資產以進行模型監視。
- (建議) 在 Azure Machine Learning 工作區中註冊模型以進行資料譜系追蹤。

重要

模型監視作業已排程在無伺服器 Spark 計算集區上執行，且支援下列 VM 執行個體類型：Standard_E4s_v3、Standard_E8s_v3、Standard_E16s_v3、Standard_E32s_v3 和 Standard_E64s_v3。您可以使用 YAML 組態中的 create_monitor.compute.instance_type 屬性，或從 Azure Machine Learning 工作室的下拉式清單中選取 VM 執行個體類型。

設定立即可用的模型監視

假設您將模型部署至 Azure Machine Learning 線上端點中的實際執行環境，並在部署時間啟用資料收集。在此案例中，Azure Machine Learning 會收集生產推斷資料，並將其自動儲存在 Microsoft Azure Blob 儲存體中。然後，您可以使用 Azure Machine Learning 模型監視來持續監視此生產推斷資料。

您可以使用 Azure CLI、Python SDK 或工作室進行立即可用的模型監視設定。立即可用的模型監視組態提供下列監視功能：

Azure Machine Learning 會自動偵測與 Azure Machine Learning 線上部署相關聯的生產推斷資料集，並使用資料集進行模型監視。
比較參考資料集會設定為最近的過去生產推斷資料集。
監視設定會自動包含並追蹤內建的監視訊號：資料漂移、預測漂移和資料品質。針對每個監視訊號，Azure Machine Learning 會使用：
- 最近的過去生產推斷資料集作為比較參考資料集。
- 計量和閾值的智慧預設值。
監視作業排定於每天上午 3:15 (在此範例中) 執行，以取得監視訊號，並根據其對應的閾值評估每個計量結果。根據預設，當超過任何閾值時，Azure Machine Learning 會將警示電子郵件傳送給設定監視的使用者。

Azure Machine Learning 模型監視會使用 az ml schedule 來排程監視作業。您可以使用下列 CLI 命令和 YAML 定義來建立立即可用的模型監視：

az ml schedule create -f ./out-of-box-monitoring.yaml

下列 YAML 包含立即可用模型監視的定義。

# out-of-box-monitoring.yaml
$schema:  http://azureml/sdk-2-0/Schedule.json
name: credit_default_model_monitoring
display_name: Credit default model monitoring
description: Credit default model monitoring setup with minimal configurations

trigger:
  # perform model monitoring activity daily at 3:15am
  type: recurrence
  frequency: day #can be minute, hour, day, week, month
  interval: 1 # #every day
  schedule: 
    hours: 3 # at 3am
    minutes: 15 # at 15 mins after 3am

create_monitor:

  compute: # specify a spark compute for monitoring job
    instance_type: standard_e4s_v3
    runtime_version: "3.3"

  monitoring_target: 
    ml_task: classification # model task type: [classification, regression, question_answering]
    endpoint_deployment_id: azureml:credit-default:main # azureml endpoint deployment id

  alert_notification: # emails to get alerts
    emails:
      - abc@example.com
      - def@example.com

您可以使用下列程式碼來設定立即可用的模型監視：

from azure.identity import DefaultAzureCredential
from azure.ai.ml import MLClient
from azure.ai.ml.entities import (
    AlertNotification,
    MonitoringTarget,
    MonitorDefinition,
    MonitorSchedule,
    RecurrencePattern,
    RecurrenceTrigger,
    ServerlessSparkCompute
)

# get a handle to the workspace
ml_client = MLClient(
    DefaultAzureCredential(),
    subscription_id="subscription_id",
    resource_group_name="resource_group_name",
    workspace_name="workspace_name",
)

# create the compute
spark_compute = ServerlessSparkCompute(
    instance_type="standard_e4s_v3",
    runtime_version="3.3"
)

# specify your online endpoint deployment
monitoring_target = MonitoringTarget(
    ml_task="classification",
    endpoint_deployment_id="azureml:credit-default:main"
)


# create alert notification object
alert_notification = AlertNotification(
    emails=['abc@example.com', 'def@example.com']
)

# create the monitor definition
monitor_definition = MonitorDefinition(
    compute=spark_compute,
    monitoring_target=monitoring_target,
    alert_notification=alert_notification
)

# specify the schedule frequency
recurrence_trigger = RecurrenceTrigger(
    frequency="day",
    interval=1,
    schedule=RecurrencePattern(hours=3, minutes=15)
)

# create the monitor
model_monitor = MonitorSchedule(
    name="credit_default_monitor_basic",
    trigger=recurrence_trigger,
    create_monitor=monitor_definition
)

poller = ml_client.schedules.begin_create_or_update(model_monitor)
created_monitor = poller.result()

設定進階模型監視

Azure Machine Learning 提供許多持續模型監視的功能。如需這些功能的完整清單，請參閱模型監視的功能。在許多情況下，您需要使用進階監視功能來設定模型監視。在下列各節中，您會使用這些功能來設定模型監視：

使用多個監視訊號進行廣泛檢視。
使用歷程記錄模型定型資料或驗證資料作為比較參考資料集。
監視前 N 個最重要的功能和個別功能。

設定特徵重要性

特徵重要性代表每個輸入特徵對模型輸出的相對重要性。例如，temperature 相較於 elevation，對於模型預測可能更為重要。啟用特徵重要性可讓您查看不想漂移或避免實際執行環境中發生資料品質問題的功能。

若要啟用任何訊號的特徵重要性 (例如資料漂移或資料品質)，您需要提供：

您的定型資料集作為 reference_data 資料集。
reference_data.data_column_names.target_column 屬性，這是模型輸出/預測資料行的名稱。

啟用特徵重要性之後，您會看到您在 Azure Machine Learning 模型監視工作室 UI 中所監視每個功能的特徵重要性。

您可以使用 Azure CLI、Python SDK 或工作室來進階設定模型監視。

使用下列 CLI 命令和 YAML 定義建立進階模型監視設定：

az ml schedule create -f ./advanced-model-monitoring.yaml

下列 YAML 包含進階模型監視的定義。

# advanced-model-monitoring.yaml
$schema:  http://azureml/sdk-2-0/Schedule.json
name: fraud_detection_model_monitoring
display_name: Fraud detection model monitoring
description: Fraud detection model monitoring with advanced configurations

trigger:
  # perform model monitoring activity daily at 3:15am
  type: recurrence
  frequency: day #can be minute, hour, day, week, month
  interval: 1 # #every day
  schedule: 
    hours: 3 # at 3am
    minutes: 15 # at 15 mins after 3am

create_monitor:

  compute: 
    instance_type: standard_e4s_v3
    runtime_version: "3.3"

  monitoring_target:
    ml_task: classification
    endpoint_deployment_id: azureml:credit-default:main
  
  monitoring_signals:
    advanced_data_drift: # monitoring signal name, any user defined name works
      type: data_drift
      # reference_dataset is optional. By default referece_dataset is the production inference data associated with Azure Machine Learning online endpoint
      reference_data:
        input_data:
          path: azureml:credit-reference:1 # use training data as comparison reference dataset
          type: mltable
        data_context: training
        data_column_names:
          target_column: DEFAULT_NEXT_MONTH
      features: 
        top_n_feature_importance: 10 # monitor drift for top 10 features
      metric_thresholds:
        numerical:
          jensen_shannon_distance: 0.01
        categorical:
          pearsons_chi_squared_test: 0.02
    advanced_data_quality:
      type: data_quality
      # reference_dataset is optional. By default reference_dataset is the production inference data associated with Azure Machine Learning online endpoint
      reference_data:
        input_data:
          path: azureml:credit-reference:1
          type: mltable
        data_context: training
      features: # monitor data quality for 3 individual features only
        - SEX
        - EDUCATION
      metric_thresholds:
        numerical:
          null_value_rate: 0.05
        categorical:
          out_of_bounds_rate: 0.03

    feature_attribution_drift_signal:
      type: feature_attribution_drift
      # production_data: is not required input here
      # Please ensure Azure Machine Learning online endpoint is enabled to collected both model_inputs and model_outputs data
      # Azure Machine Learning model monitoring will automatically join both model_inputs and model_outputs data and used it for computation
      reference_data:
        input_data:
          path: azureml:credit-reference:1
          type: mltable
        data_context: training
        data_column_names:
          target_column: DEFAULT_NEXT_MONTH
      metric_thresholds:
        normalized_discounted_cumulative_gain: 0.9
  
  alert_notification:
    emails:
      - abc@example.com
      - def@example.com

使用下列程式碼進行進階模型監視設定：

from azure.identity import DefaultAzureCredential
from azure.ai.ml import Input, MLClient
from azure.ai.ml.constants import (
    MonitorDatasetContext,
)
from azure.ai.ml.entities import (
    AlertNotification,
    BaselineDataRange,
    DataDriftSignal,
    DataQualitySignal,
    PredictionDriftSignal,
    DataDriftMetricThreshold,
    DataQualityMetricThreshold,
    FeatureAttributionDriftMetricThreshold,
    FeatureAttributionDriftSignal,
    PredictionDriftMetricThreshold,
    NumericalDriftMetrics,
    CategoricalDriftMetrics,
    DataQualityMetricsNumerical,
    DataQualityMetricsCategorical,
    MonitorFeatureFilter,
    MonitoringTarget,
    MonitorDefinition,
    MonitorSchedule,
    RecurrencePattern,
    RecurrenceTrigger,
    ServerlessSparkCompute,
    ReferenceData,
    ProductionData
)

# get a handle to the workspace
ml_client = MLClient(
    DefaultAzureCredential(),
    subscription_id="subscription_id",
    resource_group_name="resource_group_name",
    workspace_name="workspace_name",
)

# create your compute
spark_compute = ServerlessSparkCompute(
    instance_type="standard_e4s_v3",
    runtime_version="3.3"
)

# specify the online deployment (if you have one)
monitoring_target = MonitoringTarget(
    ml_task="classification",
    endpoint_deployment_id="azureml:credit-default:main"
)

# specify a lookback window size and offset, or omit this to use the defaults, which are specified in the documentation
data_window = BaselineDataRange(lookback_window_size="P1D", lookback_window_offset="P0D")

production_data = ProductionData(
    input_data=Input(
        type="uri_folder",
        path="azureml:credit-default-main-model_inputs:1"
    ),
    data_window=data_window,
    data_context=MonitorDatasetContext.MODEL_INPUTS,
)

# training data to be used as reference dataset
reference_data_training = ReferenceData(
    input_data=Input(
        type="mltable",
        path="azureml:credit-default-reference:1"
    ),
    data_column_names={
        "target_column":"DEFAULT_NEXT_MONTH"
    },
    data_context=MonitorDatasetContext.TRAINING,
)

# create an advanced data drift signal
features = MonitorFeatureFilter(top_n_feature_importance=10)

metric_thresholds = DataDriftMetricThreshold(
    numerical=NumericalDriftMetrics(
        jensen_shannon_distance=0.01
    ),
    categorical=CategoricalDriftMetrics(
        pearsons_chi_squared_test=0.02
    )
)

advanced_data_drift = DataDriftSignal(
    reference_data=reference_data_training,
    features=features,
    metric_thresholds=metric_thresholds
)

# create an advanced prediction drift signal
metric_thresholds = PredictionDriftMetricThreshold(
    categorical=CategoricalDriftMetrics(
        jensen_shannon_distance=0.01
    )
)

advanced_prediction_drift = PredictionDriftSignal(
    reference_data=reference_data_training,
    metric_thresholds=metric_thresholds
)

# create an advanced data quality signal
features = ['SEX', 'EDUCATION', 'AGE']

metric_thresholds = DataQualityMetricThreshold(
    numerical=DataQualityMetricsNumerical(
        null_value_rate=0.01
    ),
    categorical=DataQualityMetricsCategorical(
        out_of_bounds_rate=0.02
    )
)

advanced_data_quality = DataQualitySignal(
    reference_data=reference_data_training,
    features=features,
    metric_thresholds=metric_thresholds,
    alert_enabled=False
)

# create feature attribution drift signal
metric_thresholds = FeatureAttributionDriftMetricThreshold(normalized_discounted_cumulative_gain=0.9)

feature_attribution_drift = FeatureAttributionDriftSignal(
    reference_data=reference_data_training,
    metric_thresholds=metric_thresholds,
    alert_enabled=False
)

# put all monitoring signals in a dictionary
monitoring_signals = {
    'data_drift_advanced':advanced_data_drift,
    'data_quality_advanced':advanced_data_quality,
    'feature_attribution_drift':feature_attribution_drift,
}

# create alert notification object
alert_notification = AlertNotification(
    emails=['abc@example.com', 'def@example.com']
)

# create the monitor definition
monitor_definition = MonitorDefinition(
    compute=spark_compute,
    monitoring_target=monitoring_target,
    monitoring_signals=monitoring_signals,
    alert_notification=alert_notification
)

# specify the frequency on which to run your monitor
recurrence_trigger = RecurrenceTrigger(
    frequency="day",
    interval=1,
    schedule=RecurrencePattern(hours=3, minutes=15)
)

# create your monitor
model_monitor = MonitorSchedule(
    name="credit_default_monitor_advanced",
    trigger=recurrence_trigger,
    create_monitor=monitor_definition
)

poller = ml_client.schedules.begin_create_or_update(model_monitor)
created_monitor = poller.result()

若要設定進階監視：

完成基本設定頁面上的項目，如先前的設定立即可用模型監視一節中所述。
選取 [下一步] 以開啟 [進階設定] 區段的 [設定資料資產] 頁面。
[新增] 要作為參考資料集的資料集。建議您使用模型定型資料作為資料漂移和資料品質的比較參考資料集。此外，使用模型驗證資料作為預測漂移的比較參考資料集。
選取 [下一步] 以移至 [選取監視訊號] 頁面。在此頁面上，您會看到已新增的一些監視訊號 (如果您稍早選取 Azure Machine Learning 線上部署)。訊號 (資料漂移、預測漂移和資料品質) 會使用最近的過去生產資料作為比較參考資料集，並使用智慧型預設值作為計量和閾值。
選取資料漂移訊號旁的 [編輯]。
在 [編輯訊號] 視窗中設定資料漂移，如下所示：
1. 在步驟 1 中，針對生產資料資產，選取您的模型輸入資料集。另外，可選取下列項目：
  - 選取所需的回顧視窗大小。
2. 在步驟 2 中，對於參考資料集，選取定型資料集。另外，可選取下列項目：
  - 選取目標 (輸出) 資料行。
3. 在步驟 3 中，選取以監視前 N 個最重要特徵的漂移，或監視特定一組特徵的漂移。
4. 在步驟 4 中，選取您慣用的計量和閾值，以用於數值特徵。
5. 在步驟 5 中，選取您慣用的計量和閾值，以用於類別功能。
選取 [儲存] 以返回 [選取監視訊號] 頁面。
選取 [新增] 以開啟 [編輯訊號] 視窗。
選取 [功能屬性漂移]，以設定功能屬性漂移訊號，如下所示：
1. 在步驟 1 中，選取具有模型輸入的生產資料資產
  - 此外，請選取所需的回顧視窗大小。
2. 在步驟 2 中，選取有模型輸出的生產資料資產。
  - 另外，選取這些資料資產之間的通用資料行，以聯結它們。如果使用資料收集器收集資料，則通用資料行為 correlationid。
3. (選擇性) 如果您使用資料收集器收集模型輸入和輸出已聯結的資料，請選取聯結的資料集做為生產資料資產 (在步驟 1 中)
  - 此外，在設定面板中移除步驟 2。
4. 在步驟 3 中，選取要做為參考資料集的定型資料集。
  - 另外，選取定型資料集的目標 (輸出) 資料行。
5. 在步驟 4 中，選取您慣用的計量和閾值。
選取 [儲存] 以返回 [選取監視訊號] 頁面。
完成監視訊號設定後，請選取 [下一步] 以移至 [通知] 頁面。
在 [通知] 頁面上，啟用每個訊號的警示通知，然後選取 [下一步]。
在 [檢閱監視設定] 頁面上檢閱您的設定。
選取 [建立] 以建立進階模型監視。

設定模型效能監視

Azure Machine Learning 模型監視可讓您計算其效能計量，以追蹤生產環境中模型的效能。目前支援下列模型效能計量：

對於分類模型：

精確度
準確率
重新叫用

對於迴歸模型：

平均絕對誤差 (MAE)
平均平方誤差 (MSE)
均方根誤差 (RMSE)

使用資料收集器時監視模型效能需求

如果您使用 Azure Machine Learning 資料收集器收集生產推斷資料，而不需為每個資料列提供自己的唯一識別碼做為個別資料行，系統就會為您自動產生 correlationid，並包含在記錄的 JSON 物件中。不過，資料收集器會批次處理資料列，彼此在短時間間隔內傳送。批次資料列會落在相同的 JSON 物件內，因此會有相同的 correlationid。

為了區分相同 JSON 物件中的資料列，Azure Machine Learning 模型效能監視會使用索引來判斷 JSON 物件中的資料列順序。例如，如果三個資料列批處理在一起，而且 correlationid 是 test，第一個資料列會有 test_0 的識別碼，第二個資料列會有 test_1 的識別碼，而第三個資料列會有 test_2 的識別碼。為了確保您的有根據事實資料集包含符合所收集生產推斷模型輸出的唯一識別碼，請確定妥善對於每個 correlationid 編製索引。如果您記錄的 JSON 物件只有一個資料列，則 correlationid 會是 correlationid_0。

若要避免使用此索引編製，建議您在 pandas DataFrame 內，使用 Azure Machine Learning 資料收集器記錄的唯一識別碼。然後，在模型監視設定中，您可以指定此資料行的名稱，以將模型輸出資料與您的有根據事實資料聯結。只要這兩個資料集中的每個資料列識別碼都相同，Azure Machine Learning 模型監視就可以執行模型效能監視。

監視模型效能的範例工作流程

若要瞭解與模型效能監視相關聯的概念，請考慮此範例工作流程。假設您要部署模型來預測信用卡交易是否為詐騙，您可以遵循下列步驟來監視模型的效能：

將您的部署設定為使用資料收集器來收集模型的生產推斷資料 (輸入和輸出資料)。假設輸出資料會儲存在資料行 is_fraud 中。
針對所收集推斷資料的每個資料列，記錄唯一識別碼。唯一識別碼可以來自您的應用程式，或者您可以使用 Azure Machine Learning 針對每個記錄的 JSON 物件唯一產生的 correlationid。
稍後，有根據事實 (或實際) is_fraud 資料可供使用時，也會記錄並對應至與模型輸出記錄的相同唯一識別碼。
這項有根據事實 is_fraud 資料也會收集、維護和註冊至 Azure Machine Learning 做為資料資產。
使用唯一識別碼資料行，建立模型效能監視訊號，以聯結模型的生產推斷和有根據事實資料資產。
最後，計算模型效能計量。

滿足模型效能計量的必要條件之後，您可以使用下列 CLI 命令和 YAML 定義來設定模型監視：

az ml schedule create -f ./model-performance-monitoring.yaml

下列 YAML 包含模型監視的定義，其中包含您已收集的生產推斷資料。

$schema:  http://azureml/sdk-2-0/Schedule.json
name: model_performance_monitoring
display_name: Credit card fraud model performance
description: Credit card fraud model performance

trigger:
  type: recurrence
  frequency: day
  interval: 7 
  schedule: 
    hours: 10
    minutes: 15
  
create_monitor:
  compute: 
    instance_type: standard_e8s_v3
    runtime_version: "3.3"
  monitoring_target:
    ml_task: classification
    endpoint_deployment_id: azureml:loan-approval-endpoint:loan-approval-deployment

  monitoring_signals:
    fraud_detection_model_performance: 
      type: model_performance 
      production_data:
        data_column_names:
          prediction: is_fraud
          correlation_id: correlation_id
      reference_data:
        input_data:
          path: azureml:my_model_ground_truth_data:1
          type: mltable
        data_column_names:
          actual: is_fraud
          correlation_id: correlation_id
        data_context: actuals
      alert_enabled: true
      metric_thresholds: 
        tabular_classification:
          accuracy: 0.95
          precision: 0.8
  alert_notification: 
      emails: 
        - abc@example.com

滿足模型效能計量的必要條件之後，您可以使用下列 Python 程式碼來設定模型監視：

from azure.identity import DefaultAzureCredential
from azure.ai.ml import Input, MLClient
from azure.ai.ml.constants import (
    MonitorDatasetContext,
)
from azure.ai.ml.entities import (
    AlertNotification,
    BaselineDataRange,
    ModelPerformanceMetricThreshold,
    ModelPerformanceSignal,
    ModelPerformanceClassificationThresholds,
    MonitoringTarget,
    MonitorDefinition,
    MonitorSchedule,
    RecurrencePattern,
    RecurrenceTrigger,
    ServerlessSparkCompute,
    ReferenceData,
    ProductionData
)

# get a handle to the workspace
ml_client = MLClient(
    DefaultAzureCredential(),
    subscription_id="subscription_id",
    resource_group_name="resource_group_name",
    workspace_name="workspace_name",
)

# create your compute
spark_compute = ServerlessSparkCompute(
    instance_type="standard_e4s_v3",
    runtime_version="3.3"
)

# reference your azureml endpoint and deployment
monitoring_target = MonitoringTarget(
    ml_task="classification",
)

# MDC-generated production data with data column names 
production_data = ProductionData(
    input_data=Input(
        type="uri_folder",
        path="azureml:credit-default-main-model_outputs:1"
    ),
    data_column_names={
        "target_column": "DEFAULT_NEXT_MONTH",
        "join_column": "correlationid"
    },
    data_window=BaselineDataRange(
        lookback_window_offset="P0D",
        lookback_window_size="P10D",
    )
)

# ground truth reference data 
reference_data_ground_truth = ReferenceData(
    input_data=Input(
        type="mltable",
        path="azureml:credit-ground-truth:1"
    ),
    data_column_names={
        "target_column": "ground_truth",
        "join_column": "correlationid"
    },
    data_context=MonitorDatasetContext.GROUND_TRUTH_DATA,
)

# create the model performance signal
metric_thresholds = ModelPerformanceMetricThreshold(
    classification=ModelPerformanceClassificationThresholds(
        accuracy=0.50,
        precision=0.50,
        recall=0.50
    ),
)

model_performance = ModelPerformanceSignal(
    production_data=production_data,
    reference_data=reference_data_ground_truth,
    metric_thresholds=metric_thresholds
)

# put all monitoring signals in a dictionary
monitoring_signals = {
    'model_performance':model_performance,
}

# create alert notification object
alert_notification = AlertNotification(
    emails=['abc@example.com', 'def@example.com']
)

# Finally monitor definition
monitor_definition = MonitorDefinition(
    compute=spark_compute,
    monitoring_target=monitoring_target,
    monitoring_signals=monitoring_signals,
    alert_notification=alert_notification
)

recurrence_trigger = RecurrenceTrigger(
    frequency="day",
    interval=1,
    schedule=RecurrencePattern(hours=3, minutes=15)
)

model_monitor = MonitorSchedule(
    name="credit_default_model_performance",
    trigger=recurrence_trigger,
    create_monitor=monitor_definition
)

poller = ml_client.schedules.begin_create_or_update(model_monitor)
created_monitor = poller.result()

若要設定模型效能監視：

完成基本設定頁面上的項目，如先前的設定立即可用模型監視一節中所述。
選取 [下一步] 以開啟 [進階設定] 區段的 [設定資料資產] 頁面。
選取 [+ 新增]，以新增資料集做為有根據事實資料集。

請確定您的模型輸出資料集也包含在新增的資料集清單中。您新增的地實資料集應該具有唯一識別碼資料行。有根據事實資料集和模型輸出資料集的唯一識別碼資料行值必須相符，才能讓兩個資料集在計量計算之前聯結。
選取 [下一步] 以移至 [選取監視訊號] 頁面。在此頁面上，您將看到已新增的一些監視訊號 (如果您稍早選取 Azure Machine Learning 線上部署)。
刪除頁面上現有的監視訊號，因為您只想要建立模型效能監視訊號。
選取 [新增] 以開啟 [編輯訊號] 視窗。
選取 [模型效能 (預覽)] 設定模型效能訊號，如下所示：
1. 在步驟 1 中，針對生產資料資產，選取您的模型輸出資料集。另外，可選取下列項目：
  - 選取適當的目標資料行 (例如，is_fraud)。
  - 選取所需的回顧視窗大小和回顧視窗位移。
2. 在步驟 2 中，針對參考資料資產，選取您稍早新增的有根據事實資料資產。另外，可選取下列項目：
  - 選取適當的目標欄位。
  - 選取要與模型輸出資料集一起執行聯結的資料行。用於聯結的資料行應該是兩個資料集之間通用的資料行，而且資料集中的每個資料列都有唯一識別碼(例如 correlationid)。
3. 在步驟 3 中，選取所需的效能計量，並指定其各自的閾值。
選取 [儲存] 以返回 [選取監視訊號] 頁面。
選取 [下一步] 以移至 [通知] 頁面。
在 [通知] 頁面上，啟用模型效能訊號的警示通知，然後選取 [下一步]。
在 [檢閱監視設定] 頁面上檢閱您的設定。
選取 [建立] 以建立模型效監視。

將生產資料帶入 Azure Machine Learning 來設定模型監視

您也可以為部署至 Azure Machine Learning 批次端點或部署在 Azure Machine Learning 外部的模型設定模型監視。如果您沒有部署，但有生產資料，則可以使用資料來執行持續模型監視。若要監視這些模型，您必須能夠：

從實際執行環境中部署的模型收集生產推斷資料。
將生產推斷資料註冊為 Azure Machine Learning 資料資產，並確保資料持續更新。
提供自訂資料前置處理元件，並將其註冊為 Azure Machine Learning 元件。

如果您的資料未使用資料收集器收集，則必須提供自訂資料前置處理元件。如果沒有這個自訂資料前置處理元件，Azure Machine Learning 模型監視系統就不知道如何將您的資料處理成支援時間範圍的表格式格式。

您的自訂前置處理元件必須具有下列輸入和輸出簽章：

輸入/輸出	簽章名稱	類型	描述	範例值
input	`data_window_start`	常值、字串	ISO8601 格式的資料時間範圍開始時間。	2023-05-01T04:31:57.012Z
input	`data_window_end`	常值、字串	ISO8601 格式的資料時間範圍結束時間。	2023-05-01T04:31:57.012Z
input	`input_data`	uri_folder	收集的生產推斷資料，其註冊為 Azure Machine Learning 資料資產。	azureml:myproduction_inference_data:1
output	`preprocessed_data`	mltable	表格式資料集，其符合參考資料結構描述的子集。

如需自訂資料前置處理元件的範例，請參閱 azuremml-examples GitHub 存放庫中的 custom_preprocessing。

滿足上述需求之後，您可以使用下列 CLI 命令和 YAML 定義來設定模型監視：

az ml schedule create -f ./model-monitoring-with-collected-data.yaml

下列 YAML 包含模型監視的定義，其中包含您已收集的生產推斷資料。

# model-monitoring-with-collected-data.yaml
$schema:  http://azureml/sdk-2-0/Schedule.json
name: fraud_detection_model_monitoring
display_name: Fraud detection model monitoring
description: Fraud detection model monitoring with your own production data

trigger:
  # perform model monitoring activity daily at 3:15am
  type: recurrence
  frequency: day #can be minute, hour, day, week, month
  interval: 1 # #every day
  schedule: 
    hours: 3 # at 3am
    minutes: 15 # at 15 mins after 3am

create_monitor:
  compute: 
    instance_type: standard_e4s_v3
    runtime_version: "3.3"
  monitoring_target:
    ml_task: classification
    endpoint_deployment_id: azureml:fraud-detection-endpoint:fraud-detection-deployment
  
  monitoring_signals:

    advanced_data_drift: # monitoring signal name, any user defined name works
      type: data_drift
      # define production dataset with your collected data
      production_data:
        input_data:
          path: azureml:my_production_inference_data_model_inputs:1  # your collected data is registered as Azure Machine Learning asset
          type: uri_folder
        data_context: model_inputs
        pre_processing_component: azureml:production_data_preprocessing:1
      reference_data:
        input_data:
          path: azureml:my_model_training_data:1 # use training data as comparison baseline
          type: mltable
        data_context: training
        data_column_names:
          target_column: is_fraud
      features: 
        top_n_feature_importance: 20 # monitor drift for top 20 features
      metric_thresholds:
        numberical:
          jensen_shannon_distance: 0.01
        categorical:
          pearsons_chi_squared_test: 0.02

    advanced_prediction_drift: # monitoring signal name, any user defined name works
      type: prediction_drift
      # define production dataset with your collected data
      production_data:
        input_data:
          path: azureml:my_production_inference_data_model_outputs:1  # your collected data is registered as Azure Machine Learning asset
          type: uri_folder
        data_context: model_outputs
        pre_processing_component: azureml:production_data_preprocessing:1
      reference_data:
        input_data:
          path: azureml:my_model_validation_data:1 # use training data as comparison reference dataset
          type: mltable
        data_context: validation
      metric_thresholds:
        categorical:
          pearsons_chi_squared_test: 0.02
  
  alert_notification:
    emails:
      - abc@example.com
      - def@example.com

滿足上述需求之後，您可以使用下列 Python 程式碼來設定模型監視：

from azure.identity import InteractiveBrowserCredential
from azure.ai.ml import Input, MLClient
from azure.ai.ml.constants import (
    MonitorFeatureType,
    MonitorMetricName,
    MonitorDatasetContext
)
from azure.ai.ml.entities import (
    AlertNotification,
    DataDriftSignal,
    DataQualitySignal,
    DataDriftMetricThreshold,
    DataQualityMetricThreshold,
    NumericalDriftMetrics,
    CategoricalDriftMetrics,
    DataQualityMetricsNumerical,
    DataQualityMetricsCategorical,
    MonitorFeatureFilter,
    MonitorInputData,
    MonitoringTarget,
    MonitorDefinition,
    MonitorSchedule,
    RecurrencePattern,
    RecurrenceTrigger,
    ServerlessSparkCompute,
    ReferenceData,
    ProductionData
)

# get a handle to the workspace
ml_client = MLClient(
   InteractiveBrowserCredential(),
   subscription_id,
   resource_group,
   workspace
)

spark_compute = ServerlessSparkCompute(
    instance_type="standard_e4s_v3",
    runtime_version="3.2"
)

#define target dataset (production dataset)
production_data = ProductionData(
    input_data=Input(
        type="uri_folder",
        path="azureml:my_model_production_data:1"
    ),
    data_context=MonitorDatasetContext.MODEL_INPUTS,
    pre_processing_component="azureml:production_data_preprocessing:1"
)


# training data to be used as reference dataset
reference_data_training = ReferenceData(
    input_data=Input(
        type="mltable",
        path="azureml:my_model_training_data:1"
    ),
    data_context=MonitorDatasetContext.TRAINING
)

# create an advanced data drift signal
features = MonitorFeatureFilter(top_n_feature_importance=20)
metric_thresholds = DataDriftMetricThreshold(
    numerical=NumericalDriftMetrics(
        jensen_shannon_distance=0.01
    ),
    categorical=CategoricalDriftMetrics(
        pearsons_chi_squared_test=0.02
    )
)

advanced_data_drift = DataDriftSignal(
    production_data=production_data,
    reference_data=reference_data_training,
    features=features,
    metric_thresholds=metric_thresholds
)


# create an advanced data quality signal
features = ['feature_A', 'feature_B', 'feature_C']
metric_thresholds = DataQualityMetricThreshold(
    numerical=DataQualityMetricsNumerical(
        null_value_rate=0.01
    ),
    categorical=DataQualityMetricsCategorical(
        out_of_bounds_rate=0.02
    )
)

advanced_data_quality = DataQualitySignal(
    production_data=production_data,
    reference_data=reference_data_training,
    features=features,
    metric_thresholds=metric_thresholds,
    alert_enabled="False"
)

# put all monitoring signals in a dictionary
monitoring_signals = {
    'data_drift_advanced': advanced_data_drift,
    'data_quality_advanced': advanced_data_quality
}

# create alert notification object
alert_notification = AlertNotification(
    emails=['abc@example.com', 'def@example.com']
)

# Finally monitor definition
monitor_definition = MonitorDefinition(
    compute=spark_compute,
    monitoring_signals=monitoring_signals,
    alert_notification=alert_notification
)

recurrence_trigger = RecurrenceTrigger(
    frequency="day",
    interval=1,
    schedule=RecurrencePattern(hours=3, minutes=15)
)

model_monitor = MonitorSchedule(
    name="fraud_detection_model_monitoring_advanced",
    trigger=recurrence_trigger,
    create_monitor=monitor_definition
)

poller = ml_client.schedules.begin_create_or_update(model_monitor)
created_monitor = poller.result()

使用自訂訊號和計量設定模型監視

透過 Azure Machine Learning 模型監視，您可以定義自訂訊號，並實作您選擇的任何計量來監視模型。您可以將此自訂訊號註冊為 Azure Machine Learning 元件。當您的 Azure Machine Learning 模型監視作業在指定的排程上執行時，它會計算您在自訂訊號內定義的計量，就像針對預先建置的訊號 (資料漂移、預測漂移和資料品質) 所做的一樣。

若要設定要用於模型監視的自訂訊號，您必須先定義自訂訊號，並將其註冊為 Azure Machine Learning 元件。 Azure Machine Learning 元件必須具有下列輸入和輸出簽章：

元件輸入簽章

元件輸入 DataFrame 應該包含下列項目：

具有前置處理元件中已處理資料的 mltable
任意數目的常值，每個常值都代表已實作計量作為自訂訊號元件的一部分。例如，如果您已實作計量 std_deviation，則需要 std_deviation_threshold 的輸入。一般而言，每個計量都應該有一個輸入，名稱為 <metric_name>_threshold。

簽章名稱	類型	描述	範例值
production_data	mltable	符合參考資料結構描述子集的表格式資料集。
std_deviation_threshold	常值、字串	實作計量的個別閾值。	2

元件輸出簽章

元件輸出連接埠應該具有下列簽章。

簽章名稱	類型	描述
signal_metrics	mltable	包含已計算計量的 mltable。結構描述定義於下一節 signal_metrics 結構描述中。

signal_metrics schema

元件輸出 DataFrame 應該包含四個資料行：group、metric_name、metric_value 和 threshold_value。

簽章名稱	類型	描述	範例值
群組	常值、字串	要套用至此自訂計量的最上層邏輯群組。	TRANSACTIONAMOUNT
metric_name	常值、字串	自訂計量的名稱。	std_deviation
metric_value	數值	自訂計量的值。	44,896.082
threshold_value	數值	自訂計量的閾值。	2

下表顯示計算 std_deviation 計量之自訂訊號元件的範例輸出：

群組	metric_value	metric_name	threshold_value
TRANSACTIONAMOUNT	44,896.082	std_deviation	2
LOCALHOUR	3.983	std_deviation	2
TRANSACTIONAMOUNTUSD	54,004.902	std_deviation	2
DIGITALITEMCOUNT	7.238	std_deviation	2
PHYSICALITEMCOUNT	5.509	std_deviation	2

若要查看範例自訂訊號元件定義和計量計算程式碼，請參閱 azureml-examples 存放庫中的 custom_signal。

一旦您滿足使用自訂訊號和計量的需求，便可以使用下列 CLI 命令和 YAML 定義來設定模型監視：

az ml schedule create -f ./custom-monitoring.yaml

下列 YAML 包含使用自訂訊號進行模型監視的定義。有關程式碼的一些注意事項：

它假設您已經在 Azure Machine Learning 中使用自訂訊號定義來建立和註冊您的元件。
已註冊自訂訊號元件的 component_id 是 azureml:my_custom_signal:1.0.0。
如果您已使用資料收集器收集資料，則可以省略 pre_processing_component 屬性。如果您想要使用前置處理元件來預先處理資料收集器未收集的生產資料，您可以指定它。

# custom-monitoring.yaml
$schema:  http://azureml/sdk-2-0/Schedule.json
name: my-custom-signal
trigger:
  type: recurrence
  frequency: day # can be minute, hour, day, week, month
  interval: 7 # #every day
create_monitor:
  compute:
    instance_type: "standard_e4s_v3"
    runtime_version: "3.3"
  monitoring_signals:
    customSignal:
      type: custom
      component_id: azureml:my_custom_signal:1.0.0
      input_data:
        production_data:
          input_data:
            type: uri_folder
            path: azureml:my_production_data:1
          data_context: test
          data_window:
            lookback_window_size: P30D
            lookback_window_offset: P7D
          pre_processing_component: azureml:custom_preprocessor:1.0.0
      metric_thresholds:
        - metric_name: std_deviation
          threshold: 2
  alert_notification:
    emails:
      - abc@example.com

解譯監視結果

設定模型監視並完成第一次執行之後，您可以瀏覽回 Azure Machine Learning 工作室中的 [監視] 索引標籤，以檢視結果。

從主要 [監視] 檢視中，選取模型監視的名稱，以查看 [監視概觀] 頁面。此頁面會顯示對應的模型、端點和部署，以及您所設定訊號的詳細資料。下一個影像顯示監視儀表板，其中包含資料漂移和資料品質訊號。視您設定的監視訊號而定，儀表板看起來可能會有所不同。
查看儀表板的 [通知] 區段，以查看每個訊號中有哪些功能違反了其個別計量的已設定閾值：
選取 data_drift 以移至資料漂移詳細資料頁面。在詳細資料頁面上，您可以看到監視組態中所包含每個數值和類別功能的資料漂移計量值。當您的監視有多個執行時，您會看到每個功能的趨勢線。
若要詳細檢視個別功能，請選取功能的名稱，以檢視與參考散發相比的生產分佈。此檢視也可讓您追蹤該特定功能的漂移時間。
返回監視儀表板，然後選取 [data_quality] 以檢視資料品質訊號頁面。在此頁面上，您可以看到您所要監視每項功能的 null 值速率、超出界限的速率，以及資料類型錯誤率。

模型監視是一個連續的程序。透過 Azure Machine Learning 模型監視，您可以設定多個監視訊號，以取得實際執行環境中模型效能的廣泛檢視。

整合 Azure Machine Learning 模型監視與 Azure 事件方格

您可以使用 Azure Machine Learning 模型監視所產生的事件，透過 Azure 事件方格來設定事件驅動應用程式、處理程序或 CI/CD 工作流程。您可以透過各種事件處理常式取用事件，例如 Azure 事件中樞、Azure 函式和邏輯應用程式。根據監視偵測到的漂移，您可以透過程式設計方式採取動作，例如設定機器學習管線來重新定型模型並重新部署模型。

若要開始整合 Azure Machine Learning 模型監視與事件方格：

請參閱在 Azure 入口網站中設定，並遵循其中的步驟。為您的事件訂用帳戶指定名稱，例如 MonitoringEvent，然後只選取 [事件類型] 底下的 [執行狀態已變更] 方塊。

警告

請務必針對事件類型選取 [執行狀態已變更]。請勿選取 [偵測到的資料集漂移]，因為它適用於資料漂移 v1，而不是 Azure Machine Learning 模型監視。
請遵循篩選和訂閱事件中的步驟，為您的案例設定事件篩選。瀏覽至 [篩選] 索引標籤，然後在 [進階篩選] 底下新增下列索引鍵、運算子和值：
- 金鑰：data.RunTags.azureml_modelmonitor_threshold_breached
- 值：因為一或多個違反計量閾值的功能而失敗
- 運算子：字串包含
透過此篩選，當執行狀態變更 (從 [已完成] 變更為 [失敗]，或從 [失敗] 到 [已完成]) 時，就會針對 Azure Machine Learning 工作區內的任何監視產生事件。
若要在監視層級進行篩選，請在 [進階篩選] 底下使用下列索引鍵、運算子和值：
- 金鑰：data.RunTags.azureml_modelmonitor_threshold_breached
- 值：your_monitor_name_signal_name
- 運算子：字串包含
請確定 your_monitor_name_signal_name 是您所要篩選事件特定監視中的訊號名稱。例如： credit_card_fraud_monitor_data_drift 。若要讓此篩選正常運作，此字串必須符合監視訊號的名稱。您應該使用監視名稱和此案例的訊號名稱來命名您的訊號。
當您完成事件訂用帳戶設定時，請選取所需的端點作為事件處理常式，例如 Azure 事件中樞。
擷取事件之後，您可以從端點頁面檢視它們：

您也可以在 Azure 監視器的 [計量] 索引標籤中檢視事件：

共用方式為

監視部署至實際執行環境的模型效能

必要條件

設定立即可用的模型監視

設定進階模型監視

設定特徵重要性

設定模型效能監視

更多模型效能監視的必要條件

使用資料收集器時監視模型效能需求

監視模型效能的範例工作流程

將生產資料帶入 Azure Machine Learning 來設定模型監視

使用自訂訊號和計量設定模型監視

元件輸入簽章

元件輸出簽章

signal_metrics schema

解譯監視結果

整合 Azure Machine Learning 模型監視與 Azure 事件方格

意見反應

其他資源

共用方式為

監視部署至實際執行環境的模型效能

必要條件

設定立即可用的模型監視

設定進階模型監視

設定特徵重要性

設定模型效能監視

更多模型效能監視的必要條件

使用資料收集器時監視模型效能需求

監視模型效能的範例工作流程

將生產資料帶入 Azure Machine Learning 來設定模型監視

使用自訂訊號和計量設定模型監視

元件輸入簽章

元件輸出簽章

signal_metrics schema

解譯監視結果

整合 Azure Machine Learning 模型監視與 Azure 事件方格

相關內容

意見反應

其他資源