Function Compute:Gunakan Loggie dalam runtime kustom

Prasyarat

Sebelum memulai, pastikan Anda telah memiliki:

• Layanan Function Compute

• Proyek Simple Log Service dan Logstore

Penagihan

Menyetel variabel lingkungan FC_EXTENSION_SLS_LOGGIE=true akan membekukan instans selama 10 detik setelah setiap pemanggilan agar Loggie dapat menyelesaikan pengunggahan log. Periode pembekuan ini ditagih berdasarkan aturan yang sama seperti panggilan balik Prefreeze. Untuk detailnya, lihat Aturan penagihan.

Langkah 1: Buat fungsi dalam runtime kustom

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

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

3. Pada halaman Functions, klik Create Function.

4. Pada halaman Create Function, atur parameter berikut. Gunakan nilai default untuk parameter lainnya, lalu klik Create. Untuk informasi lebih lanjut, lihat Buat fungsi. Contoh app.py:

   Catatan Ganti filename='/tmp/log/fc-flask.log' dengan jalur file log aktual Anda. Jalur ini harus sesuai dengan nilai sources.paths dalam konfigurasi pipeline yang dibuat pada Langkah 2.

   Parameter	Nilai
   Creation method	Use Custom Runtime
   Function Name (di bawah Basic Settings)	Masukkan nama fungsi
   Handler Type (di bawah Basic Settings)	Event Handler
   Runtime	Python 3.9
   Code Upload Method	Use Folder. Nama folder adalah code, dan file di dalamnya adalah app.py. Lihat contoh kode di bawah.
   Startup Command	/code/bootstrap (dibuat pada Langkah 2)
   Listening Port	9000

      from flask import Flask
      from flask import request
      import logging
      import os
   
      REQUEST_ID_HEADER = 'x-fc-request-id'
   
      app = Flask(__name__)
   
      format_str = '[%(asctime)s] %(levelname)s in %(module)s: %(message)s'
      logging.basicConfig(filename='/tmp/log/fc-flask.log', filemode='w',
          format=format_str, encoding='utf-8', level=logging.DEBUG)
      @app.route("/invoke", methods = ["POST"])
      def hello_world():
          rid = request.headers.get(REQUEST_ID_HEADER)
          logger = logging.getLogger()
   
          print("FC Invoke Start RequestId: " + rid)
          logger.info("FC Invoke Start RequestId: " + rid)
   
          data = request.stream.read()
          print(str(data))
          logger.info("receive event: {}".format(str(data)))
   
          print("FC Invoke End RequestId: " + rid)
          logger.info("FC Invoke Start RequestId: " + rid)
          return "Hello, World!"
   
      if __name__ == '__main__':
          app.run(host='0.0.0.0',port=9000)

Langkah 2: Buat file bootstrap

Setelah membuat fungsi, gunakan WebIDE pada tab Code untuk membuat file bootstrap di direktori CODE.

Tambahkan konten berikut ke file bootstrap:

#!/bin/bash

#1. Buat file pipelines.yml.
mkdir -p /tmp/log /code/etc
cat << EOF > /code/etc/pipelines.yml
pipelines:
  - name: demo
    sources:
      - type: file
        name: fc-demo
        addonMeta: true
        fields:
          topic: "loggie"
        fieldsUnderRoot: true
        paths:
          - "/tmp/log/*.log"
    sink:
      type: sls
      endpoint: ${LOGGIE_SINK_SLS_ENDPOINT}
      accessKeyId: ${LOGGIE_SINK_SLS_ACCESS_ID}
      accessKeySecret: ${LOGGIE_SINK_SLS_ACCESS_SECRET}
      project: ${LOGGIE_SINK_SLS_PROJECT}
      logstore: ${LOGGIE_SINK_SLS_LOGSTORE}
      topic: ${LOGGIE_SINK_SLS_TOPIC}
EOF

#2. Buat file loggie.yml.
cat << EOF > /code/etc/loggie.yml
EOF

#3. Jalankan Loggie sebagai proses latar belakang.
/opt/bin/loggie -config.system=/code/etc/loggie.yml -config.pipeline=/code/etc/pipelines.yml > /tmp/loggie.log 2>&1 &

#4. Jalankan aplikasi.
exec python app.py

Skrip ini melakukan hal-hal berikut:

1. Membuat pipelines.yml — file konfigurasi pipeline.

   Bagian	Deskripsi
   sources	Menentukan tipe log dan jalurnya. Contoh ini mengumpulkan semua file .log dari direktori /tmp/log/.
   sink	Menentukan tujuan SLS. Variabel-variabel ini diatur pada Langkah 4.

2. Membuat loggie.yml — file konfigurasi sistem Loggie. File kosong menggunakan konfigurasi default. File ini harus ada meskipun dibiarkan kosong. Untuk konfigurasi non-default, lihat Dokumentasi referensi Loggie.

3. Menjalankan Loggie sebagai proses latar belakang. Log runtime Loggie ditulis ke /tmp/loggie.log.

4. Menjalankan aplikasi. Contoh ini menggunakan Python. Ganti perintah tersebut dengan bahasa yang digunakan oleh fungsi Anda.

Setelah menambahkan konten file, berikan izin eksekusi pada file bootstrap. Di WebIDE, pilih Terminal > New Terminal, lalu jalankan:

chmod 777 bootstrap

Langkah 3: Tambahkan layer umum resmi Loggie

1. Klik tab Configurations. Di bagian Layers, klik Modify.

2. Di panel, pilih Add Layer > Add Official Common Layer dan konfigurasikan layer Loggie.

   Nama layer	Runtime yang kompatibel	Versi layer	ARN
   Loggie Agent	Custom runtime	1 (digunakan dalam contoh ini)	acs:fc:{region}:official:layers/Loggie13x/versions/1

3. Klik OK.

Langkah 4: Atur variabel lingkungan

1. Pada tab Configurations, buka bagian Environment Variables dan klik Modify.

2. Tambahkan variabel lingkungan berikut. Untuk informasi lebih lanjut, lihat Variabel lingkungan. FC_EXTENSION_SLS_LOGGIE=true — Mengaktifkan pembekuan selama 10 detik setelah pemanggilan agar Loggie dapat menyelesaikan pengunggahan log. Lihat Penagihan untuk detail biaya. Enam variabel sink SLS yang dirujuk dalam pipelines.yml:

   Variabel	Deskripsi
   LOGGIE_SINK_SLS_ENDPOINT	Titik akhir SLS untuk wilayah Anda
   LOGGIE_SINK_SLS_ACCESS_ID	ID AccessKey
   LOGGIE_SINK_SLS_ACCESS_SECRET	Rahasia AccessKey
   LOGGIE_SINK_SLS_PROJECT	Nama proyek SLS
   LOGGIE_SINK_SLS_LOGSTORE	Nama Logstore SLS
   LOGGIE_SINK_SLS_TOPIC	Topik log

3. Klik OK. Setelah konfigurasi disimpan, Loggie mulai meneruskan log fungsi ke SLS.

Langkah 5: Verifikasi hasil

1. Pada tab Code, klik Test Function. Pengiriman log pada pemanggilan pertama mungkin tertunda. Panggil fungsi beberapa kali agar Loggie dapat diinisialisasi dan mengosongkan log.

2. Masuk ke Konsol Layanan Log. Kueri log berdasarkan wilayah, proyek, dan Logstore yang Anda konfigurasikan dalam pipelines.yml. Dalam hasil kueri, cari bidang-bidang berikut:

   Bidang	Deskripsi
   body	Konten log yang ditulis oleh fungsi Anda
   state.*	Metadata tentang status pengumpulan log. Bidang hostname di bawah state berisi ID instans tempat fungsi dijalankan.

Pemecahan Masalah

Loggie berjalan secara independen di dalam instans fungsi. Function Compute tidak memantau kesehatan Loggie, dan kegagalan Loggie tidak memengaruhi eksekusi fungsi. Kueri log di SLS mungkin mengalami latensi beberapa detik.

Jika log tidak muncul di SLS, gunakan langkah-langkah berikut untuk mendiagnosis masalah.

Referensi

• Dokumentasi Loggie

• Untuk mentransformasi log sebelum diunggah—misalnya, mengurai log JSON atau menyaring entri DEBUG—tambahkan konfigurasi interceptor ke pipelines.yml. Untuk detailnya, lihat Referensi interceptor Loggie.