Spring Boot uygulamalarını AppDynamics Java Aracısı ile izleme

Makale
04/23/2024

Not

Azure Spring Apps, Azure Spring Cloud hizmetinin yeni adıdır. Hizmetin yeni bir adı olsa da, ekran görüntüleri, videolar ve diyagramlar gibi varlıkları güncelleştirmek için çalışırken bazı yerlerde eski adı bir süre görürsünüz.

Bu makale şunlar için geçerlidir: ✔️ Standart tüketim ve ayrılmış (Önizleme) ✔️ Temel/Standart ❌️ Kurumsal

Bu makalede, Azure Spring Apps'te Spring Boot uygulamalarını izlemek için AppDynamics Java Aracısı'nın nasıl kullanılacağı açıklanmaktadır.

AppDynamics Java Aracısı ile şunları yapabilirsiniz:

Uygulamaları izleme
Ortam değişkenlerini kullanarak AppDynamics Java Aracısını yapılandırma
AppDynamics panosundaki tüm izleme verilerini denetleme

Aşağıdaki videoda AppDynamics Java işlem içi aracısı tanıtılır.

Önkoşullar

AppDynamics Java işlem içi aracısını etkinleştirme

İş akışının tamamı için şunları yapmanız gerekir:

Uygulama ölçümleri verileri oluşturmak için Azure Spring Apps'te AppDynamics Java işlem içi aracısını etkinleştirin.
Denetleyicideki verileri toplamak ve görselleştirmek için AppDynamics Aracısını AppDynamics Denetleyicisine Bağlan.

Azure Spring Apps'te Spring Boot Uygulamalarına iki yönlü ok ve AppDynamics Aracısı'nı işaret eden ok ile AppDynamics Aracısı'nı gösteren diyagram.

Azure CLI kullanarak AppDynamics Aracısı ile bir uygulamayı etkinleştirme

Azure CLI aracılığıyla bir uygulamayı etkinleştirmek için aşağıdaki adımları kullanın.

Kaynak grubu oluşturun.
Azure Spring Apps örneği oluşturun.

Aşağıdaki komutu kullanarak bir uygulama oluşturun. Yer tutucuları <...> yerine kendi değerlerinizi yazın.

az spring app create \
    --resource-group "<your-resource-group-name>" \
    --service "<your-Azure-Spring-Apps-instance-name>" \
    --name "<your-app-name>" \
    --is-public true

Ortam değişkenlerini kullanarak AppDynamics Aracısı ile bir dağıtım oluşturun.

az spring app deploy \
    --resource-group "<your-resource-group-name>" \
    --service "<your-Azure-Spring-Apps-instance-name>" \
    --name "<your-app-name>" \
    --artifact-path app.jar \
    --jvm-options="-javaagent:/opt/agents/appdynamics/java/javaagent.jar" \
    --env APPDYNAMICS_AGENT_APPLICATION_NAME=<your-app-name> \
          APPDYNAMICS_AGENT_ACCOUNT_ACCESS_KEY=<your-agent-access-key> \
          APPDYNAMICS_AGENT_ACCOUNT_NAME=<your-agent-account-name> \
          APPDYNAMICS_JAVA_AGENT_REUSE_NODE_NAME=true \
          APPDYNAMICS_JAVA_AGENT_REUSE_NODE_NAME_PREFIX=<your-agent-node-name> \
          APPDYNAMICS_AGENT_TIER_NAME=<your-agent-tier-name> \
          APPDYNAMICS_CONTROLLER_HOST_NAME=<your-AppDynamics-controller-host-name> \
          APPDYNAMICS_CONTROLLER_SSL_ENABLED=true \
          APPDYNAMICS_CONTROLLER_PORT=443

Azure Spring Apps, AppDynamics Java aracısını /opt/agents/appdynamics/java/javaagent.jar yoluna önceden yükler. Aracıyı uygulamalarınızın JVM seçeneklerinden etkinleştirebilir ve ardından ortam değişkenlerini kullanarak aracıyı yapılandırabilirsiniz. Bu değişkenlerin değerlerini Azure Spring Apps'i Java Aracısı ile İzleme adresinde bulabilirsiniz. Bu değişkenlerin AppDynamics kullanıcı arabiriminde raporları görüntülemeye ve düzenlemeye nasıl yardımcı olduğu hakkında daha fazla bilgi için bkz . Katmanlar ve Düğümler.

Azure portalını kullanarak AppDynamics Aracısı ile bir uygulamayı etkinleştirme

Azure portalı aracılığıyla bir uygulamayı etkinleştirmek için aşağıdaki adımları kullanın.

Azure portalında Azure Spring Apps örneğine gidin.
Gezinti bölmesinin Ayarlar bölümünde Uygulamalar'ı seçin.
Uygulamayı seçin ve ardından gezinti bölmesinde Yapılandırma'yı seçin.
JVM seçenekleri gibi değerleri güncelleştirmek için Genel ayarlar sekmesini kullanın.
Uygulamanız tarafından kullanılan değişkenleri eklemek veya güncelleştirmek için Ortam değişkenleri'ni seçin.

Sağlamayı otomatikleştirme

Terraform, Bicep veya Azure Resource Manager şablonunu (ARM şablonu) kullanarak bir sağlama otomasyonu işlem hattı da çalıştırabilirsiniz. Bu işlem hattı, oluşturup dağıttığınız tüm yeni uygulamaları izlemek ve izlemek için eksiksiz bir uygulamalı kullanım deneyimi sağlayabilir.

Terraform kullanarak sağlamayı otomatikleştirme

Terraform şablonunda ortam değişkenlerini yapılandırmak için şablona aşağıdaki kodu ekleyin ve ...> yer tutucularını kendi değerlerinizle değiştirin<. Daha fazla bilgi için bkz . Etkin Azure Spring Apps Dağıtımlarını Yönetme.

resource "azurerm_spring_cloud_java_deployment" "example" {
  ...
  jvm_options = "-javaagent:/opt/agents/appdynamics/java/javaagent.jar"
  ...
    environment_variables = {
      "APPDYNAMICS_AGENT_APPLICATION_NAME" : "<your-app-name>",
      "APPDYNAMICS_AGENT_ACCOUNT_ACCESS_KEY" : "<your-agent-access-key>",
      "APPDYNAMICS_AGENT_ACCOUNT_NAME" : "<your-agent-account-name>",
      "APPDYNAMICS_JAVA_AGENT_REUSE_NODE_NAME" : "true",
      "APPDYNAMICS_JAVA_AGENT_REUSE_NODE_NAME_PREFIX" : "<your-agent-node-name>",
      "APPDYNAMICS_AGENT_TIER_NAME" : "<your-agent-tier-name>",
      "APPDYNAMICS_CONTROLLER_HOST_NAME" : "<your-AppDynamics-controller-host-name>",
      "APPDYNAMICS_CONTROLLER_SSL_ENABLED" : "true",
      "APPDYNAMICS_CONTROLLER_PORT" : "443"
  }
}

Bicep kullanarak sağlamayı otomatikleştirme

Bir Bicep dosyasında ortam değişkenlerini yapılandırmak için aşağıdaki kodu dosyaya ekleyin ve ...> yer tutucularını kendi değerlerinizle değiştirin<. Daha fazla bilgi için bkz . Microsoft.AppPlatform Spring/apps/deployments.

deploymentSettings: {
  environmentVariables: {
    APPDYNAMICS_AGENT_APPLICATION_NAME : '<your-app-name>'
    APPDYNAMICS_AGENT_ACCOUNT_ACCESS_KEY : '<your-agent-access-key>'
    APPDYNAMICS_AGENT_ACCOUNT_NAME : '<your-agent-account-name>'
    APPDYNAMICS_JAVA_AGENT_REUSE_NODE_NAME : 'true'
    APPDYNAMICS_JAVA_AGENT_REUSE_NODE_NAME_PREFIX : '<your-agent-node-name>'
    APPDYNAMICS_AGENT_TIER_NAME : '<your-agent-tier-name>'
    APPDYNAMICS_CONTROLLER_HOST_NAME : '<your-AppDynamics-controller-host-name>'
    APPDYNAMICS_CONTROLLER_SSL_ENABLED : 'true'
    APPDYNAMICS_CONTROLLER_PORT : '443'
  }
  jvmOptions: '-javaagent:/opt/agents/appdynamics/java/javaagent.jar'
}

ARM şablonu kullanarak sağlamayı otomatikleştirme

BIR ARM şablonunda ortam değişkenlerini yapılandırmak için şablona aşağıdaki kodu ekleyin ve ...> yer tutucularını kendi değerlerinizle değiştirin<. Daha fazla bilgi için bkz . Microsoft.AppPlatform Spring/apps/deployments.

"deploymentSettings": {
  "environmentVariables": {
    "APPDYNAMICS_AGENT_APPLICATION_NAME" : "<your-app-name>",
    "APPDYNAMICS_AGENT_ACCOUNT_ACCESS_KEY" : "<your-agent-access-key>",
    "APPDYNAMICS_AGENT_ACCOUNT_NAME" : "<your-agent-account-name>",
    "APPDYNAMICS_JAVA_AGENT_REUSE_NODE_NAME" : "true",
    "APPDYNAMICS_JAVA_AGENT_REUSE_NODE_NAME_PREFIX" : "<your-agent-node-name>",
    "APPDYNAMICS_AGENT_TIER_NAME" : "<your-agent-tier-name>",
    "APPDYNAMICS_CONTROLLER_HOST_NAME" : "<your-AppDynamics-controller-host-name>",
    "APPDYNAMICS_CONTROLLER_SSL_ENABLED" : "true",
    "APPDYNAMICS_CONTROLLER_PORT" : "443"
  },
  "jvmOptions": "-javaagent:/opt/agents/appdynamics/java/javaagent.jar",
  ...
}

AppDynamics panosunda raporları gözden geçirme

Bu bölümde AppDynamics'teki çeşitli raporlar gösterilir.

Aşağıdaki ekran görüntüsünde AppDynamics panosundaki uygulamalarınıza genel bir bakış gösterilmektedir:

Uygulamalar sekmesi, örnek uygulamalar kullanılarak aşağıdaki ekran görüntülerinde gösterildiği gibi her bir uygulamanıza ilişkin genel bilgileri gösterir:

api-gateway
customers-service

Aşağıdaki ekran görüntüsünde, Veritabanı Çağrıları panosundan temel bilgileri nasıl alabileceğiniz gösterilmektedir.

Aşağıdaki ekran görüntülerinde gösterildiği gibi en yavaş veritabanı çağrıları hakkında da bilgi alabilirsiniz:

Aşağıdaki ekran görüntüsünde, Bellek sayfasının Yığın bölümünde bellek kullanım analizi gösterilmektedir:

Bu ekran görüntüsünde gösterildiği gibi çöp toplama işlemini de görebilirsiniz:

Aşağıdaki ekran görüntüsünde Yavaş İşlemler sayfası gösterilmektedir :

Ölçüm Tarayıcısı'nın bu ekran görüntüsünde gösterildiği gibi JVM için daha fazla ölçüm tanımlayabilirsiniz:

AppDynamics Aracısı günlüklerini görüntüleme

Varsayılan olarak, Azure Spring Apps AppDynamics Aracısı'nın bilgi düzeyi günlüklerini öğesine STDOUTyazdırır. Günlükler uygulama günlükleriyle karıştırılır. Açık aracı sürümünü uygulama günlüklerinden bulabilirsiniz.

AppDynamics Aracısı günlüklerini aşağıdaki konumlardan da alabilirsiniz:

Azure Spring Apps günlükleri
Azure Spring Apps Uygulama Analizler
Azure Spring Apps LogStream

AppDynamics Aracısı yükseltmesi hakkında bilgi edinin

AppDynamics Aracısı, JDK (üç aylık) ile düzenli olarak yükseltilir. Aracı yükseltmesi aşağıdaki senaryoları etkileyebilir:

Yükseltmeden önce AppDynamics Aracısı kullanan mevcut uygulamalar değiştirilmez, ancak AppDynamics Aracısı'nın yeni sürümünü devreye almak için yeniden başlatmayı veya yeniden dağıtmayı gerektirir.
Yükseltmeden sonra oluşturulan uygulamalar AppDynamics Aracısı'nın yeni sürümünü kullanır.

Sanal ağ ekleme örneği giden trafiğini yapılandırma

Azure Spring Apps'in sanal ağ ekleme örnekleri için, AppDynamics Aracısı için giden trafiğin doğru yapılandırıldığından emin olun. Ayrıntılar için bkz . Cisco AppDynamics SaaS Etki Alanları ve IP Aralıkları ve Azure Spring Apps'i sanal ağda çalıştırmak için müşteri sorumlulukları.

Sınırlamaları anlama

AppDynamics Aracısı'nın sınırlamalarını anlamak için bkz . Azure Spring Apps'i Java Aracısı ile izleme.

Sonraki adımlar

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