為 Azure App 服務 應用程式啟用 .NET Profiler
適用於 .NET 的 Application Insights Profiler 已預安裝為 Azure App 服務 運行時間的一部分。 您可以使用基本服務層級或更高層級,針對在 App Service 上執行的 ASP.NET 和 ASP.NET Core 應用程式執行 Profiler。
適用於 .NET 的 Application Insights Profiler 無程式代碼安裝:
- 遵循 .NET Core 支援原則。 \(英文\)
- 僅適用於 Windows 架構的 Web 應用程式。
若要在Linux上啟用 .NET Profiler,請逐步解 說 ASP.NET Core Azure Linux Web 應用程式指示。
必要條件
- Azure App Service ASP.NET/ASP.NET Core 應用程式。
- 已連線至您 App Service 應用程式的 Application Insights 資源。
確認已啟用 [一律開啟] 設定
前往 Azure 入口網站中的 App Service 執行個體。
在左側功能表中,選取 [設定>組態]。
選取一般設定索引標籤。
確認已選取 [一律開啟]>[開啟]。
注意
如果 [永遠開啟] 切換已停用,請升級App Service Web 應用程式,以在基本層或更高層級上執行。
如果您進行變更,請選取 [儲存]。
啟用 Application Insights 和 .NET Profiler
您可以在下列任一情況下啟用 Profiler:
- 您的 Application Insights 資源和 App Service 資源位於相同的訂用帳戶中,或者
- 您的 Application Insights 資源和 App Service 資源位於不同的訂用帳戶中。
針對相同訂閱中的 Application Insights 與 App Service
如果您的 Application Insights 資源與 App Service 執行個體處於相同的訂用帳戶中:
在左側功能表中,選取 [ 監視>Application Insights]。
在 [Application Insights] 下,選取 [啟用]。
確認您已將 Application Insights 資源連線至您的應用程式。
根據您的應用程式,向下捲動並選取 [.NET] 或 [.NET Core] 索引標籤。
確認已選取 [集合層級]>[建議]。
在 [Profiler] 下,選取 [開啟]。
若您稍早選擇 [基本] 集合層級,則會停用 [Profiler] 設定。
選取 [套用]>[是] 以確認。
針對不同訂閱中的 Application Insights 與 App Service
如果您的 Application Insights 資源與您的 App Service 實例位於不同的訂用帳戶中,您必須為 App Service 實例建立應用程式設定,以手動啟用適用於 .NET 的 Profiler。 您可以使用範本或其他方式,自動建立這些設定。 以下是啟用 Profiler 所需的設定。
應用程式設定 | 值 |
---|---|
APPLICATIONINSIGHTS_CONNECTION_STRING | 來自您 App Insights 資源的唯一值。 |
APPINSIGHTS_PROFILERFEATURE_VERSION | 1.0.0 |
DiagnosticServices_EXTENSION_VERSION | ~3 |
使用下列方式設定這些值:
啟用區域雲端的 .NET Profiler
目前唯一需要修改端點的區域是 Azure Government 和由 21Vianet 營運的 Microsoft Azure。
應用程式設定 | 美國政府雲端 | 中國雲端 |
---|---|---|
ApplicationInsightsProfilerEndpoint | https://profiler.monitor.azure.us |
https://profiler.monitor.azure.cn |
ApplicationInsightsEndpoint | https://dc.applicationinsights.us |
https://dc.applicationinsights.azure.cn |
啟用 Microsoft Entra 驗證以進行設定檔內嵌
適用於 .NET 的 Application Insights Profiler 支援Microsoft擷取配置檔的 Entra 驗證。 若要內嵌應用程式的所有設定檔,您的應用程式必須經過驗證,並將必要的應用程式設定提供給 Profiler 代理程式。
只有當您在應用程式中使用 Application Insights SDK 參考及設定 Microsoft Entra ID 時,Profiler 才支援 Microsoft Entra 驗證。
若要啟用 Microsoft Entra ID 以進行設定檔內嵌:
建立並新增受控識別,以向 App Service 驗證 Application Insights 資源:
系統指派的受控識別文件 (部分機器翻譯)
使用者指派的受控識別文件 (部分機器翻譯)
在您的 Application Insights 資源中設定並啟用 Microsoft Entra ID。
新增下列應用程式設定,讓 Profiler 代理程式知道要使用何種受控識別。
針對系統指派的身分識別:
應用程式設定 值 APPLICATIONINSIGHTS_AUTHENTICATION_STRING Authorization=AAD
針對使用者指派的身分識別:
應用程式設定 值 APPLICATIONINSIGHTS_AUTHENTICATION_STRING Authorization=AAD;ClientId={Client id of the User-Assigned Identity}
停用 .NET Profiler
若要為個別應用程式的執行個體停止或重新啟動 Profiler,請執行下列步驟:
在左窗格的 [設定] 下,選取 [WebJobs]。
選取名稱為
ApplicationInsightsProfiler3
的 WebJob。選取 [停止]。
選取是以確認。
建議您在所有應用程式上都啟用 Profiler,以儘早找出任何效能問題。
您可以在使用 WebDeploy 將變更部署至 Web 應用程式時,刪除 Profiler 的檔案。 您可以藉由拒絕在部署期間刪除 App_Data 資料夾來防止刪除。
下一步
- 瞭解如何 產生負載並檢視 .NET Profiler 追蹤
- 瞭解如何搭配適用於 .NET 的 Application Insights Profiler 使用程式代碼優化功能