Application Real-Time Monitoring Service：Instal agen ARMS untuk aplikasi Java di Function Compute

Informasi latar belakang

Setelah Function Compute terintegrasi dengan ARMS, Anda dapat menggunakan ARMS untuk memantau dan melacak fungsi serta memperoleh informasi seperti observabilitas tingkat instance, informasi pelacakan, metrik Java Virtual Machine, profil tingkat kode, dan informasi keamanan aplikasi.

Prasyarat

• Fungsi dalam runtime kustom telah dibuat dan runtime tersebut menggunakan Java 8, Java 11, atau Java 17. Untuk informasi lebih lanjut, lihat Buat Fungsi.

• Versi JDK didukung oleh Pemantauan Aplikasi. Untuk informasi lebih lanjut, lihat Komponen dan Framework Java yang Didukung oleh ARMS.

• Memori heap maksimum proses lebih besar dari 256 MB.

Peroleh kunci lisensi

Peroleh kunci lisensi di OpenAPI Explorer. Untuk informasi lebih lanjut, lihat DescribeTraceLicenseKey.

Hubungkan runtime kustom ke ARMS

Anda dapat mengintegrasikan ARMS ke dalam runtime kustom sebagai ekstensi internal. Bagian berikut menjelaskan cara menghubungkan runtime kustom ke ARMS.

Gunakan lapisan umum untuk mendapatkan agen ARMS

Function Compute menggunakan lapisan umum untuk menyediakan agen ARMS yang mendukung Java 8, Java 11, dan Java 17.

Gunakan skrip bootstrap untuk memulai aplikasi

#!/bin/bash
set -eo pipefail

#1. Tentukan nama untuk aplikasi ARMS.
appName="FC:Custom_Java_Arms_Demo"
if [ -n "${FC_FUNCTION_NAME}" ]; then
    appName="FC:${FC_FUNCTION_NAME}"
fi

echo "appName: ${appName}"
params=" "

#2. Tambahkan parameter ARMS.
if [[ -n "${FC_EXTENSIONS_ARMS_LICENSE_KEY}" ]]; then
    echo "FC_EXTENSIONS_ARMS_LICENSE_KEY: ${FC_EXTENSIONS_ARMS_LICENSE_KEY}"
    params+="-Dfc.instanceId=$HOSTNAME@`hostname -i` "
    # Gunakan jalur program ARMS di lapisan umum.
    params+="-javaagent:/opt/ArmsAgent/arms-bootstrap-1.7.0-SNAPSHOT.jar "
    params+="-Darms.licenseKey=${FC_EXTENSIONS_ARMS_LICENSE_KEY} "
    params+="-Darms.appName=${appName} "
else
    echo "Lingkungan FC_EXTENSIONS_ARMS_LICENSE_KEY tidak ada, silakan atur lingkungan FC_EXTENSIONS_ARMS_LICENSE_KEY!"
    exit 1
fi

#3. Jalankan aplikasi.
echo "params: ${params}"
exec java $params \
    -Dserver.port=9000 \
    -jar /code/target/demo-0.0.1-SNAPSHOT.jar

Konfigurasikan variabel lingkungan

• Konfigurasikan variabel lingkungan FC_EXTENSIONS_ARMS_LICENSE_zKEY=xxxx dengan menyetel nilainya menjadi kunci lisensi. Untuk informasi lebih lanjut tentang cara memperoleh kunci lisensi, lihat Obtain a license key.

• Atur variabel lingkungan FC_EXTENSION_ARMS=true.

  Setelah variabel lingkungan ditambahkan, instance fungsi akan dibekukan selama 10 detik setelah pemanggilan fungsi selesai. Ini memastikan bahwa agen ARMS dapat melaporkan log sesuai harapan.

  Penting

  Setelah pemanggilan selesai, biaya terus dihasilkan sebelum instance dibekukan berdasarkan aturan penagihan yang sama selama pemanggilan. Untuk informasi lebih lanjut, lihat Tagihan.

Prosedur

1. Masuk ke Konsol Function Compute. Di panel navigasi di sebelah kiri, klik Functions.

2. Di bilah navigasi atas, pilih wilayah. Di halaman Functions, klik fungsi yang ingin Anda kelola.

3. Di halaman detail fungsi, klik tab Configurations.

4. Di panel navigasi di sebelah kiri, klik Layers. Di halaman yang muncul, klik Modify. Di panel Layers, pilih + Add Layer > Add Official Common Layer untuk menambahkan lapisan agen ARMS yang kompatibel dengan runtime Java Anda.

5. Di panel navigasi di sebelah kiri, klik Environment Variables. Di halaman yang muncul, klik Modify untuk mengonfigurasi variabel lingkungan berikut: FC_EXTENSION_ARMS=true dan FC_EXTENSIONS_ARMS_LICENSE_KEY=xxxx

   Untuk informasi lebih lanjut, lihat Konfigurasikan Variabel Lingkungan.

6. Di WebIDE halaman kode fungsi, buat file bootstrap dan klik Deploy.

   Untuk informasi lebih lanjut, lihat Gunakan Skrip Bootstrap sebagai Perintah Startup.

   Setelah Anda memperbarui konfigurasi dan menerapkan kode, fungsi ditambahkan ke ARMS untuk manajemen berperforma tinggi. Anda akan dikenakan biaya untuk menggunakan ARMS. Untuk informasi lebih lanjut, lihat Ikhtisar.

Periksa hasil eksekusi pekerjaan HTTP

Setelah Anda menghubungkan fungsi ke ARMS, Anda dapat melihat fungsi tersebut di konsol ARMS.