Cara memantau aplikasi Spring Boot dengan menggunakan agen New Java Relic

Artikel ini berlaku untuk: ✔️ Konsumsi standar dan khusus (Pratinjau) ✔️ Basic/Standard ❌ Enterprise

Artikel ini memperlihatkan kepada Anda cara memantau aplikasi Spring Boot di Azure Spring Apps dengan agen New Relic Java.

Dengan agen New Relic Java, Anda dapat:

• Menggunakan agen New Relic Java.
• Mengonfigurasi agen New Relic Java menggunakan variabel lingkungan.
• Memeriksa semua data pemantauan dari dasbor New Relic.

Video berikut menjelaskan cara mengaktifkan dan memantau aplikasi Spring Boot di Azure Spring Apps menggunakan New Relic One.

Prasyarat

• Akun New Relic.
• Azure CLI versi 2.0.67 atau yang lebih baru.

Mengaktifkan New Relic Java dalam agen proses

Gunakan prosedur berikut untuk mengakses agen:

1. Buat instans Azure Spring Apps.

2. Buat aplikasi.

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

3. Buat penyebaran dengan agen New Relic dan variabel Lingkungan.

   az spring app deploy \
       --resource-group <resource-group-name> \
       --service <Azure-Spring-Apps-instance-name> \
       --name <app-name> \
       --artifact-path app.jar \
       --jvm-options="-javaagent:/opt/agents/newrelic/java/newrelic-agent.jar" \
       --env NEW_RELIC_APP_NAME=appName \
             NEW_RELIC_LICENSE_KEY=newRelicLicenseKey
   

Azure Spring Apps telah menginstal agen New Relic Java ke /opt/agents/newrelic/java/newrelic-agent.jar. Pelanggan dapat mengaktifkan agen dari opsi JVM aplikasi, dan mengonfigurasi agen menggunakan variabel lingkungan agen New Relic Java.

Portal Azure

Anda juga dapat mengaktifkan agen ini dari portal Azure dengan prosedur berikut.

1. Di instans Azure Spring Apps Anda, pilih Aplikasi di panel navigasi.

   

2. Pilih aplikasi dari daftar, lalu pilih Konfigurasi di panel navigasi.

3. Gunakan tab Pengaturan umum untuk memperbarui nilai seperti opsi JVM.

   

4. Pilih Variabel lingkungan untuk menambahkan atau memperbarui variabel yang digunakan oleh aplikasi Anda.

   

5. Lihat halaman Ringkasan api/gateway aplikasi dari dasbor New Relic.

   

6. Tampilkan halaman Ringkasan layanan pelanggan aplikasi dari dasbor New Relic.

   

7. Tampilkan halaman Peta Layanan dari dasbor New Relic.

   

8. Tampilkan halaman JVM aplikasi dari dasbor New Relic.

   

9. Tampilkan profil aplikasi dari dasbor New Relic.

   

Mengotomatiskan penyediaan

Anda juga dapat menjalankan alur otomatisasi provisi menggunakan Terraform, Bicep, atau templat Azure Resource Manager (templat ARM). Alur ini dapat memberikan pengalaman penyerahan yang lengkap untuk instrumen dan memantau setiap aplikasi baru yang Anda buat dan sebarkan.

Melakukan provisi otomatis dengan menggunakan Terraform

Untuk mengonfigurasi variabel lingkungan di template Terraform, tambahkan kode berikut ke template, ganti tempat penampung <...> dengan nilai Anda sendiri. Untuk informasi selengkapnya, lihat Mengelola Penyebaran Azure Spring Apps Aktif.

resource "azurerm_spring_cloud_java_deployment" "example" {
  ...
  jvm_options = "-javaagent:/opt/agents/newrelic/java/newrelic-agent.jar"
  ...
    environment_variables = {
      "NEW_RELIC_APP_NAME": "<app-name>",
      "NEW_RELIC_LICENSE_KEY": "<new-relic-license-key>"
  }
}

Mengotomatiskan provisi menggunakan file Bicep

Untuk mengonfigurasi variabel lingkungan dalam file Bicep, tambahkan kode berikut ke templat, ganti <tempat penampung ...> dengan nilai Anda sendiri. Untuk informasi selengkapnya, lihat Microsoft.AppPlatform Spring/apps/deployments.

deploymentSettings: {
  environmentVariables: {
    NEW_RELIC_APP_NAME : '<app-name>',
    NEW_RELIC_LICENSE_KEY : '<new-relic-license-key>'
  },
  jvmOptions: '-javaagent:/opt/agents/newrelic/java/newrelic-agent.jar',
  ...
}

Melakukan provisi otomatis dengan menggunakan templat ARM

Untuk mengonfigurasi variabel lingkungan di template ARM, tambahkan kode berikut ke template, ganti tempat penampung <...> dengan nilai Anda sendiri. Untuk informasi selengkapnya, lihat Microsoft.AppPlatform Spring/apps/deployments.

"deploymentSettings": {
  "environmentVariables": {
    "NEW_RELIC_APP_NAME" : "<app-name>",
    "NEW_RELIC_LICENSE_KEY" : "<new-relic-license-key>"
  },
  "jvmOptions": "-javaagent:/opt/agents/newrelic/java/newrelic-agent.jar",
  ...
}

Meneruskan log aplikasi ke New Relic

Agen New Relic dapat mengumpulkan log aplikasi langsung dari aplikasi Anda, dan meneruskannya ke New Relic. Untuk informasi selengkapnya, lihat Meneruskan log Anda ke log New Relic dan APM dalam konteks.

Menampilkan log New Relic Java Agent

Secara default, Azure Spring Apps mencetak log agen New Relic Java ke STDOUT. Log dicampur dengan log aplikasi. Anda dapat menemukan versi agen eksplisit dari log aplikasi.

Anda juga bisa mendapatkan log agen New Relic dari lokasi berikut:

• Log Aplikasi Azure Spring
• Application Insights Azure Spring Apps
• Azure Spring Apps LogStream

Anda dapat menggunakan beberapa variabel lingkungan yang disediakan oleh New Relic untuk mengonfigurasi pengelogan Agen Baru, seperti, NEW_RELIC_LOG_LEVEL untuk mengontrol tingkat log. Untuk informasi selengkapnya, lihat Konfigurasi pengelogan New Relic.

Pembaruan/peningkatan Agen New Relic Java

Agen New Relic Java memperbarui/meningkatkan JDK secara teratur. Pembaruan/peningkatan agen dapat memengaruhi skenario berikut.

• Aplikasi yang ada yang menggunakan agen New Relic Java sebelum pembaruan/peningkatan tidak berubah.
• Aplikasi yang sudah ada yang menggunakan agen New Relic Java sebelum pembaruan/peningkatan memerlukan mulai ulang atau menyebarkan ulang untuk mengaktifkan versi baru agen New Relic Java.
• Aplikasi baru yang dibuat setelah pembaruan/peningkatan menggunakan versi baru agen New Relic Java.

Konfigurasi Lalu Lintas Keluar Instans Injeksi Vnet

Untuk instans injeksi vnet Aplikasi Azure Spring, Anda perlu memastikan lalu lintas keluar dikonfigurasi dengan benar untuk agen New Java Relic. Untuk mengetahui informasi selengkapnya, lihat Jaringan New Relic.

Langkah berikutnya

Menggunakan Agen Dalam Proses Java Application Insights di Azure Spring Apps