Azure Spring Apps'de Application Insights Java İşlem İçi Aracısını kullanma

Aşağıdaki yordamı kullanarak Java İşlem İçi Aracısı'nı etkinleştirin.

1. Hizmete git | Hizmet örneğinizin Genel Bakış sayfası ve ardından İzleme bölümünde Application Insights'ı seçin.

2. Azure Spring Apps'te Application Insights'ı etkinleştirmek için Application Insights'ı etkinleştir'i seçin.

3. Application Insights'ın mevcut bir örneğini seçin veya yeni bir tane oluşturun.

4. Application Insights etkinleştirildiğinde isteğe bağlı bir örnekleme oranı (%10,0) yapılandırabilirsiniz.

   

5. Değişiklikleri kaydetmek için Kaydet’i seçin.

Application Insights'ta geçerli ayarları denetlemek veya güncelleştirmek için Portalı kullanabilirsiniz.

Azure portalını kullanarak Application Insights'i etkinleştirme

1. Application Insights’ı seçin.

2. Bağlamayı düzenle'yi veya İlişkisiz köprüyü seçerek Application Insights'ı etkinleştirin.

   

3. Application Insights veya Örnekleme oranını düzenleyin, ardından Kaydet'i seçin.

Application Insights'ı devre dışı bırakma

1. Application Insights’ı seçin.

2. Application Insights'ı devre dışı bırakmak için Bağlamayı kaldır'ı seçin.

   

Application Insights Ayarlarını Değiştirme

Application Insights bölümünü açmak için Application Insights sütununun altındaki adı seçin.

Derleme Hizmeti'nde Application Insights derleme paketi bağlamalarını düzenleme

Derleme Hizmeti'nde Application Insights derleme paketi bağlamalarının geçerli ayarlarını denetlemek ve güncelleştirmek için şu adımları izleyin:

1. Derleme Hizmeti'ne tıklayın.
2. Oluşturucunuzu seçin.
3. Bağlamalar sütununun altında Düzenle'yi seçin.

Application Insights ayarları, Bağlama türü sütunu altında listelenen ApplicationInsights öğesinde bulunur.

1. Application Insights derleme paketi bağlamalarını açmak ve düzenlemek için İlişkili köprüyü seçin veya üç noktanın altındaki Bağlamayı Düzenle'yi seçin.

   

2. Bağlama ayarlarını düzenleyin, ardından Kaydet'i seçin.

   

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 ayarlarını denetleme

Mevcut bir Azure Spring Apps örneğinin Application Insights ayarlarını denetlemek için aşağıdaki komutu kullanın:

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

Application Insights'i güncelleştirme

Application Insights'ı bir bağlantı dizesi (tercih edilen) veya izleme anahtarı kullanacak şekilde güncelleştirmek için aşağıdaki komutu kullanın:

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'ı kaynak adını veya kimliğini kullanacak şekilde güncelleştirmek için aşağıdaki komutu kullanın:

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 komutuyla Application Insights'ı devre dışı bırakma

Mevcut bir Azure Spring Apps örneğinde Application Insights'ı devre dışı bırakmak için aşağıdaki komutu kullanın:

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

Application Insights derleme paketi bağlamalarını yönetme

Bu bölüm yalnızca Kurumsal plan için geçerlidir ve önceki bölümü tamamlayan yönergeler sağlar.

Azure Spring Apps Enterprise planı, Azure Uygulaması lication Insights'ı türüyle ApplicationInsightstümleştirmek için derleme paketi bağlamalarını kullanır. Daha fazla bilgi için bkz . APM tümleştirmesi ve CA sertifikalarını yapılandırma.

Application Insights derleme paketi bağlaması oluşturmak için aşağıdaki komutu kullanın:

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>

Tüm derleme paketi bağlamalarını listelemek ve Application Insights bağlamalarının türünü ApplicationInsightsbulmak için aşağıdaki komutu kullanın:

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 derleme paketi bağlamasını değiştirmek için aşağıdaki komutu kullanın:

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 derleme paketi bağlaması almak için aşağıdaki komutu kullanın:

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 derleme paketi bağlamasını silmek için aşağıdaki komutu kullanın:

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>

Aşağıdaki bölümlerde Bicep, Azure Resource Manager şablonları (ARM şablonları) veya Terraform kullanarak dağıtımınızı otomatikleştirme adımları açıklanmaktadır.

Bicep

Bicep dosyası kullanarak dağıtmak için aşağıdaki içeriği bir main.bicep dosyasına kopyalayın. Daha fazla bilgi için bkz . 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 şablonları

ARM şablonu kullanarak dağıtmak için aşağıdaki içeriği bir azuredeploy.json dosyasına kopyalayın. Daha fazla bilgi için bkz . 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 dağıtımı için aşağıdaki şablonu kullanın. Daha fazla bilgi için bkz . 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"
  }
}

Kurumsal plandaki otomasyon destek bekliyor. Belgeler kullanıma sunulduğu anda eklenir.

Java aracısı JDK ile düzenli olarak güncelleştirilir/yükseltilir ve bu durum aşağıdaki senaryoları etkileyebilir.

• Güncelleştirmeden/yükseltmeden önce Java aracısını kullanan mevcut uygulamalar etkilenmez.
• Güncelleştirme/yükseltme sonrasında oluşturulan uygulamalar Java aracısının yeni sürümünü kullanır.
• Daha önce Java aracısını kullanmayan mevcut uygulamalar, Java aracısının yeni sürümünü kullanmak için yeniden başlatma veya yeniden dağıtma gerektirir.

Derleme paketi güncelleştirildiğinde Java aracısı güncelleştirilir/yükseltilir.

Java aracısı yapılandırması çalışırken yükleme

Azure Spring Apps, uygulamaların yeniden başlatılmasına gerek kalmadan aracı yapılandırması ayarlarını ayarlamak için etkin yükleme mekanizmasına sahiptir.

• Java aracısı zaten etkinse Application Insights örneğinde veya SamplingRate değerinde yapılan değişiklikler için uygulamanın yeniden başlatılması gerekmez.

• Java aracısını etkinleştirirseniz uygulamaları yeniden başlatmanız gerekir.

• Java aracısını devre dışı bıraktığınızda, uygulamalar dakikalar içinde bir gecikmeden sonra tüm izleme verilerini göndermeyi durdurur. Aracıyı Java çalışma zamanı ortamından kaldırmak için uygulamaları yeniden başlatabilirsiniz.