appinsights-instrumentation

AppInsights 檢測功能

此技能可讓 Web 應用程式將遙測資料傳送至 Azure App Insights，以提升應用程式健康狀態的可觀測性。

使用時機

當使用者想要為其 Web 應用程式啟用遙測功能時，即可使用此技能。

先決條件

工作區中的應用程式必須是下列其中一種類型：

• 裝載於 Azure 的 ASP.NET Core 應用程式
• 裝載於 Azure 的 Node.js 應用程式

指南

收集環境資訊

找出使用者嘗試加入遙測支援的應用程式的（程式語言、應用程式架構、裝載方式）組合。這會決定如何對應用程式進行檢測。請閱讀原始碼以做出合理推測。對於不確定的部分，請務必與使用者確認。您必須詢問使用者應用程式的裝載位置（例如：個人電腦、Azure App Service 程式碼、Azure App Service 容器、Azure Container App 等）。

盡可能優先使用自動檢測

如果應用程式是裝載於 Azure App Service 的 C# ASP.NET Core 應用程式，請使用自動指南協助使用者自動檢測應用程式。

手動檢測

透過建立 AppInsights 資源並更新應用程式程式碼，手動檢測應用程式。

建立 AppInsights 資源

使用下列適合環境的選項之一：

• 將 AppInsights 加入現有的 Bicep 範本。請參閱範例/appinsights.bicep了解需加入的內容。如果工作區中已有 Bicep 範本檔案，這是最佳選項。
• 使用 Azure CLI。請參閱指令碼/appinsights.ps1了解執行哪些 Azure CLI 指令來建立 App Insights 資源。

無論選擇哪個選項，建議使用者在有意義的資源群組中建立 App Insights 資源，以便更輕鬆地管理資源。一個好的選擇是與 Azure 中裝載應用程式的資源相同的資源群組。

修改應用程式程式碼

• 如果應用程式是 ASP.NET Core 應用程式，請參閱ASPNETCORE 指南了解如何修改 C# 程式碼。
• 如果應用程式是 Node.js 應用程式，請參閱NODEJS 指南了解如何修改 JavaScript/TypeScript 程式碼。
• 如果應用程式是 Python 應用程式，請參閱PYTHON 指南了解如何修改 Python 程式碼。