Function Compute：Ekstensi ARMS untuk runtime kustom

Informasi latar belakang

Function Compute terintegrasi secara mulus dengan ARMS. Anda dapat menggunakan ARMS untuk memantau dan melacak fungsi guna mendapatkan informasi seperti data deret waktu dari instance, jejak, metrik Java Virtual Machine (JVM), profil tingkat kode, dan informasi keamanan aplikasi. Untuk detail lebih lanjut, lihat Apa itu ARMS?.

Menghubungkan runtime kustom ke ARMS

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

Menggunakan lapisan publik untuk mendapatkan agen ARMS

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

Menggunakan skrip Bootstrap sebagai perintah startup

#!/bin/bash
set -eo pipefail

#1. Tentukan nama untuk aplikasi ARMS.
appName="FC:Custom_Java_Arms_Demo"
if [ -n "${FC_SERVICE_NAME}" ] || [ -n "${FC_FUNCTION_NAME}" ]; then
    appName="FC:${FC_SERVICE_NAME}.${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 dari 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 variabel 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

• Atur variabel lingkungan FC_EXTENSIONS_ARMS_LICENSE_KEY=xxxx ke nilai kunci lisensi. Untuk informasi tentang cara memperoleh kunci lisensi, lihat langkah "Memperoleh Kunci Lisensi" di Instal Agen ARMS untuk Aplikasi Java di Function Compute.

• Konfigurasikan variabel lingkungan FC_EXTENSION_ARMS=true.

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

  Penting

  Jika Anda menggunakan metode ini, Anda akan dikenakan biaya. Metode penagihan sama dengan metode penagihan Prefreeze hook dari instance. Untuk informasi lebih lanjut, lihat Aturan Penagihan.

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.

• Layanan ARMS telah diaktifkan. Untuk informasi lebih lanjut, lihat Aktivasi ARMS.

Prosedur

1. Masuk ke Konsol Function Compute. Di panel navigasi kiri, klik Services & Functions.

2. Di bilah navigasi atas, pilih wilayah. Pada halaman Services, klik layanan yang diinginkan.

3. Pada halaman Functions, temukan fungsi yang diinginkan dan klik Configure di kolom Actions.

4. Di bagian Layers halaman konfigurasi fungsi, klik Add Official Common Layer untuk menambahkan lapisan ArmsAgent yang kompatibel dengan versi Java.

5. Di bagian Environment Variables pada halaman konfigurasi fungsi, tambahkan variabel lingkungan FC_EXTENSION_ARMS=true dan FC_EXTENSIONS_ARMS_LICENSE_KEY=xxxx.

   Untuk informasi lebih lanjut, lihat Konfigurasi Variabel Lingkungan.

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

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

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

Verifikasi hasil

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