在 Azure Spring Apps 中使用 Application Insights Java In-Process 代理程式

使用下列程序啟用 Java In-Process 代理程式。

1. 移至您的服務執行個體的 [服務 | 概觀] 頁面，然後在 [監視] 區段中選取 [Application Insights]。

2. 選取 [啟用 Application Insights]，以在 Azure Spring Apps 中啟用 Application Insights。

3. 選取 Application Insights 的現有執行個體，或建立新的執行個體。

4. Application Insights 啟用時，您可以設定一個選擇性的取樣率 (預設值為 10.0%)。

   

5. 按一下 [儲存]，即可儲存變更。

您可以使用入口網站來檢查或更新 Application Insights 中的目前設定。

使用 Azure 入口網站啟用 Application Insights

1. 選取 [Application Insights]。

2. 選取 [編輯繫結] 或 [解除繫結] 超連結，以啟用 Application Insights。

   

3. 編輯 Application Insights 或取樣率，然後選取 [儲存]。

停用 Application Insights

1. 選取 [Application Insights]。

2. 選取 [解除繫結] 以停用 Application Insights。

   

變更 Application Insights 設定

選取 [Application Insights] 資料行底下的名稱，以開啟 [Application Insights] 區段。

在組建服務中編輯 Application Insights 組建套件繫結

若要在組建服務中檢查並更新 Application Insights 組建套件繫結的目前設定，請遵循下列步驟：

1. 選取 [組建服務]。
2. 選擇您的建立器。
3. 選取 [繫結] 資料行底下的 [編輯]。

在 [繫結類型] 資料行下所列的 ApplicationInsights 項目中，可以找到 Application Insights 設定。

1. 選取 [繫結] 超連結，或選取省略符號底下的 [編輯繫結]，以開啟和編輯 Application Insights 組建套件繫結。

   

2. 編輯繫結設定，然後選取 [儲存]。

   

az spring create \
    --resource-group <resource-group-name> \
    --name "service-instance-name" \
    --app-insights <name-or-resource-ID> \
    --sampling-rate <sampling-rate>

az spring create \
    --resource-group <resource-group-name> \
    --name "service-instance-name" \
    --app-insights <name-or-resource-ID> \
    --sampling-rate <sampling-rate> \
    --sku Enterprise

az spring create \
    --resource-group <resource-group-name> \
    --name <service-instance-name> \
    --app-insights-key <connection-string-or-instrumentation-key> \
    --sampling-rate <sampling-rate>

az spring create \
    --resource-group <resource-group-name> \
    --name <service-instance-name> \
    --app-insights-key <connection-string-or-instrumentation-key> \
    --sampling-rate <sampling-rate> \
    --sku Enterprise

az spring create \
    --resource-group <resource-group-name> \
    --name <service-instance-name> \
    --disable-app-insights

az spring create \
    --resource-group <resource-group-name> \
    --name <service-instance-name> \
    --disable-app-insights \
    --sku Enterprise

檢查 Application Insights 設定

若要檢查現有 Azure Spring Apps 執行個體的 Application Insights 設定，請使用下列命令：

az spring app-insights show \
    --resource-group <resource-group-name> \
    --name <service-instance-name>

更新 Application Insights

若要將 Application Insights 更新為使用連接字串 (慣用) 或檢測金鑰，請使用下列命令：

az spring app-insights update \
    --resource-group <resource-group-name> \
    --name <service-instance-name> \
    --app-insights-key <connection-string-or-instrumentation-key> \
    --sampling-rate <sampling-rate>

若要將 Application Insights 更新為使用資源名稱或識別碼，請使用下列命令：

az spring app-insights update \
    --resource-group <resource-group-name> \
    --name <service-instance-name> \
    --app-insights <name-or-resource-ID> \
    --sampling-rate <sampling-rate>

使用 update 命令停用 Application Insights

若要停用現有 Azure Spring Apps 執行個體上的 Application Insights，請使用下列命令：

az spring app-insights update \
    --resource-group <resource-group-name> \
    --name <service-instance-name> \
    --disable

管理 Application Insights 組建套件繫結

本節僅適用於企業方案，並提供上一節的補充指示。

Azure Spring Apps 企業方案使用組建套件繫結將 Azure Application Insights 與 ApplicationInsights 類型整合。 如需詳細資訊，請參閱 如何設定 APM 整合和 CA 憑證。

若要建立 Application Insights 組建套件繫結，請使用下列命令：

az spring build-service builder buildpack-binding create \
    --resource-group <your-resource-group-name> \
    --service <your-service-instance-name> \
    --name <your-binding-name> \
    --builder-name <your-builder-name> \
    --type ApplicationInsights \
    --properties sampling-percentage=<your-sampling-percentage> \
                 connection-string=<your-connection-string>

若要列出所有組建套件繫結，並尋找 ApplicationInsights 類型的 Application Insights 繫結，請使用下列命令：

az spring build-service builder buildpack-binding list \
    --resource-group <your-resource-group-name> \
    --service <your-service-resource-name> \
    --builder-name <your-builder-name>

若要取代 Application Insights 組建套件繫結，請使用下列命令：

az spring build-service builder buildpack-binding set \
    --resource-group <your-resource-group-name> \
    --service <your-service-instance-name> \
    --name <your-binding-name> \
    --builder-name <your-builder-name> \
    --type ApplicationInsights \
    --properties sampling-percentage=<your-sampling-percentage> \
                 connection-string=<your-connection-string>

若要取得 Application Insights 組建套件繫結，請使用下列命令：

az spring build-service builder buildpack-binding show \
    --resource-group <your-resource-group-name> \
    --service <your-service-instance-name> \
    --name <your-binding-name> \
    --builder-name <your-builder-name>

若要刪除 Application Insights 組建套件繫結，請使用下列命令：

az spring build-service builder buildpack-binding delete \
    --resource-group <your-resource-group-name> \
    --service <your-service-instance-name> \
    --name <your-binding-name> \
    --builder-name <your-builder-name>

下列各節說明如何使用 Bicep、Azure Resource Manager 範本 (ARM 範本) 或 Terraform 將部署自動化。

Bicep

若要使用 Bicep 檔案進行部署，請將下列內容複製到 main.bicep 檔案中。 如需詳細資訊，請參閱 Microsoft.AppPlatform Spring/monitoringSettings。

param springName string
param location string = resourceGroup().location

resource spring 'Microsoft.AppPlatform/Spring@2020-07-01' = {
  name: springName
  location: location
  properties: {}
}

resource monitorSetting 'Microsoft.AppPlatform/Spring/monitoringSettings@2020-11-01-preview' = {
  parent: spring
  name: 'default'
  properties: {
    appInsightsInstrumentationKey: '00000000-0000-0000-0000-000000000000'
    appInsightsSamplingRate: 88
  }
}

ARM 範本

若要使用 ARM 範本進行部署，請將下列內容複寫到 azuredeploy.json 檔案中。 如需詳細資訊，請參閱 Microsoft.AppPlatform Spring/monitoringSettings。

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "springName": {
      "type": "string"
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]"
    }
  },
  "resources": [
    {
      "type": "Microsoft.AppPlatform/Spring",
      "apiVersion": "2020-07-01",
      "name": "[parameters('springName')]",
      "location": "[parameters('location')]",
      "properties": {}
    },
    {
      "type": "Microsoft.AppPlatform/Spring/monitoringSettings",
      "apiVersion": "2020-11-01-preview",
      "name": "[format('{0}/{1}', parameters('springName'), 'default')]",
      "properties": {
        "appInsightsInstrumentationKey": "00000000-0000-0000-0000-000000000000",
        "appInsightsSamplingRate": 88
      },
      "dependsOn": [
        "[resourceId('Microsoft.AppPlatform/Spring', parameters('springName'))]"
      ]
    }
  ]
}

Terraform

對於 Terraform 部署，請使用下列範本。 如需詳細資訊，請參閱 azurerm_spring_cloud_service。

provider "azurerm" {
  features {}
}

resource "azurerm_resource_group" "example" {
  name     = "example-resources"
  location = "West Europe"
}

resource "azurerm_application_insights" "example" {
  name                = "tf-test-appinsights"
  location            = azurerm_resource_group.example.location
  resource_group_name = azurerm_resource_group.example.name
  application_type    = "web"
}

resource "azurerm_spring_cloud_service" "example" {
  name                = "example-springcloud"
  resource_group_name = azurerm_resource_group.example.name
  location            = azurerm_resource_group.example.location
  sku_name            = "S0"

  config_server_git_setting {
    uri          = "https://github.com/Azure-Samples/piggymetrics"
    label        = "config"
    search_paths = ["dir1", "dir2"]
  }

  trace {
    connection_string = azurerm_application_insights.example.connection_string
    sample_rate       = 10.0
  }

  tags = {
    Env = "staging"
  }
}

尚不支援企業方案中的 Azure 自動化。 文件在可用後將立即新增。

Java 代理程式將透過 JDK 定期更新/升級，這可能會影響下列案例。

• 在更新/升級之前使用 Java 代理程式的現有應用程式將不受影響。
• 在更新/升級之後建立的應用程式，會使用新版的 Java 代理程式。
• 先前未使用 Java 代理程式的現有應用程式，必須重新啟動或重新部署，才能使用新版的 Java 代理程式。

更新組建套件時，Java 代理程式會更新/升級。

Java 代理程式設定熱載入

Azure Spring Apps 已啟用熱載入機制，以調整代理程式組態設定而無須重新啟動應用程式。

• 如果已啟用 Java 代理程式，則變更 Application Insights 執行個體或 SamplingRate 值不需要重新啟動應用程式。

• 如果啟用 Java 代理程式，則必須重新啟動應用程式。

• 當您停用 Java 代理程式時，應用程式會在幾分鐘後停止傳送所有監視資料。 您可以重新啟動應用程式，以從 Java 執行階段環境移除代理程式。