將異常偵測程式單變數模組部署至 IoT Edge
重要
從 2023 年 9 月 20 日起,您將無法建立新的異常偵測程式資源。 異常偵測程式服務將于 2026 年 10 月 1 日淘汰。
了解如何將 Azure AI 服務異常偵測程式模組部署至 IoT Edge 裝置。 一旦部署至 IoT Edge,模組就會與其他模組一起在 IoT Edge 中執行,作為容器實例。 它會公開與在標準 Docker 容器環境中執行的異常偵測程式容器實例完全相同的 API。
必要條件
- 使用 Azure 訂用帳戶。 如尚未擁有 Azure 訂用帳戶,請在開始之前先建立免費帳戶。
- 安裝 Azure CLI 。
- IoT 中樞 和 IoT Edge 裝置。
建立異常偵測器資源
登入 Azure 入口網站。
選取 [ 建立異常偵測程式 資源]。
輸入所有必要的設定:
設定 值 名稱 所需名稱 (2-64 個字元) 訂用帳戶 選取適當的訂用帳戶 位置 選取任何附近的可用位置 定價層 F0
- 每秒 10 次呼叫,每月 20K 筆交易。
或:
S0
- 每秒 80 個呼叫數資源群組 選取可用的資源群組 選取 [建立],然後等候系統建立資源。 建立之後,流覽至資源頁面
收集已設定
endpoint
的 API 金鑰:入口網站中的 [金鑰和端點] 索引標籤 設定 值 概觀 端點 複製端點。 看起來類似 https://<your-resource-name>.cognitiveservices.azure.com/
[索引鍵] API 金鑰 複製兩個金鑰的 1。 它是 32 個英數位元字串,不含空格或破折號。 xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
將異常偵測模組部署至邊緣
在Azure 入口網站中,在 IoT Edge 上輸入 異常偵測程式,然後開啟 Azure Marketplace 結果。
執行此動作隨即會帶您前往 Azure 入口網站的 [IoT Edge 模組目標裝置] 頁面。 提供下列必要資訊。
選取您的訂用帳戶。
選取您的IoT 中樞。
選取 [ 尋找裝置 ],然後尋找 IoT Edge 裝置。
選取建立按鈕。
選取 AnomalyDetectoronIoTEdge 模組。
巡覽至 [環境變數],並提供下列資訊。
保留 Eula 的值接受 。
在 [帳單] 處填入 Azure AI 服務端點。
在 [Apikey] 中填入 Azure AI 服務 API 金鑰。
選擇更新
選取 [下一步:路由] 來定義路由。 請將來自所有模組的全部訊息定義為移至 Azure IoT 中樞。 若要瞭解如何宣告路由,請參閱 在 IoT Edge 中建立路由。
完成時,選取 [下一步:檢閱 + 建立]。 您可以預覽 JSON 檔案,該檔案會定義所有部署至 IoT Edge 裝置的模組。
選取 [建立] 以開始模組部署。
完成模組部署後,請返回 IoT 中樞的 [IoT Edge] 頁面。 從 IoT Edge 裝置清單中選取您的裝置,可查看其詳細資料。
向下捲動並查看列出的模組。 檢查新模組的執行時間狀態是否正在執行。
若要針對 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 標頭和主體格式。 |
下一步
- 檢閱 安裝和執行容器 以提取容器映射並執行容器
- 檢閱 設定容器 以進行組態設定
- 深入瞭解 異常偵測程式 API 服務