共用方式為

針對 .NET 和快照調試程序設定 Application Insights Profiler 的 BYOS

  • 發行項

當您針對 .NET 或快照調試程式使用Application Insights Profiler時，應用程式所產生的成品預設會透過公用因特網上傳至 Azure 儲存體 帳戶。 針對這些成品和儲存體帳戶，Microsoft 會控制及承擔下列費用：

  • 處理和分析。
  • 待用加密和存留期管理原則。

同時，當您「自備儲存體」(BYOS) 時，成品會上傳至僅由您控制及支付以下費用的儲存體帳戶：

  • 待用加密原則和存留期管理原則。
  • 網路存取：

注意

如果您要啟用 Azure Private Link 或客戶自控金鑰，則需要 BYOS。

在本指南中，您將了解如何：

  • 將診斷服務的存取權授與儲存體帳戶。
  • 連結儲存體帳戶和 Application Insights 資源。
  • 了解儲存體帳戶的存取方式。

必要條件

  • 確認已在與您 Application Insights 資源相同的位置建立儲存體帳戶。
  • 如果您已啟用 Private Link，請允許虛擬網路連線到信任的 Microsoft 服務。

將診斷服務的存取權授與儲存體帳戶

BYOS 儲存體帳戶會連結到 Application Insights 資源。 首先，透過儲存體帳戶中存取控制 (IAM) 頁面，將 Storage Blob Data Contributor 角色授與名為 Diagnostic Services Trusted Storage Access 的 Microsoft Entra 應用程式。

  1. 選取 [存取控制 (IAM)]。

  2. 選取 [新增] > [新增角色指派]，開啟 [新增角色指派] 頁面。

  3. 指派下列角色。

    設定 值
    角色 儲存體 Blob 資料參與者
    存取權指派對象 使用者、群組或服務主體
    成員 診斷服務信任的儲存體存取

    顯示 Azure 入口網站中 [角色指派] 頁面的螢幕擷取畫面。

    指派之後，您可以在 [角色指派] 區段底下看到該角色。 顯示角色指派之後 IAM 畫面的螢幕擷取畫面。

注意

如果您也使用 Private Link，則需要一個額外的設定，以允許從虛擬網路連線到信任的 Microsoft 服務。 如需詳細資訊，請參閱儲存體網路安全性文件。

您有三個選項可用來設定 BYOS 進行程式碼層級診斷，例如 .NET Profiler 和快照調試程式：

  • Azure PowerShell Cmdlet
  • Azure CLI
  • Azure Resource Manager 範本

開始之前，請先安裝 Azure PowerShell 4.2.0 或更新版本。

  1. 安裝 Application Insights PowerShell 延伸模組。

    Install-Module -Name Az.ApplicationInsights -Force

  2. 使用 Azure 帳戶訂閱帳戶登入。

    Connect-AzAccount -Subscription "{subscription_id}"

    如需登入方式的詳細資訊，請參閱 Connect-AzAccount 文件。

  3. 移除先前連結至 Application Insights 資源的任何儲存體帳戶。

    模式：

    Get-AzApplicationInsights -ResourceGroupName "{resource_group_name}" -Name "{application_insights_name}" | Remove-AzApplicationInsightsLinkedStorageAccount

    範例：

    Get-AzApplicationInsights -ResourceGroupName "byos-test" -Name "byos-test-westus2-ai" | Remove-AzApplicationInsightsLinkedStorageAccount

  4. 使用 Application Insights 資源連線至儲存體帳戶。

    模式：

    $storageAccount = Get-AzStorageAccount -ResourceGroupName "{resource_group_name}" -Name "{storage_account_name}"
Get-AzApplicationInsights -ResourceGroupName "{resource_group_name}" -Name "{application_insights_name}" | New-AzApplicationInsightsLinkedStorageAccount -LinkedStorageAccountResourceId $storageAccount.Id

    範例：

    $storageAccount = Get-AzStorageAccount -ResourceGroupName "byos-test" -Name "byosteststoragewestus2"
Get-AzApplicationInsights -ResourceGroupName "byos-test" -Name "byos-test-westus2-ai" | New-AzApplicationInsightsLinkedStorageAccount -LinkedStorageAccountResourceId $storageAccount.Id

疑難排解

針對設定 BYOS 的常見問題進行疑難排解。

案例：不支援範本結構描述 '{schema_uri}'

您收到了類似下列範例的錯誤：

New-AzResourceGroupDeployment : 11:53:49 AM - Error: Code=InvalidTemplate; Message=Deployment template validation failed: 'Template schema
'https://schema.management.azure.com/schemas/2020-01-01/deploymentTemplate.json#' is not supported. Supported versions are
'2014-04-01-preview,2015-01-01,2018-05-01,2019-04-01,2019-08-01'. Please see https://aka.ms/arm-template for usage details.'.

方案

  • 請確定範本的 $schema 屬性有效。 其必須遵循此模式：

    https://schema.management.azure.com/schemas/{schema_version}/deploymentTemplate.json#

  • 請確定範本的 schema_version 位於有效值內：2014-04-01-preview, 2015-01-01, 2018-05-01, 2019-04-01, 2019-08-01。

案例：找不到位置 '{location}' 的已註冊資源提供者

您收到了類似下列範例的錯誤：

New-AzResourceGroupDeployment : 6:18:03 PM - Resource microsoft.insights/components 'byos-test-westus2-ai' failed with message '{
  "error": {
    "code": "NoRegisteredProviderFound",
    "message": "No registered resource provider found for location 'westus2' and API version '2020-03-01-preview' for type 'components'. The supported api-versions are '2014-04-01,
2014-08-01, 2014-12-01-preview, 2015-05-01, 2018-05-01-preview'. The supported locations are ', eastus, southcentralus, northeurope, westeurope, southeastasia, westus2, uksouth,
canadacentral, centralindia, japaneast, australiaeast, koreacentral, francecentral, centralus, eastus2, eastasia, westus, southafricanorth, northcentralus, brazilsouth, switzerlandnorth,
australiasoutheast'."
  }
}'

方案

  • 請確定資源 microsoft.insights/components 的 apiVersion 是 2015-05-01。
  • 請確定資源 linkedStorageAccount 的 apiVersion 是 2020-03-01-preview。

案例：儲存體帳戶位置應符合 Application Insights 元件位置

您收到了類似下列範例的錯誤：

New-AzResourceGroupDeployment : 1:01:12 PM - Resource microsoft.insights/components/linkedStorageAccounts 'byos-test-centralus-ai/serviceprofiler' failed with message '{
  "error": {
    "code": "BadRequest",
    "message": "Storage account location should match AI component location",
    "innererror": {
      "trace": [
        "System.ArgumentException"
      ]
    }
  }
}'

解決方案

請確定 Application Insights 資源和儲存體帳戶的位置相同。

常見問題集

本節提供針對 .NET Profiler 和快照集調試程序設定 BYOS 的常見問題的解答。

如果我啟用 .NET Profiler/Snapshot Debugger 和 BYOS，我的數據是否會遷移至我的記憶體帳戶？

否，資料不會移轉。

BYOS 是否會使用待用加密和客戶自控金鑰？

是。 因此，BYOS 是使用客戶管理員密鑰啟用 .NET Profiler/Snapshot Debugger 的需求。

BYOS 是否可在與網際網路隔離的環境中運作？

是。 BYOS 可在隔離的網路情況中使用。

是，可以的。

如果我已啟用 BYOS，是否可使用診斷服務儲存體帳戶來儲存所收集的資料？

是，您可以進行此動作，但目前不支援從 BYOS 進行資料移轉。

是。

如何存取我的儲存體帳戶？

  1. 在虛擬機器或 Azure App Service 中執行的代理程式，會將成品 (設定檔、快照集和符號) 上傳至帳戶中的 Blob 容器。

    此程式牽涉到連絡 .NET Profiler 或快照調試程式，以取得記憶體帳戶中新 Blob 的共用存取簽章令牌。

  2. .NET Profiler 或快照調試程式：

    • 分析傳入的 Blob。
    • 將分析結果和記錄檔寫回 Blob 儲存體。

    視可用的計算容量而定，系統可能會在上傳作業完成後隨時進行此流程。

  3. 當您檢視 Profiler 追蹤或快照偵錯工具分析時，服務會從 Blob 儲存體擷取分析結果。

下一步