Aktifkan monitoring aplikasi Python di SAE dengan agen ARMS - Serverless App Engine

Setelah menginstal ARMS agen secara manual untuk aplikasi Python dan menerapkan aplikasi ke SAE, Anda dapat menggunakan ARMS untuk memantau aplikasi. Dengan ARMS, Anda dapat melihat berbagai data pemantauan seperti topologi aplikasi, analisis jejak panggilan, dan analisis kinerja SQL. Topik ini menjelaskan cara menginstal ARMS agen untuk aplikasi Python dan menerapkannya ke SAE.

Prasyarat

Pastikan lingkungan build Anda dapat terhubung ke internet atau jaringan internal Alibaba Cloud. Grup keamanan dari lingkungan build harus mengizinkan lalu lintas TCP keluar pada port 80 dan 443.
Periksa versi Python dan framework yang digunakan. Untuk informasi lebih lanjut, lihat Komponen dan framework Python yang didukung oleh Pemantauan Aplikasi ARMS.
Aktifkan Layanan Pemantauan Aplikasi Waktu Nyata.
Jika ingin menerapkan proyek Python ke SAE dari citra, aktifkan Container Registry dan kemudian buat Instans Perusahaan atau buat Instans Pribadi.

Peringatan

Jika aplikasi dimulai dengan uvicorn, pilih salah satu metode konfigurasi berikut:
- Metode 1: Tambahkan pernyataan berikut ke baris pertama file entri uvicorn untuk mengimpor agen Python.
```
from aliyun.opentelemetry.instrumentation.auto_instrumentation import sitecustomize
```
- Metode 2: Ganti uvicorn dengan gunicorn dan tambahkan awalan aliyun-instrument ke perintah gunicorn.
  Contohnya:
```
uvicorn app:app --workers 4 --port=9090 --host 0.0.0.0
```
  Ganti menjadi:
```
aliyun-instrument gunicorn -w 4 -k uvicorn.workers.UvicornWorker -b 0.0.0.0:8000 app:app
```
  Catatan
  Perintah aliyun-instrument menangani inisialisasi dan instrumen otomatis dari agen Python ARMS.
Jika aplikasi dimulai dengan uWSGI, lihat Hubungkan ke agen Python saat memulai proyek Django atau Flask dengan uWSGI.
Jika menggunakan korutin gevent, tetapkan variabel lingkungan GEVENT_ENABLE=true.
Sebagai contoh, jika program Anda berisi kode berikut:
```
from gevent import monkey
monkey.patch_all()
```
Tetapkan variabel lingkungan sebagai berikut:
```
GEVENT_ENABLE=true
```

Prosedur

Persiapkan proyek: Gunakan proyek demo sebagai contoh.
Buat citra Docker untuk proyek Python atau kemas proyek ke dalam file ZIP: Jika menerapkan aplikasi dari citra, unduh dan instal agen Python saat membuat citra. Jika menerapkan aplikasi dari paket kode, sistem akan mengunduh dan menginstal agen Python secara otomatis selama penyebaran. Anda hanya perlu memulai aplikasi menggunakan agen Python ARMS.
Terapkan aplikasi Python: Terapkan aplikasi Python di Konsol SAE dan aktifkan pemantauan aplikasi. Jika menerapkan aplikasi dari paket kode, tetapkan perintah startup untuk memulai aplikasi menggunakan agen Python ARMS.
Lihat data pemantauan aplikasi: Lihat berbagai data pemantauan yang dihasilkan oleh aplikasi.

1. Persiapkan proyek

Unggah proyek ke lingkungan Anda.
Instal lingkungan yang diperlukan untuk menjalankan dan menguji proyek. Untuk informasi lebih lanjut, lihat Menginstal paket.
Uji proyek secara lokal untuk memastikan bahwa ia berjalan sesuai harapan.

2. Buat citra Docker atau kemas proyek Python ke dalam file ZIP

Buat citra Docker dan dorong ke repositori citra

Buat citra Python.

Topik ini hanya menjelaskan perintah untuk mengunduh dan menginstal agen, serta memulai aplikasi menggunakan agen Python ARMS.

...
# Unduh penginstal agen dari repositori PyPI.
RUN pip3 install aliyun-bootstrap

# Gunakan aliyun-bootstrap untuk menginstal agen Python.
RUN aliyun-bootstrap -a install

...

# Mulai aplikasi menggunakan agen Python ARMS.
CMD ["aliyun-instrument","python","main.py"]

Catatan

Jika tidak perlu memulai aplikasi menggunakan agen Python, impor agen Python di file entri utama aplikasi, seperti main.py, dan mulai aplikasi.

from aliyun.opentelemetry.instrumentation.auto_instrumentation import  sitecustomize

Dorong citra Python yang dibuat ke repositori citra Alibaba Cloud. Untuk informasi lebih lanjut, lihat Dorong dan tarik citra (Edisi Perusahaan) atau Dorong dan tarik citra (Edisi Pribadi).

Kemas proyek Python ke dalam file ZIP

Kemas proyek Python ke dalam file ZIP di lingkungan lokal Anda. Untuk informasi lebih lanjut, lihat Petunjuk untuk mengemas proyek Python ke dalam file ZIP.

3. Buat aplikasi Python

Buat aplikasi Python dari citra

3.1 Buat aplikasi

Topik ini hanya menjelaskan langkah-langkah utama. Untuk informasi lebih lanjut, lihat Terapkan aplikasi dari citra.

Di panel Configure Image, atur Technology Stack ke Python dan pilih versi citra.
Di halaman Advanced Settings, di bagian Application Monitoring, aktifkan Application Monitoring.
Klik Create Application.

3.2 Uji akses

Uji menggunakan titik akhir publik

Tambahkan titik akhir publik untuk aplikasi. Untuk informasi lebih lanjut, lihat Ikat instans CLB ke aplikasi dan hasilkan titik akhir publik atau internal.
Salin titik akhir publik dan tempelkan ke browser untuk menguji akses.

Uji di Webshell

Pergi ke halaman Basic Information aplikasi dan klik tab Instance List.
Di kolom Actions instans, klik Webshell.
Di halaman Webshell, masukkan curl 127.0.0.1:ContainerPort untuk menguji.

Buat aplikasi Python dari paket kode

3.1 Buat aplikasi

Topik ini hanya menjelaskan langkah-langkah utama. Untuk informasi lebih lanjut, lihat Terapkan aplikasi Python.

Di panel Configure Code Package Deployment, atur Technology Stack ke Python. Kemudian, di bagian Upload ZIP Package, klik ikon untuk mengunggah paket ZIP Anda.
Di halaman Advanced Settings, konfigurasikan pengaturan berikut:
1. Di bagian Startup Command, tetapkan perintah startup.
```
aliyun-instrument python main.py
# Mulai aplikasi menggunakan agen Python ARMS. main.py adalah nama file entri utama dalam contoh ini.
```
2. Di bagian Application Monitoring, aktifkan Application Monitoring.
Klik Create Application.

3.2 Uji akses

Uji menggunakan titik akhir publik

Tambahkan titik akhir publik untuk aplikasi. Untuk informasi lebih lanjut, lihat Ikat instans CLB ke aplikasi dan hasilkan titik akhir publik atau internal.
Salin titik akhir publik dan tempelkan ke browser untuk menguji akses.

Uji di Webshell

Pergi ke halaman Basic Information aplikasi dan klik tab Instance List.
Di kolom Actions instans, klik Webshell.
Di halaman Webshell, masukkan curl 127.0.0.1:ContainerPort untuk menguji.

4. Lihat data pemantauan aplikasi

Lihat di Konsol SAE

Buka halaman Basic Information untuk aplikasi. Di panel navigasi kiri, klik Application Monitoring. Di halaman Application Monitoring, lihat Monitoring Data.

Y3kM5Riwrv

Lihat di Konsol ARMS

Masuk ke Konsol ARMS.
Di panel navigasi kiri, pilih Application Monitoring > Applications. Di bilah navigasi atas, pilih wilayah tujuan.
Di halaman Applications, cari aplikasi Anda dan klik namanya.
Di halaman detail pemantauan, lihat data pemantauan.