從 Application Insights 檢測金鑰遷移至連接字串

Application Insights 正在從全域擷取端點變更為使用連接字串的區域端點，以提供額外的功能。

受這項變更影響最大的案例：

防火牆例外或 Proxy 重導向 - 如果需要監視內部網路的 Web 伺服器，我們先前的解決方案會要求您將單個服務端點新增至您的設定。如需詳細資訊，請參閱我是否可以監視內部網路網頁伺服器？。連接字串可藉由將此工作減少為單一設定來提供更好的替代方案。簡單的前綴和後綴調整允許自動填充和將所有端點自動導向到正確的服務。
主權或混合式雲端環境 - 用戶可以將數據傳送至定義的 Azure Government 區域。藉由使用連接字串，您可以定義內部網路伺服器或混合式雲端設定的端點設定。

本文將介紹從儀表金鑰移轉至連接字串的過程。

先決條件

支援的 SDK 版本
現有的 Application Insights 資源

遷移

移至 Application Insights 資源的 [概觀] 窗格。
尋找右側顯示的 連接字串 。
暫留在連接字串上，選取「複製到剪貼簿」圖示。
請依照如何設定連接字串來設置 Application Insights SDK。

這很重要

請勿同時使用連接字串和檢測金鑰。後者集合將取代前者集合，而且可能會導致遙測未顯示在入口網站上。請參閱遺漏的數據。

大規模移轉

使用環境變數將連接字串傳遞至 Application Insights SDK 或代理程式。

若要透過環境變數設定連接字串，請將連接字串的值放入名為 APPLICATIONINSIGHTS_CONNECTION_STRING的環境變數中。

您可以在 Azure 部署中自動執行此程式。例如，下列 Azure Resource Manager 範本示範如何使用 Azure App Service 部署自動包含正確的連接字串。請務必包含您的應用程式所需的任何其他應用程式設定：

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "appServiceName": {
            "type": "string",
            "metadata": {
                "description": "Name of the App Services resource"
            }
        },
        "appServiceLocation": {
            "type": "string",
            "metadata": {
                "description": "Location to deploy the App Services resource"
            }
        },
        "appInsightsName": {
            "type": "string",
            "metadata": {
                "description": "Name of the existing Application Insights resource to use with this App Service. Expected to be in the same Resource Group."
            }
        }
    },
    "resources": [
        {
            "apiVersion": "2016-03-01",
            "name": "[parameters('appServiceName')]",
            "type": "microsoft.web/sites",
            "location": "[parameters('appServiceLocation')]",
            "properties": {
                "siteConfig": {
                    "appSettings": [
                        {
                            "name": "APPLICATIONINSIGHTS_CONNECTION_STRING",
                            "value": "[reference(concat('microsoft.insights/components/', parameters('appInsightsName')), '2015-05-01').ConnectionString]"
                        }
                    ]
                },
                "name": "[parameters('appServiceName')]"
            }
        }
    ]
}

支援的 SDK 版本

.NET 和 .NET Core v2.12.0+
Java v2.5.1 和 Java 3.0+
JavaScript v2.3.0+
NodeJS v1.5.0+
Python v1.0.0+

故障排除

本節提供疑難解答解決方案。

警示：「轉換至使用連接字串進行數據擷取」

請遵循本文中的移轉步驟來解決此警示。

遺漏的資料

確認您使用的是支援的 SDK 版本。如果您在另一個 Azure 產品供應專案中使用 Application Insights 整合，請查看其有關如何正確設定連接字串的檔。
確認您未同時設定檢測金鑰和連接字串。檢測金鑰設定應該從您的設定中移除。
請確認您的連接字串與 Azure 門戶網站中提供的內容完全一致。

環境變數無法運作

如果您在應用程式程式碼中硬編碼檢測金鑰，那麼這樣的程式設計可能會優先於環境變數設定。

常見問題

本節提供常見問題的解答。

我可以在哪裡找到我的連接字串？

連接字串也會包含在 Application Insights 資源的 Resource Manager 資源屬性中，在功能變數名稱 ConnectionString下。

這如何影響自動化監測？

自動結構案例不會受到影響。

是否可以使用 Microsoft Entra 驗證與自動結構？

您無法針對自動儀表化案例啟用Microsoft Entra 驗證。我們計劃在未來解決這項限制。

全球和區域擷取之間的差異為何？

全域擷取會將所有遙測數據傳送至單一端點，無論此數據儲存在何處。區域擷取可讓您針對數據擷取定義每個區域的特定端點。這項功能可確保數據會在處理和儲存期間保留在特定區域內。

連接字串如何影響計費？

計費不會受到影響。

Microsoft問答

將問題張貼至解答論壇。

Last updated on 2024-10-10

共用方式為