Aracılığıyla paylaş

Dynatrace Java OneAgent ile Spring Boot uygulamalarını izleme

  • Makale

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 Dynatrace OneAgent'ın nasıl kullanılacağı gösterilmektedir.

Dynatrace OneAgent ile şunları yapabilirsiniz:

  • Dynatrace OneAgent ile uygulamaları izleyin.
  • Ortam değişkenlerini kullanarak Dynatrace OneAgent'ı yapılandırın.
  • Dynatrace panosundaki tüm izleme verilerini denetleyin.

Aşağıdaki videoda Dynatrace OneAgent tanıtlanmaktadır.


Önkoşullar

Dynatrace OneAgent'ı etkinleştirme

Aşağıdaki bölümlerde Dynatrace OneAgent'ın nasıl etkinleştirilmesi açıklanmaktadır.

Azure Spring Apps ortamınızı hazırlama

  1. Azure Spring Apps örneği oluşturun.
  2. Aşağıdaki komutu çalıştırarak Dynatrace'a raporlamak istediğiniz 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-name> \
    --name <your-application-name> \
    --is-public true

Gerekli ortam değişkenleri için değerleri belirleme

Dynatrace OneAgent'ı Azure Spring Apps örneğinizde etkinleştirmek için dört ortam değişkeni yapılandırmanız gerekir: DT_TENANT, DT_TENANTTOKEN, DT_CONNECTION_POINTve DT_CLUSTER_ID. Daha fazla bilgi için bkz . OneAgent'ı Azure Spring Apps ile tümleştirme.

Birden çok örneği olan uygulamalar için Dynatrace'in bunları gruplandırmak için çeşitli yolları vardır. DT_CLUSTER_ID yollardan biridir. Daha fazla bilgi için bkz . İşlem grubu algılama.

Uygulamanıza ortam değişkenlerini ekleme

Azure portalını veya Azure CLI'yi kullanarak uygulamanıza ortam değişkeni anahtar/değer çiftlerini ekleyebilirsiniz.

1. Seçenek: Azure CLI

Azure CLI kullanarak anahtar/değer çiftlerini eklemek için aşağıdaki komutu çalıştırın ve yer tutucuları <...> yerine önceki adımlarda belirlenen değerleri yazın.

az spring app deploy \
    --resource-group <your-resource-group-name> \
    --service <your-Azure-Spring-Apps-name> \
    --name <your-application-name> \
    --artifact-path app.jar \
    --env \
        DT_TENANT=<your-environment-ID> \
        DT_TENANTTOKEN=<your-tenant-token> \
        DT_CONNECTION_POINT=<your-communication-endpoint>

2. Seçenek: Azure portalı

Azure portalını kullanarak anahtar/değer çiftlerini eklemek için aşağıdaki adımları kullanın:

  1. Azure Spring Apps örneğinizde gezinti bölmesinde Uygulamalar'ı seçin.

    Azure Spring Apps örneğinin Uygulamalar sayfasını gösteren Azure portalının ekran görüntüsü.

  2. Listeden uygulamayı seçin ve ardından gezinti bölmesinde Yapılandırma'yı seçin.

  3. Uygulamanız tarafından kullanılan değişkenleri eklemek veya güncelleştirmek için Ortam değişkenleri sekmesini kullanın.

    Ortam değişkenleri sekmesinin seçili olduğu bir uygulamanın Yapılandırma sayfasını gösteren Azure portalının ekran görüntüsü.

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.

environment_variables = {
  "DT_TENANT": "<your-environment-ID>",
  "DT_TENANTTOKEN": "<your-tenant-token>",
  "DT_CONNECTION_POINT": "<your-communication-endpoint>",
  "DT_CLUSTER_ID": "<your-cluster-ID>"
}

Bicep dosyası 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.

environmentVariables: {
  DT_TENANT: '<your-environment-ID>'
  DT_TENANTTOKEN: '<your-tenant-token>'
  DT_CONNECTION_POINT: '<your-communication-endpoint>'
  DT_CLUSTER_ID: '<your-cluster-ID>'
}

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.

"environmentVariables": {
  "DT_TENANT": "<your-environment-ID>",
  "DT_TENANTTOKEN": "<your-tenant-token>",
  "DT_CONNECTION_POINT": "<your-communication-endpoint>",
  "DT_CLUSTER_ID": "<your-cluster-ID>"
}

Dynatrace'de raporları görüntüleme

Bu bölümde Dynatrace'de çeşitli raporların nasıl bulundığı açıklanmaktadır.

Not

Dynatrace menüsü ve kullanıcı arabirimi aşamalı olarak gelişecektir. Bu nedenle pano Dynatrace web sitesindeki diğer bölümlere taşınabilir ve aşağıdaki ekran görüntüleri kullanıcı arabiriminin geçerli sürümünü yansıtmayabilir.

Ortam değişkenlerini uygulamanıza ekledikten sonra Dynatrace veri toplamaya başlar. Raporları görüntülemek için Dynatrace menüsünü kullanın, Hizmetler'e gidin ve uygulamanızı seçin.

Hizmet akışını< uygulama-adınız>/Ayrıntılar/Hizmet akışınızdan bulabilirsiniz:

Dynatrace Hizmeti akış raporunun ekran görüntüsü.

Uygulama-adınız>/Details</Method etkin noktalarından Yöntem etkin noktalarını bulabilirsiniz:

Dynatrace Yöntemi etkin noktaları raporunun ekran görüntüsü.

Veritabanı deyimlerini uygulamanızın-adı>/Ayrıntılar/Yanıt süresi analizinden <bulabilirsiniz:

Dynatrace Yanıt süresi çözümleme raporunun ve Veritabanı deyimleri bölümünün ekran görüntüsü.

Ardından Çok boyutlu analiz bölümüne gidin.

Çok boyutlu analiz/En üst veritabanı deyimlerinden En iyi veritabanı deyimlerini bulabilirsiniz:

Dynatrace Top veritabanı deyimleri raporunun ekran görüntüsü.

Çok boyutlu analiz/Özel durumlara genel bakış sayfasında Özel Durumlara genel bakış bulabilirsiniz:

Dynatrace Özel Durumlarına genel bakış raporunun ekran görüntüsü.

Ardından Profil oluşturma ve iyileştirme bölümüne gidin.

CPU analizini Profil oluşturma ve iyileştirme/CPU analizinden bulabilirsiniz:

Dynatrace CPU analiz raporunun ekran görüntüsü.

Ardından Veritabanları bölümüne gidin.

Veritabanlarından/Ayrıntılardan/Geri İlerlet'ten geri iz bulabilirsiniz:

Dynatrace Backtrace raporunun ekran görüntüsü.

Dynatrace OneAgent günlüklerini görüntüleme

Varsayılan olarak, Azure Spring Apps Dynatrace OneAgent'ın bilgi düzeyi günlüklerini olarak 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.

Dynatrace aracısının günlüklerini aşağıdaki konumlardan da alabilirsiniz:

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

Dynatrace OneAgent için günlüğe kaydetmeyi yapılandırmak için Dynatrace tarafından sağlanan bazı ortam değişkenlerini uygulayabilirsiniz. Örneğin, DT_LOGLEVELCON günlüklerin düzeyini denetler. için DT_LOGLEVELCON varsayılan değerdir info. aracının günlüklerini olarak ayarlayarak DT_LOGLEVELCON offdevre dışı bırakabilirsiniz. Günlük devre dışı bırakılırsa Dynatrace, aracı sorunlarını etkili bir şekilde tanılamak için önce günlüğe kaydetmeyi etkinleştirdiğiniz istekleri destekler. Ardından, değişikliğin geçerli olması için gerekli olan uygulamayı yeniden başlatmanız gerekir. Diğer günlük düzeyleri için Dynatrace destek ekibine başvurun.

Dikkat

Dynatrace için Azure Spring Apps tarafından sağlanan varsayılan günlüğe kaydetme davranışını geçersiz kılmamanızı kesinlikle öneririz. Bunu yaparsanız, daha önce açıklanan günlük senaryoları engellenir ve günlük dosyaları kaybolabilir. Örneğin, ortam değişkenini DT_LOGLEVELFILE uygulamalarınıza vermemelisiniz.

Dynatrace OneAgent yükseltmesi

Dynatrace OneAgent otomatik yükseltme devre dışı bırakılır ve JDK ile üç ayda bir yükseltilir. Aracı yükseltmesi aşağıdaki senaryoları etkileyebilir:

  • Yükseltmeden önce Dynatrace OneAgent kullanan mevcut uygulamalar değiştirilmez, ancak Dynatrace OneAgent'ın yeni sürümünü devreye almak için yeniden başlatma veya yeniden dağıtma gerekir.
  • Yükseltmeden sonra oluşturulan uygulamalar Dynatrace OneAgent'ın yeni sürümünü kullanır.

Sanal ağ ekleme örneği giden trafik yapılandırması

Azure Spring Apps'in sanal ağ ekleme örneği için Dynatrace iletişim uç noktaları için giden trafiğin Dynatrace OneAgent için doğru yapılandırıldığından emin olmanız gerekir. alma hakkında communicationEndpointsbilgi için bkz . Dağıtım API'si - OneAgent için GET bağlantı bilgileri. Daha fazla bilgi için bkz . Azure Spring Apps'i sanal ağda çalıştırmaya yönelik müşteri sorumlulukları.

Dynatrace destek modeli

Dynatrace OneAgent'ı yalnızca uygulama modunda dağıtırken sınırlamalar hakkında bilgi için OneAgent platformu ve yetenek desteği matrisinin Bulut uygulama platformları bölümüne bakın.

Sonraki adımlar

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