Komponen dan framework Python yang didukung oleh ARMS Application Monitoring - Cloud Monitor

Topik ini mencantumkan versi Python, komponen pihak ketiga, dan framework yang didukung oleh agen Python untuk Layanan Pemantauan Aplikasi Waktu Nyata (ARMS).

Versi Python yang Didukung

Python 3.8 dan yang lebih baru.

Versi Protobuf yang Didukung

Agen Python menggunakan protobuf untuk mengkodekan data pelaporan, yang dapat menyebabkan konflik dengan versi protobuf yang digunakan aplikasi Anda. Agen Python kompatibel dengan versi protobuf berikut:

"protobuf>=3.20.0, < 6.0"

Versi API OpenTelemetry yang Didukung

Agen Python diimplementasikan berdasarkan spesifikasi API OpenTelemetry. Versi API OpenTelemetry yang berbeda mungkin mencakup perubahan kecil. Agen Python mendukung versi API OpenTelemetry berikut:

"opentelemetry-api <= 1.35.0"

Catatan

Jika aplikasi Anda dimulai dengan uvicorn, gunakan 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 pada 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, atur variabel lingkungan GEVENT_ENABLE=true.
Sebagai contoh, jika program Anda berisi kode berikut:
```
from gevent import monkey
monkey.patch_all()
```
Atur variabel lingkungan sebagai berikut:
```
GEVENT_ENABLE=true
```

Versi plugin yang didukung

Aplikasi LLM (model bahasa besar)

Komponen	Alamat repositori PyPI	Versi minimum	Versi maksimum
OpenAI	https://pypi.org/project/openai/	v1.0.0	v1.109.1
Dashscope	https://pypi.org/project/dashscope/	v1.0.0	v1.2.1
Llama-index	https://pypi.org/project/llama-index/	v0.10.5	v0.10.43
Langchain	https://pypi.org/project/langchain/	v0.1.0	v0.3.27
Dify	https://github.com/langgenius/dify	v0.12.8	v1.4.3
MCP	https://pypi.org/project/mcp/	v1.3.0	v1.12.4
Google ADK	https://pypi.org/project/google-adk/	v1.2.1	Tidak ada batasan

Layanan LLM (model bahasa besar)

Komponen	Alamat repositori PyPI	Versi minimum	Versi maksimum
vLLM V0	https://pypi.org/project/vllm/	v0.5.0	v0.8.4
vLLM V1	https://pypi.org/project/vllm/	V0.8.2	V0.8.4
SGLang	https://pypi.org/project/sglang/	v0.4.6	v0.4.9.post6

Framework HTTP/RPC

Komponen	Alamat repositori PyPI	Versi minimum	Versi maksimum
FastAPI	https://pypi.org/project/fastapi/	v0.58	Tidak ada batasan
asgiref	https://pypi.org/project/asgiref/	v3.0	Tidak ada batasan
aiohttp	https://pypi.org/project/aiohttp/	v3.0	Tidak ada batasan
Django	https://pypi.org/project/Django/	v1.10	Tidak ada batasan
WSGI	Tidak ada	Tidak ada batasan	Tidak ada batasan
Flask	https://pypi.org/project/Flask/	v1.0	Tidak ada batasan
Requests	https://pypi.org/project/requests/	v2.0	Tidak ada batasan
gRPC	https://pypi.org/project/grpcio/	v1.42.0	Tidak ada batasan
Jinja2	https://pypi.org/project/jinja2/	v2.7	< 4.0
Click	https://pypi.org/project/click/	v8.1.3	< 9.0.0

Framework database

Komponen	Alamat repositori PyPI	Versi minimum	Versi maksimum
SQLAlchemy	https://pypi.org/project/sqlalchemy/	v1.0.0	< 2.1.0
AsyncPG	https://pypi.org/project/asyncpg/	v0.12.0	Tidak ada batasan
aiopg	https://pypi.org/project/aiopg/	v0.13.0	< 2.0.0
PyMySQL	https://pypi.org/project/pymysql/	Tidak ada persyaratan versi khusus	< 2
PyMSSQL	https://pypi.org/project/pymssql/	v2.1.5	< 3
psycopg	https://pypi.org/project/psycopg/	v3.1.0	Tidak ada batasan
psycopg2	https://pypi.org/project/psycopg2/	v2.7.3.1	Tidak ada batasan
MySQL	https://pypi.org/project/mysql-connector-python/	v8.0	< 10.0
MySQLClient	https://pypi.org/project/mysqlclient/	Tidak ada persyaratan versi khusus	< 3
PyMongo	https://pypi.org/project/pymongo/	v3.1	< 5.0
TortoiseORM	https://pypi.org/project/tortoise-orm/	v0.17.0	Tidak ada batasan
Pydantic	https://pypi.org/project/pydantic/	v1.10.2	Tidak ada batasan
DBAPI	Tidak ada dependensi spesifik	Tidak ada persyaratan versi khusus	Tidak ada batasan
SQLite3	Tidak ada dependensi spesifik	Tidak ada persyaratan versi khusus	Tidak ada batasan

Plugin cache

Komponen	Alamat repositori PyPI	Versi minimum	Versi maksimum
Redis	https://pypi.org/project/redis/	v2.6	Tidak ada batasan
PyMemcache	https://pypi.org/project/pymemcache/	v1.3.5	< 5
Elasticsearch	https://pypi.org/project/elasticsearch/	v6.0	Tidak ada batasan
Cassandra	https://pypi.org/project/cassandra-driver/	v3.25	Tidak ada batasan
Scylla	https://pypi.org/project/scylla-driver/	v3.25	Tidak ada batasan

Plugin antrian pesan

Komponen	Alamat repositori PyPI	Versi minimum	Versi maksimum
Confluent Kafka	https://pypi.org/project/confluent-kafka/	v1.8.2	v2.7.0
Kafka Python	https://pypi.org/project/kafka-python/	Tidak ada persyaratan versi khusus	Tidak ada batasan
aiokafka	https://pypi.org/project/aiokafka/	Tidak ada persyaratan versi khusus	Tidak ada batasan
Pika	https://pypi.org/project/pika/	Tidak ada persyaratan versi khusus	Tidak ada batasan
aio-pika	https://pypi.org/project/aio-pika/	Tidak ada persyaratan versi khusus	Tidak ada batasan
Celery	https://pypi.org/project/celery/	v4.0	< 6.0
Remoulade	https://pypi.org/project/remoulade/	v0.50	Tidak ada batasan

Plugin lainnya

Komponen	Alamat repositori PyPI	Versi minimum	Versi maksimum
Threading	Tidak ada dependensi spesifik	Tidak ada persyaratan versi khusus	Tidak ada batasan
Logging	Tidak ada dependensi spesifik	Tidak ada persyaratan versi khusus	Tidak ada batasan
asyncio	Tidak ada dependensi spesifik	Tidak ada persyaratan versi khusus	Tidak ada batasan