Использование внутрипроцессного агента Java Application Insights в Azure Spring Apps

Включите внутрипроцессный агент Java с помощью следующей процедуры.

1. Перейти к службе | Страница обзора экземпляра службы и выберите Application Insights в разделе "Мониторинг ".

2. Щелкните Включить Application Insights, чтобы включить Application Insights в Azure Spring Apps.

3. Выберите существующий экземпляр Application Insights или создайте новый.

4. Если компонент Application Insights включен, можно настроить одну необязательную частоту выборки (по умолчанию 10,0 %).

   

5. Щелкните Сохранить для сохранения изменений.

Для проверки или обновления текущих параметров в Application Insights можно использовать портал.

Включение Application Insights с помощью портала Azure

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. Нажмите Build Service (Служба сборки).
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

Чтобы проверить параметры Application Insights существующего экземпляра Azure Spring Apps, используйте следующую команду:

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 с помощью команды update

Чтобы отключить Application Insights в существующем экземпляре Azure Spring Apps, используйте следующую команду:

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

Управление привязками пакета сборки Application Insights

Этот раздел относится только к плану Enterprise и содержит инструкции, которые дополняют предыдущий раздел.

План Azure Spring Apps Enterprise использует привязки buildpack для интеграции приложение Azure Insights с типомApplicationInsights. Дополнительные сведения см. в разделе "Настройка сертификатов интеграции APM и ЦС".

Чтобы создать привязку пакета сборки 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>

Чтобы получить список всех привязок пакета сборки и найти привязки 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/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"
  }
}

Автоматизация в плане Enterprise ожидает поддержки. Документация добавляется сразу после ее доступности.

Агент Java регулярно обновляется и обновляется с помощью JDK, что может повлиять на следующие сценарии.

• Существующие приложения, использующие агент Java перед обновлением и обновлением, не затрагиваются.
• Приложения, созданные после обновления и обновления, используют новую версию агента Java.
• Существующие приложения, которые ранее не использовали агент Java, требуют перезапуска или повторного развертывания для использования новой версии агента Java.

Агент Java обновляется или обновляется при обновлении пакета сборки.

Горячая загрузка конфигурации агента Java

Azure Spring Apps имеет механизм горячей загрузки для настройки параметров конфигурации агента без перезапуска приложений.

• Если агент Java уже включен, изменения экземпляра SamplingRate или значения Application Insights не требуют перезапуска приложения.

• При включении агента Java необходимо перезапустить приложения.

• При отключении агента Java приложения перестают отправлять все данные мониторинга после задержки в минутах. Вы можете перезапустить приложения, чтобы удалить агент из среды выполнения Java.