All Products
Search

This Product

    Serverless App Engine:Konfigurasikan pengumpulan log ke SLS

    Document Center

    Serverless App Engine:Konfigurasikan pengumpulan log ke SLS

    Last Updated:Jun 22, 2026

    Mengumpulkan log output standar atau file log dari aplikasi SAE ke Simple Log Service (SLS) memungkinkan penyimpanan persisten dan analisis teragregasi.

    Prasyarat

    • Pastikan Simple Log Service telah diaktifkan. Jika belum, login ke Simple Log Service console dan ikuti petunjuk di layar untuk mengaktifkannya.

    • Pastikan setiap instans dalam aplikasi Anda memiliki setidaknya CPU 0,25 core dan memori tersedia sebesar 250 MB.

    Aktifkan pengumpulan log

    Prosedur: 

    1. Buat aplikasi

      Pada halaman SAE Application List, pilih wilayah dan namespace target di bagian atas, lalu klik Create Application. Pada halaman Application Basic Information, konfigurasikan parameter dan klik Next: Advanced Settings.

      Ubah aplikasi yang sedang berjalan

      Peringatan

      Men-deploy ulang aplikasi akan me-restart-nya. Untuk menghindari masalah tak terduga seperti gangguan layanan, lakukan operasi deployment selama jam sepi.

      Pada halaman SAE Application List, pilih wilayah dan namespace target di bagian atas, lalu klik application ID target untuk membuka halaman detail aplikasi. Di panel navigasi kiri, klik Basic Information, lalu klik Deploy Application di pojok kanan atas.

      Ubah aplikasi yang dihentikan

      Pada halaman SAE Application List, pilih wilayah dan namespace target di bagian atas, lalu klik application ID target untuk membuka halaman detail aplikasi. Klik Basic Information, lalu klik Modify Application Configuration.

    2. Bentangkan bagian Log Settings dan aktifkan SLS Log Service.

    Detail konfigurasi:

    • Pilih resource SLS untuk menyimpan log aplikasi SAE:

      • Create Simple Log Service Resource: Sistem secara otomatis membuat Project SLS. Nama Project menggunakan format sae-<random_string>.

      • Use Existing Simple Log Service Resources: Pilih Project SLS yang sudah ada. Project tersebut harus berada di wilayah yang sama dengan aplikasi.

    • Log labels: Digunakan untuk mengidentifikasi dan mengkategorikan entri log. Setelah Anda mengaktifkan Custom Log Labels, pilih Type untuk mengonfigurasi Key dan Value. Untuk mengonfigurasi beberapa pasangan kunci-nilai, klik Add.

      • Custom: Masukkan Variable Name dan Variable Value.

      • Reference Configuration Item: Masukkan Variable Name, lalu pilih Configuration Item Name dan Key yang sudah ada.

      Catatan

      Fitur ini saat ini dalam pratinjau undangan. Jika ingin menggunakannya, hubungi tim teknis di grup DingTalk (ID grup: 32874633) untuk mengaktifkannya.

    • Collection Log Type:

      • File Logs (Log Path in Container): Gunakan opsi ini jika aplikasi Anda menulis log ke file. Di bidang Log Source, tentukan jalur mutlak file log di dalam kontainer, termasuk nama file-nya. Contoh: /tmp/cjsc.log. Pencocokan ekspresi reguler didukung. Contoh: /path/to/your/files/*.log.

      • Container Standard Output Logs: Gunakan opsi ini jika aplikasi Anda mencetak log ke output standar. Log Source akan ditampilkan sebagai stdout.log.

      • Klik + Add untuk menambahkan beberapa catatan.

      • Jika Anda memilih Use Existing Simple Log Service Resources, Anda dapat mengonfigurasi logstoreName dan logtail untuk setiap catatan.

      Penting

      • Jangan menyimpan file penting lainnya di jalur yang ditentukan sebagai Log Source untuk mencegah file lain di direktori tersebut tertimpa. Misalnya, jika file yang dapat dieksekusi dan data aplikasi Anda disimpan di /home/admin/app/ dan Anda menetapkan jalur penyimpanan log ke /home/admin/, semua direktori dan file di bawah jalur ini akan tertimpa. Untuk menghindari masalah ini, tetapkan jalur penyimpanan log ke direktori khusus seperti /home/admin/log/.

      • Selama rilis batch atau rilis bertahap, jika Anda hanya mengubah Project atau Logstore, log tetap dikumpulkan ke tujuan semula hingga semua batch selesai dideploy. Hal ini karena SLS tidak mendukung pengumpulan log dari file yang sama ke Project atau Logstore yang berbeda.

    Verifikasi hasil:

    1. Pada halaman SAE Application List, pilih wilayah dan namespace target di bagian atas, lalu klik application ID target untuk membuka halaman detail aplikasi.

    2. Klik untuk melihat log SLS.

    3. Di kolom Actions, klik File Logs untuk membuka Logstore yang sesuai dan melihat detail log.

    Hapus awalan dari konten log

    Saat Anda mengumpulkan log stdout kontainer, konten log mentah mencakup awalan yang berlebihan. Anda dapat menggunakan salah satu metode berikut untuk menghapus awalan tersebut.

    Metode 1: Sesuaikan konfigurasi Logtail

    Penting

    Fitur ini hanya berlaku untuk Logtail 2.0 dan versi lebih baru. Jika ingin menggunakannya, hubungi tim teknis di grup DingTalk (ID grup: 32874633) untuk meningkatkan versi Logtail pada aplikasi SAE Anda.

    1. Bentangkan Logstore yang sesuai dan klik Logtail Configurations.

    2. Pada halaman Logtail Configurations, klik item konfigurasi Logtail target.

    3. Klik Edit dan konfigurasikan pengaturan berikut. Biarkan parameter lain pada nilai default-nya.

      1. Bentangkan bagian Processor Configurations dan atur Processing Method If Splitting Fails menjadi Retain Single Line.

      2. Atur Processing Method menjadi SPL.

      3. Di bidang SPL Statement, masukkan * | extend msg=regexp_replace(content, '(\S{33,36}\s\S+\sF\s)','') | project-away content.

    4. Klik Save.

    5. Log yang baru dikumpulkan tidak lagi menyertakan awalan tersebut.

    Metode 2: Arahkan ulang output standar

    1. Buat aplikasi

      Pada halaman SAE Application List, pilih wilayah dan namespace target di bagian atas, lalu klik Create Application. Pada halaman Application Basic Information, konfigurasikan parameter dan klik Next: Advanced Settings.

      Ubah aplikasi yang sedang berjalan

      Peringatan

      Men-deploy ulang aplikasi akan me-restart-nya. Untuk menghindari masalah tak terduga seperti gangguan layanan, lakukan operasi deployment selama jam sepi.

      Pada halaman SAE Application List, pilih wilayah dan namespace target di bagian atas, lalu klik application ID target untuk membuka halaman detail aplikasi. Di panel navigasi kiri, klik Basic Information, lalu klik Deploy Application di pojok kanan atas.

      Ubah aplikasi yang dihentikan

      Pada halaman SAE Application List, pilih wilayah dan namespace target di bagian atas, lalu klik application ID target untuk membuka halaman detail aplikasi. Klik Basic Information, lalu klik Modify Application Configuration.

    2. Bentangkan bagian Startup Command dan konfigurasikan perintah startup untuk mengarahkan ulang output standar:

      Untuk aplikasi berbasis image, tambahkan 2>&1 | tee -a /home/admin/log/std.log ke perintah startup asli. Jalur /home/admin/log/std.log adalah jalur file log, yang dapat Anda sesuaikan.

      Sebagai contoh, jika perintah startup asli dalam image adalah CMD ["./main"], atur perintah startup menjadi ./main 2>&1 | tee -a /home/admin/log/std.log.

      Jika lingkungan image tidak mendukung perintah tee atau jika Anda tidak perlu melihat log waktu nyata di konsol, ganti 2>&1 | tee -a /home/admin/log/std.log dengan > /home/admin/log/std.log 2>&1.

    3. Bentangkan bagian Log Settings. Atur Collection Log Type menjadi File Logs (Log Path in Container) dan atur Log Source ke jalur file log, misalnya /home/admin/log/std.log.

    4. Klik OK dan tunggu hingga proses deployment aplikasi selesai.

    5. Log yang baru dikumpulkan tidak lagi menyertakan awalan tersebut.

    Tingkatkan kinerja pengumpulan Logtail

    Di konsol SAE, Anda dapat mengatur variabel lingkungan untuk mengonfigurasi parameter startup Logtail. Mengonfigurasi parameter ini meningkatkan kinerja pengumpulan Logtail dan membantu mengatasi bottleneck yang memengaruhi pengumpulan log, seperti penggunaan memori besar oleh file log, trafik data log tinggi, dan laju pengiriman data Logtail yang tinggi.

    Di bagian Environment Variable, pilih Custom atau Reference Configuration Item, lalu masukkan Variable Name dan Variable Value/Variable Reference. Untuk detailnya, lihat Set environment variables.

    • Aturan penamaan variabel

      Tambahkan awalan sls_ ke variabel lingkungan Logtail yang ingin Anda konfigurasi. Sebagai contoh, jika Anda ingin menambahkan parameter Logtail max_read_buffer_size, atur variabel lingkungan menjadi sls_max_read_buffer_size. Parameter ini menentukan ukuran maksimum entri log tunggal yang dapat dibaca oleh Logtail, yaitu 524.288 byte dalam contoh ini. Untuk parameter lainnya, lihat Set Logtail startup parameters.

    • Pemetaan antara variabel lingkungan dan parameter startup Logtail

      Untuk detailnya, lihat Environment variable descriptions.

    Kuota dan batasan

    Setiap Akun Alibaba Cloud dapat membuat hingga 200 penyimpanan log dan 50 Proyek. Batasan pada resource dasar SLS dapat memengaruhi pengumpulan log untuk aplikasi SAE, menyebabkan masalah seperti periode retensi log yang singkat atau kegagalan pengumpulan. Untuk batasan penggunaan lebih lanjut, lihat Basic resource limits.

    Penagihan

    Penggunaan Simple Log Service dikenai biaya tambahan. Untuk detailnya, lihat SLS billing.

    FAQ

    • Apakah pengumpulan log SAE mendukung rotasi log?

      Ya. Anda dapat menerapkan rotasi log dengan menambahkan wildcard ke nama file log.

      Wildcard yang didukung untuk nama file adalah tanda bintang (*) dan tanda tanya (?).

    • Tidak ada data yang muncul di SLS console saat saya melihat log file. Apa yang harus saya lakukan?

      Secara default, SLS mengkueri data dari 15 menit terakhir. Jika tidak ada data yang muncul di SLS, gunakan Webshell untuk memeriksa apakah aplikasi Anda telah menghasilkan file log. Untuk detailnya, lihat Use Webshell to diagnose an application.

      • Jika data log ada, bergabunglah dengan grup DingTalk (ID grup: 32874633) dan hubungi ahli teknis produk untuk bantuan.

      • Jika tidak ada data log, periksa konfigurasi aplikasi Anda.