Konfigurasi logging untuk mengirim log fungsi ke Simple Log Service - Function Compute

Function Compute terintegrasi dengan Simple Log Service. Setelah Anda mengonfigurasi logging untuk suatu fungsi, Function Compute secara otomatis mengumpulkan dan mengirimkan log ke Logstore yang ditentukan. Anda dapat melihat log permintaan tunggal, log instans, atau log fungsi di Konsol Function Compute, serta menggunakan fitur analisis log di Konsol Simple Log Service untuk menjalankan kueri kustom.

Informasi latar belakang

Simple Log Service adalah layanan data log terpadu dari Alibaba Cloud. Untuk menyimpan log fungsi menggunakan Simple Log Service, konfigurasikan sebuah Project dan Logstore dalam layanan yang berisi fungsi tersebut. Anda juga harus memberikan izin kepada Function Compute untuk mengakses Simple Log Service. Log fungsi dikirim ke Logstore yang dikonfigurasi, dan semua log fungsi dari layanan yang sama dalam Wilayah yang sama dikirim ke Logstore yang sama.

Penagihan

Function Compute tidak membebankan biaya tambahan untuk fitur logging. Simple Log Service membebankan biaya untuk pengiriman log. Untuk informasi selengkapnya, lihat Ikhtisar penagihan.

Konfigurasikan fitur logging

Konfigurasikan log di Konsol Function Compute

Prasyarat

Function Compute
- Buat layanan
Opsi: Simple Log Service (SLS)
- Buat Project dan Logstore

Prosedur

Login ke Konsol Function Compute. Di panel navigasi sebelah kiri, klik Services & Functions.
Di bilah navigasi atas, pilih Wilayah. Pada halaman Services, temukan layanan yang diinginkan dan klik Configure di kolom Actions.

Di bagian Log Config pada pengaturan layanan, atur parameter berikut dan klik Save.

Catatan

Jika Anda mengaktifkan fitur logging saat membuat layanan, Konsol Function Compute secara otomatis membuat Project yang dimulai dengan aliyun-fc-cn-<region_id> dan Logstore default di dalam Project tersebut. Hanya satu Project semacam ini yang dibuat per Wilayah. Jika sistem menemukan bahwa Project telah dibuat secara otomatis di Wilayah tersebut sebelumnya, sistem akan menggunakan Project tersebut.
Jika Anda tidak mengaktifkan fitur logging saat membuat layanan, Anda harus memilih Project dan Logstore kustom secara manual saat memperbarui layanan.
Konsol secara otomatis mengaktifkan Log Segmentation Rule, Request-level Metrics, dan Instance-level Metrics. Konsol juga membuat semua indeks yang diperlukan untuk melakukan kueri log.

Parameter	Wajib	Deskripsi
Logging Feature	Ya	Menentukan apakah akan mengaktifkan Simple Log Service. Nilai yang valid: Enable: Setelah fitur ini diaktifkan, Function Compute mengimpor log ke Project Anda. Anda dapat melakukan kueri dan mengambil log di Konsol Function Compute dan Konsol Simple Log Service untuk melacak dan menemukan masalah. Catatan Saat Anda mengaktifkan fitur logging, Anda harus memilih role yang memiliki izin untuk mengakses Simple Log Service di bagian Role. Untuk informasi selengkapnya tentang service role, lihat Berikan izin Function Compute untuk mengakses layanan Alibaba Cloud lainnya. Disable: Jika fitur ini dinonaktifkan, log fungsi tidak disimpan untuk Persistensi, dan Anda tidak dapat melacak atau menemukan masalah.
Configuration Method	Ya	Pilih Automatic Configuration atau Custom Configuration. Jika Anda memilih Custom Configuration, Project dan Logstore wajib diisi.
Log Project	Ya	Project tujuan untuk menyimpan log pemanggilan fungsi.
Logstore	Ya	Logstore tujuan untuk menyimpan log pemanggilan fungsi.
Log Segmentation Rule	Tidak	Menentukan apakah akan mengaktifkan aturan segmentasi log. Nilai yang valid: Enable: Setelah fitur ini diaktifkan, Function Compute membagi log berdasarkan aturan segmentasi menjadi beberapa segmen log dan menuliskannya ke Simple Log Service satu per satu. Aturan segmentasi default adalah `^.{0,2}\d{4}-\d{2}-\d{2}`. Aturan ini mencocokkan tanggal dalam format `xxxx-xx-xx`, di mana `x` merepresentasikan angka. Aturan ini membagi log berdasarkan apakah suatu baris dimulai dengan tanggal. Misalnya, jika baris log dimulai dengan 2023-10-10, baris tersebut dianggap sebagai baris pertama dari entri log. Baris ini dan baris-baris berikutnya yang tidak dimulai dengan tanggal ditulis ke Simple Log Service sebagai satu log. Disable: Jika fitur ini dinonaktifkan, log dibagi menggunakan `\n` secara default.
Request-level Metrics	Tidak	Menentukan apakah akan mengimpor log untuk metrik permintaan ke Logstore. Kami sangat menyarankan agar Anda mengaktifkan fitur ini. Nilai yang valid: Enable: Setelah fitur ini diaktifkan, metrik untuk setiap pemanggilan fungsi dikirimkan ke Logstore yang Anda pilih. Metrik ini mencakup waktu eksekusi fungsi, Penggunaan memori, error eksekusi, cold start, dan waktu yang dibutuhkan untuk setiap langkah cold start. Function Compute menampilkan daftar permintaan berdasarkan metrik ini di log pemanggilan. Anda juga dapat menggunakan metrik ini untuk memfilter permintaan, seperti memfilter semua permintaan error atau permintaan yang melibat cold start. Disable: Anda tidak dapat melihat informasi detail eksekusi permintaan.
Instance-level Metrics	Tidak	Menentukan apakah akan mengaktifkan metrik tingkat instans. Nilai yang valid: Enable: Setelah fitur ini diaktifkan, data metrik untuk instans fungsi dikirimkan ke Logstore yang Anda pilih. Anda dapat melihat metrik performa pada dimensi instans, seperti metrik CPU, memori, dan I/O jaringan. Function Compute menyediakan observabilitas tingkat instans berdasarkan data metrik tingkat instans, menawarkan jalur pemantauan dan troubleshooting end-to-end untuk instans fungsi. Untuk informasi selengkapnya, lihat Instance-level metrics. Disable: Anda tidak dapat melihat informasi detail metrik instans.

Konfigurasikan log menggunakan Serverless Devs

Prasyarat

Prosedur

Buat folder kode. Struktur foldernya sebagai berikut.

.
├── code
│   └── index.js
└── s.yaml

Berikut ini contoh file s.yaml.

Dalam contoh ini, field logConfig mengonfigurasi fitur logging. Ubah nilai logstore dan project menjadi Logstore dan Project yang sudah ada di akun Anda. Anda juga dapat mengatur logConfig ke auto. Jika demikian, Function Compute secara otomatis membuat Logstore dan Project untuk Anda.

edition: 1.0.0
name: hello-world-app
access: "default"

vars: 
  region: "cn-hangzhou"
  service:
    name: "hello-world-service"
    description: 'hello world by serverless devs'
    logConfig: # Ubah project dan logstore menjadi yang sesuai di akun Anda. Anda juga dapat menggunakan logConfig:auto untuk membuat project dan logstore secara otomatis.
      project: 'your-project'
      logstore: 'your-logstore'
      enableRequestMetrics: true
      enableInstanceMetrics: true
    role: 'acs:ram::<accountID>:role/aliyunfcdefaultrole'

services:
  helloworld:
    component: fc 
    props:
      region: ${vars.region} 
      service: ${vars.service}
      function:
        name: "hello-world"
        description: 'hello world by serverless devs'
        runtime: nodejs14
        codeUri: ./code
        handler: index.handler
        memorySize: 128
        timeout: 60

Jalankan perintah berikut untuk mendeploy aplikasi.
```
sudo s deploy -y
```
Setelah perintah berhasil dijalankan, Anda dapat login ke Konsol Function Compute untuk melihat fungsi yang telah dideploy dan memastikan bahwa fitur logging telah diaktifkan.

Lihat log pemanggilan

Di halaman detail fungsi, klik Invocation Logs untuk melakukan kueri catatan pemanggilan fungsi saat ini.

Catatan

Anda dapat beralih antar versi atau alias di bagian atas halaman untuk melakukan kueri log untuk versi atau alias fungsi tertentu.

Anda dapat melihat log pemanggilan fungsi di tab Invocation Request List atau tab Keyword Search. Perbedaannya sebagai berikut:

Invocation Request List
Daftar ini menampilkan informasi seperti waktu pemanggilan fungsi, ID permintaan, hasil pemanggilan, ID instans, serta versi dan alias fungsi. Gambar berikut menunjukkan contohnya:
- Klik Request ID untuk melihat detail permintaan dan detail log.
- Klik Instance ID untuk melihat penggunaan metrik instans, seperti penggunaan CPU, penggunaan memori, dan network traffic.
- Di kolom Actions, klik View Log untuk melihat detail log, atau klik Advanced Log untuk membuka Konsol Simple Log Service guna melakukan kueri dan analisis log.
Keyword Search
Daftar ini menampilkan informasi seperti waktu pemanggilan fungsi, konten log, serta versi dan alias fungsi. Gambar berikut menunjukkan contohnya. Di kolom Actions, klik Log Context untuk menemukan beberapa log konteks untuk entri log ini, atau klik Logstore untuk membuka Konsol Simple Log Service guna melakukan kueri dan analisis log.
Anda dapat memasukkan kata kunci di kotak pencarian untuk melakukan kueri informasi log yang Anda butuhkan. Misalnya, untuk mencari log yang berisi teks hello world, masukkan kata kunci hello world di kotak pencarian. Hasil pencarian akan menampilkan semua baris log yang berisi kata kunci ini, seperti yang ditunjukkan pada gambar berikut. Untuk informasi selengkapnya tentang sintaks kueri, lihat Sintaks kueri.

Referensi

Anda juga dapat mengonfigurasi logging untuk fungsi dengan memanggil kit pengembangan perangkat lunak (SDK) atau API. Untuk informasi selengkapnya, lihat CreateService dan LogConfig.