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

使用下列程式啟用 Java In-Process Agent。

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. 選取 [系結] 資料行底下的 [編輯 ]。

Application Insights 設定位於 [系結類型] 資料行底下的 ApplicationInsights 專案中。

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>

使用更新命令停用 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 Enterprise 方案會使用 buildpack 系結，將 Azure 應用程式 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>

若要列出所有 buildpack 系結，並尋找 Application Insights 系結類型 ApplicationInsights，請使用下列命令：

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/monitoring 設定。

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/monitoring 設定。

{
  "$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"
  }
}

企業方案中的自動化擱置支援。 一旦檔可供使用，就會立即新增檔。

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

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

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

Java 代理程式組態熱載入

Azure Spring Apps 具有熱載入機制，可調整代理程式組態的設定，而不需要重新啟動應用程式。

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

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

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