Bagikan melalui

Cara memantau aplikasi Spring Boot menggunakan agen New Relic Java

Note

Paket Basic, Standard, dan Enterprise memasuki periode pensiun pada 17 Maret 2025. Untuk informasi selengkapnya, lihat pengumuman penghentian Azure Spring Apps.

Artikel ini berlaku untuk:✅ 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:

  • Gunakan agen Java New Relic.
  • Konfigurasikan agen New Relic Java menggunakan variabel lingkungan.
  • Periksa 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.


Prerequisites

Mengaktifkan New Relic Java dalam agen proses

Gunakan prosedur berikut untuk mengakses agen:

  1. Buat instans Azure Spring Apps.

  2. Membuat 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 sudah memasang agen Java New Relic di /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 Microsoft Azure dengan prosedur berikut.

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

    Cuplikan layar portal Microsoft Azure memperlihatkan halaman Aplikasi untuk instans Azure Spring Apps.

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

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

    Cuplikan layar portal Microsoft Azure memperlihatkan halaman Konfigurasi untuk aplikasi dengan tab Pengaturan umum dipilih.

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

    Cuplikan layar portal Microsoft Azure memperlihatkan halaman Konfigurasi untuk aplikasi dengan tab Variabel lingkungan dipilih.

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

    Cuplikan layar dasbor New Relic memperlihatkan halaman ringkasan API Gateway.

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

    Cuplikan layar dasbor New Relic memperlihatkan halaman Layanan Pelanggan.

  7. Lihat halaman Peta Layanan dari dasbor New Relic.

    Cuplikan layar dasbor New Relic memperlihatkan halaman Peta Layanan.

  8. Lihat halaman JVM aplikasi dari dasbor New Relic.

    Cuplikan layar dasbor New Relic memperlihatkan halaman JVM.

  9. Lihat profil aplikasi dari dasbor New Relic.

    Cuplikan layar dasbor New Relic memperlihatkan halaman Profil Aplikasi.

Mengotomatiskan penyediaan

Anda juga dapat menjalankan alur otomatisasi provisi menggunakan Terraform, Bicep, atau templat Azure Resource Manager (templat ARM). Alur ini dapat memberikan pengalaman hands-off lengkap untuk melengkapi dan memantau aplikasi baru apa pun yang Anda buat dan sebarkan.

Mengotomatiskan provisi menggunakan Terraform

Untuk mengonfigurasi variabel lingkungan dalam templat Terraform, tambahkan kode berikut ke dalam templat, menggantikan placeholder <...> 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>"
  }
}

Mengotomatisasi penyediaan menggunakan file Bicep

Untuk mengonfigurasi variabel lingkungan sistem dalam file Bicep, tambahkan kode berikut ke templat, mengganti "placeholder" 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',
  ...
}

Mengotomatiskan provisi menggunakan templat ARM

Untuk mengonfigurasi variabel lingkungan dalam templat ARM, tambahkan kode berikut ke templat, ganti placeholder <...> dengan nilai milik Anda. 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 New Relic dan log APM dalam konteks.

Menampilkan log New Relic Java Agent

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

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

  • Log Azure Spring Apps
  • Azure Spring Apps Application Insights
  • 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.

Note

Jangan gunakan finer atau finest kecuali Dukungan New Relic meminta Anda untuk melakukan itu. Tingkat logging ini dapat menghasilkan overhead yang berlebihan. Untuk sebagian besar situasi, gunakan info.

Caution

Kami sangat menyarankan agar Anda tidak mengambil alih perilaku default pengelogan yang disediakan oleh Azure Spring Apps untuk New Relic. Jika Anda melakukannya, skenario pengelogan yang dijelaskan sebelumnya diblokir, dan file log mungkin hilang. Misalnya, Anda tidak boleh meneruskan variabel lingkungan berikut ke aplikasi Anda. File log mungkin hilang setelah restart atau penyebaran ulang aplikasi.

  • NEW_RELIC_LOG
  • NEW_RELIC_LOG_FILE_PATH

Pembaruan atau peningkatan New Relic Java Agent

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 ada yang menggunakan agen New Relic Java sebelum pembaruan/peningkatan memerlukan mulai ulang atau sebar ulang untuk melibatkan 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 Penyuntikan VNet

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

Langkah selanjutnya

Menggunakan Agen In-Process Java Application Insights di Azure Spring Apps

  • Last updated on