Komponen dan framework Python yang didukung oleh Pemantauan Aplikasi ARMS - Application Real-Time Monitoring Service

Topik ini mencantumkan versi Python, komponen pihak ketiga, dan framework yang didukung oleh agen Python.

Versi Python yang didukung

Persyaratan versi Python: 3.8 ≤ Python ≤ 3.13

Versi Protobuf yang didukung

Agen Python menggunakan Protobuf untuk meng-encode data selama pelaporan, yang mungkin bertentangan dengan versi Protobuf yang digunakan oleh aplikasi Anda. Agen Python saat ini mendukung rentang versi Protobuf berikut:

"protobuf>=3.20.0, < 6.0"

Versi OpenTelemetry API yang didukung

Agen Python mengikuti spesifikasi OpenTelemetry API. Namun, versi OpenTelemetry API yang berbeda mungkin memiliki sedikit perbedaan. Agen Python saat ini mendukung rentang versi OpenTelemetry API berikut:

"opentelemetry-api <= 1.39.0"

Catatan

Jika aplikasi Anda dijalankan 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 dijalankan dengan uWSGI, lihat Instal agen Python untuk proyek Django atau Flask yang dijalankan 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
```

Kerangka kerja database

Versi plugin yang didukung

Aplikasi LLM (large language model)

Component	PyPI/GitHub repository URL	Minimum version	Later versions
AgentScope	https://pypi.org/project/agentscope/	v1.0	v1.0.10
CrewAI	https://pypi.org/project/crewai/	v0.1.0	v1.7.2
Dashscope	https://pypi.org/project/dashscope/	v1.0.0	v1.2.1
Dify	https://github.com/langgenius/dify/	v0.12.8	v1.11.2
Dify Plugin	https://github.com/langgenius/dify/	No restriction	No restriction
Google ADK	https://pypi.org/project/google-adk/	v1.2.1	v1.21.0
LangChain	https://pypi.org/project/langchain/	v0.1.0	v1.2.0
LangGraph	https://pypi.org/project/langgraph/	No restriction	v1.0.5
LiteLLM	https://pypi.org/project/litellm/	v1.0.0	v1.79.0
Llama-index	https://pypi.org/project/llama-index/	v0.10.5	v0.10.43
MCP	https://pypi.org/project/mcp/	v1.3.0	v1.12.4
OpenAI	https://pypi.org/project/openai/	v1.0.0	v2.14.0
RagFlow	https://github.com/infiniflow/ragflow/	v0.14.0	v0.21.1

Layanan LLM (large language model)

Component	PyPI/GitHub repository URL	Earlier versions	Later versions
SGLang	https://pypi.org/project/sglang/	v0.4.6	v0.4.9.post6
vLLM V0	https://pypi.org/project/vllm/	v0.5.0	v0.8.4
vLLM V1	https://pypi.org/project/vllm/	V0.8.2	V0.10.0

Framework HTTP/RPC

Component	PyPI/GitHub repository URL	Previous version	Maximum version
aiohttp	https://pypi.org/project/aiohttp/	v3.0	No restriction
asgiref	https://pypi.org/project/asgiref/	v3.0	No restriction
BlackSheep	https://pypi.org/project/blacksheep/	v1.2.0	No restriction
Click	https://pypi.org/project/click/	v8.1.3	< 9.0.0
Django	https://pypi.org/project/Django/	v1.10	No restriction
FastAPI	https://pypi.org/project/fastapi/	v0.58	No restriction
Flask	https://pypi.org/project/Flask/	v1.0	No restriction
gRPC	https://pypi.org/project/grpcio/	v1.42.0	No restriction
Jinja2	https://pypi.org/project/jinja2/	v2.7	< 4.0
Requests	https://pypi.org/project/requests/	v2.0	No restriction
Tornado	https://pypi.org/project/tornado/	v5.1.1	No restriction
WSGI	None	No restriction	No restriction

Database vektor

Component	PyPI/GitHub repository URL	Minimum version	Maximum version
milvus	https://pypi.org/project/milvus/	v2.4.1	No restriction

Kerangka kerja database

Component	PyPI/GitHub repository URL	Minimum version	Maximum version
aiopg	https://pypi.org/project/aiopg/	v0.13.0	< 2.0.0
AsyncPG	https://pypi.org/project/asyncpg/	v0.12.0	No restriction
DBAPI	No specific dependency	No specific version requirement	No restriction
MySQL	https://pypi.org/project/mysql-connector-python/	v8.0	< 10.0
MySQLClient	https://pypi.org/project/mysqlclient/	No specific version requirement	< 3
psycopg	https://pypi.org/project/psycopg/	v3.1.0	No restriction
psycopg2	https://pypi.org/project/psycopg2/	v2.7.3.1	No restriction
Pydantic	https://pypi.org/project/pydantic/	v1.10.2	No restriction
PyMongo	https://pypi.org/project/pymongo/	v3.1	< 5.0
PyMSSQL	https://pypi.org/project/pymssql/	v2.1.5	< 3
PyMySQL	https://pypi.org/project/pymysql/	No specific version requirement	< 2
SQLAlchemy	https://pypi.org/project/sqlalchemy/	v1.0.0	< 2.1.0
SQLite3	No specific dependency	No specific version requirement	No restriction
TortoiseORM	https://pypi.org/project/tortoise-orm/	v0.17.0	No restriction

Plugin Cache

Component	PyPI/GitHub repository URL	Minimum version	Maximum version
Cassandra	https://pypi.org/project/cassandra-driver/	v3.25	No restriction
Elasticsearch	https://pypi.org/project/elasticsearch/	v6.0	No restriction
PyMemcache	https://pypi.org/project/pymemcache/	v1.3.5	< 5
Redis	https://pypi.org/project/redis/	v2.6	No restriction
Scylla	https://pypi.org/project/scylla-driver/	v3.25	No restriction

Plugin Antrian Pesan

Component	PyPI/GitHub repository URL	Minimum version	Later versions
aio-pika	https://pypi.org/project/aio-pika/	No specific version requirement	No restriction
aiokafka	https://pypi.org/project/aiokafka/	No specific version requirement	No restriction
Celery	https://pypi.org/project/celery/	v4.0	< 6.0
Confluent Kafka	https://pypi.org/project/confluent-kafka/	v1.8.2	v2.7.0
Kafka Python	https://pypi.org/project/kafka-python/	No specific version requirement	No restriction
Pika	https://pypi.org/project/pika/	No specific version requirement	No restriction
Remoulade	https://pypi.org/project/remoulade/	v0.50	No restriction

Plugin lainnya

Component	PyPI/GitHub repository URL	Earlier versions	Maximum version
asyncio	No specific dependency	No specific version requirement	No restriction
Logging	No specific dependency	No specific version requirement	No restriction
Loguru	https://pypi.org/project/loguru/	v0.5.0	v1.0
Threading	No specific dependency	No specific version requirement	No restriction