Share via


將異常偵測程式單變數模組部署至 IoT Edge

重要

從 2023 年 9 月 20 日起,您將無法建立新的異常偵測程式資源。 異常偵測程式服務將于 2026 年 10 月 1 日淘汰。

了解如何將 Azure AI 服務異常偵測程式模組部署至 IoT Edge 裝置。 一旦部署至 IoT Edge,模組就會與其他模組一起在 IoT Edge 中執行,作為容器實例。 它會公開與在標準 Docker 容器環境中執行的異常偵測程式容器實例完全相同的 API。

必要條件

建立異常偵測器資源

  1. 登入 Azure 入口網站

  2. 選取 [ 建立異常偵測程式 資源]。

  3. 輸入所有必要的設定:

    設定
    名稱 所需名稱 (2-64 個字元)
    訂用帳戶 選取適當的訂用帳戶
    位置 選取任何附近的可用位置
    定價層 F0 - 每秒 10 次呼叫,每月 20K 筆交易。
    或:
    S0 - 每秒 80 個呼叫數
    資源群組 選取可用的資源群組
  4. 選取 [建立],然後等候系統建立資源。 建立之後,流覽至資源頁面

  5. 收集已設定 endpoint 的 API 金鑰:

    入口網站中的 [金鑰和端點] 索引標籤 設定
    概觀 端點 複製端點。 看起來類似 https://<your-resource-name>.cognitiveservices.azure.com/
    [索引鍵] API 金鑰 複製兩個金鑰的 1。 它是 32 個英數位元字串,不含空格或破折號。 xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

將異常偵測模組部署至邊緣

  1. 在Azure 入口網站中,在 IoT Edge 上輸入 異常偵測程式,然後開啟 Azure Marketplace 結果。

  2. 執行此動作隨即會帶您前往 Azure 入口網站的 [IoT Edge 模組目標裝置] 頁面。 提供下列必要資訊。

    1. 選取您的訂用帳戶。

    2. 選取您的IoT 中樞。

    3. 選取 [ 尋找裝置 ],然後尋找 IoT Edge 裝置。

  3. 選取建立按鈕。

  4. 選取 AnomalyDetectoronIoTEdge 模組。

    Image of IoT Edge Modules user interface with AnomalyDetectoronIoTEdge link highlighted with a red box to indicate that this is the item to select.

  5. 巡覽至 [環境變數],並提供下列資訊。

    1. 保留 Eula 的值接受

    2. 在 [帳單] 處填入 Azure AI 服務端點。

    3. 在 [Apikey] 中填入 Azure AI 服務 API 金鑰。

    Environment variables with red boxes around the areas that need values to be filled in for endpoint and API key

  6. 選擇更新

  7. 選取 [下一步:路由] 來定義路由。 請將來自所有模組的全部訊息定義為移至 Azure IoT 中樞。 若要瞭解如何宣告路由,請參閱 在 IoT Edge 中建立路由。

  8. 完成時,選取 [下一步:檢閱 + 建立]。 您可以預覽 JSON 檔案,該檔案會定義所有部署至 IoT Edge 裝置的模組。

  9. 選取 [建立] 以開始模組部署。

  10. 完成模組部署後,請返回 IoT 中樞的 [IoT Edge] 頁面。 從 IoT Edge 裝置清單中選取您的裝置,可查看其詳細資料。

  11. 向下捲動並查看列出的模組。 檢查新模組的執行時間狀態是否正在執行。

若要針對 IoT Edge 裝置的執行時間狀態進行疑難排解,請參閱 疑難排解指南

在 IoT Edge 裝置上測試異常偵測程式

您要對具有執行中 Azure AI 服務容器的 Azure IoT Edge 裝置進行 HTTP 呼叫。 容器會提供 REST 型端點 API。 針對模組 API,請使用 主機 http://<your-edge-device-ipaddress>:5000

或者,您可以使用 Azure IoT Edge 裝置上的異常偵測程式用戶端程式庫來建立模組用戶端,然後在 Edge 上呼叫執行中的 Azure AI 服務容器。 使用主機端點 http://<your-edge-device-ipaddress>:5000 ,並將主機金鑰保留空白。

如果您的邊緣裝置尚未允許埠 5000 上的輸入通訊,您必須建立新的 輸入連接埠規則

針對 Azure VM,這可以在 [虛擬機器 > ] 底下 設定設定 > [網路 > 輸入連接埠規則 > ] [新增輸入連接埠規則]。

有數種方式可以驗證模組正在執行。 找出有問題的邊緣裝置的外部 IP 位址和公開的埠,然後開啟您最愛的網頁瀏覽器。 使用下列各種要求 URL 來驗證容器正在執行中。 下面列出的範例要求 URL 是 http://<your-edge-device-ipaddress:5000 ,但您的特定容器可能會有所不同。 請記住,您必須使用邊緣裝置的外部 IP 位址。

要求 URL 目的
http://<your-edge-device-ipaddress>:5000/ 容器會提供首頁。
http://<your-edge-device-ipaddress>:5000/status 使用 GET 要求時,這會驗證用來啟動容器的 API 金鑰是否有效,而不會造成端點查詢。 此要求可用於 Kubernetes 活躍度和整備探查
http://<your-edge-device-ipaddress>:5000/swagger 容器會為端點提供一組完整的文件和立即試用功能。 透過這項功能,您可以將您的設定輸入網頁式 HTML 表單,然後進行查詢,而不需要撰寫任何程式碼。 查詢傳回之後,會提供範例 CURL 命令來示範所需的 HTTP 標頭和主體格式。

Container's home page

下一步