Instalasi manual agen ARMS untuk Python - Application Real-Time Monitoring Service

Setelah menginstal agen Application Real-Time Monitoring Service (ARMS) untuk aplikasi Python, ARMS akan mulai memantau aplikasi tersebut. Anda kemudian dapat melihat data pemantauan aplikasi, seperti topologi, jejak, dan analisis SQL. Topik ini menjelaskan cara menginstal agen ARMS secara manual untuk aplikasi Python.

Catatan

Untuk aplikasi yang diterapkan di kluster Container Service for Kubernetes (ACK), kami menyarankan Anda menginstal komponen ack-onepilot daripada menginstal agen ARMS secara manual. Untuk informasi selengkapnya, lihat Instal agen Python untuk Container Service for Kubernetes (ACK) dan Container Compute Service (ACS) menggunakan komponen ack-onepilot.
Jika Anda memiliki pertanyaan saat menggunakan agen ARMS untuk Python, pertama-tama merujuk ke dokumentasi kami. Jika pertanyaan Anda belum terjawab, bergabunglah dengan grup obrolan DingTalk (ID: 159215000379) untuk mendapatkan dukungan teknis.

Sebelum memulai

Pastikan lingkungan tempat aplikasi berada terhubung ke Alibaba Cloud melalui Internet atau jaringan internal, serta grup keamanan lingkungan tersebut mengizinkan lalu lintas keluar pada port TCP 80 dan 443.
Periksa versi Python dan framework yang digunakan. Untuk informasi selengkapnya, lihat Komponen dan framework Python yang didukung oleh Pemantauan Aplikasi ARMS.

Catatan

Jika aplikasi Anda dimulai dengan uvicorn, pilih salah satu metode konfigurasi berikut.
- Metode 1: Tambahkan pernyataan berikut pada 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.
  Contoh:
```
uvicorn app:app --workers 4 --port=9090 --host 0.0.0.0
```
  Ubah perintah menjadi:
```
aliyun-instrument gunicorn -w 4 -k uvicorn.workers.UvicornWorker -b 0.0.0.0:8000 app:app
```
  Catatan
  Instruksi aliyun-instrument menangani inisialisasi dan instrumentasi non-intrusif dari agen Python ARMS.
Jika aplikasi Anda dimulai dengan uWSGI, lihat Instal agen Python untuk proyek Django atau Flask yang dimulai dengan uWSGI.
Jika Anda menggunakan korutin gevent, Anda harus mengatur variabel lingkungan GEVENT_ENABLE=true.
Sebagai contoh, jika program Anda berisi kode berikut:
```
from gevent import monkey
monkey.patch_all()
```
Anda harus mengatur variabel lingkungan sebagai berikut:
```
GEVENT_ENABLE=true
```

Langkah 1: Unduh aliyun-bootstrap

Unduh installer agen, aliyun-bootstrap, dari repositori Python Package Index (PyPI).

pip3 install aliyun-bootstrap

Langkah 2: Konfigurasi variabel lingkungan

Tambahkan secara manual variabel lingkungan berikut ke aplikasi Python:

Untuk semua proses dalam shell

export ARMS_APP_NAME=xxx   # Nama aplikasi.
export ARMS_REGION_ID=xxx   # ID wilayah.
export ARMS_LICENSE_KEY=xxx   # Kunci lisensi.

Untuk satu proses saja

ARMS_APP_NAME=xxx ARMS_REGION_ID=xxx ARMS_LICENSE_KEY=xxx aliyun-instrument xxx.py

Anda dapat memperoleh kunci lisensi dengan memanggil operasi API. Untuk informasi selengkapnya, lihat DescribeTraceLicenseKey.

(Opsional) Contoh Dockerfile

Untuk lingkungan Docker, Anda dapat merujuk pada contoh Dockerfile berikut untuk menginstal agen ARMS.

# Tambahkan variabel lingkungan.
ENV ARMS_APP_NAME={AppName}
ENV ARMS_REGION_ID={regionId}
ENV ARMS_LICENSE_KEY={licenseKey}

## Lingkungan asli

Langkah 3: Gunakan aliyun-bootstrap untuk menginstal agen ARMS

Jalankan perintah berikut untuk mengonfigurasi repositori image. Langkah ini disarankan agar instalasi lebih mudah.

pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/ && pip config set install.trusted-host mirrors.aliyun.com

Instal agen ARMS untuk Python.
```
aliyun-bootstrap -a install
```
Catatan
Untuk menginstal versi tertentu dari agen Python, jalankan perintah berikut:
```
# Ganti ${version} dengan nomor versi sebenarnya.
aliyun-bootstrap -a install -v ${version}
```
Untuk informasi tentang versi agen Python yang telah dirilis, lihat Panduan versi agen Python.

Langkah 4: Mulai aplikasi

Untuk memulai aplikasi menggunakan agen ARMS untuk Python, jalankan perintah berikut:

aliyun-instrument python app.py

Verifikasi hasil

Setelah sekitar satu menit, masuk ke Konsol ARMS. Di panel navigasi sebelah kiri, pilih Application Monitoring > Application List. Jika aplikasi ditampilkan di halaman Application List, berarti aplikasi sedang dipantau.

2024-09-23_17-45-22