Tüm Ürünler
Search

Bu Ürün

    Application Real-Time Monitoring Service:Python aracısını manuel olarak yükleyin

    Belge Merkezi

    Application Real-Time Monitoring Service:Python aracısını manuel olarak yükleyin

    Son Güncelleme:Oct 05, 2026

    Bu konuda, Python aracısının nasıl manuel olarak yükleneceği açıklanmaktadır. Yükleme tamamlandıktan sonra ARMS uygulamanızı izler; böylece uygulama topolojisini, izlemeleri, SQL analizlerini ve diğer izleme verilerini görüntüleyebilirsiniz.

    Not

    Önkoşullar

    Python çerçeve uyumluluğu

    Devam etmeden önce bu çerçeveye özel gereksinimleri inceleyin.

    uvicorn

    Uygulamanız uvicorn ile başlatılıyorsa aşağıdaki yaklaşımlardan birini seçin:

    Yaklaşım A: Aracıyı kodda içe aktarın. Uvicorn giriş dosyanızın ilk satırına aşağıdaki içe aktarma ifadesini ekleyin:

    from aliyun.opentelemetry.instrumentation.auto_instrumentation import sitecustomize

    **Yaklaşım B: aliyun-instrument öneki ile gunicorn'a geçiş yapın.** uvicorn komutunuzu aşağıdaki gibi değiştirin:

    # Before
uvicorn app:app --workers 4 --port=9090 --host 0.0.0.0

# After
aliyun-instrument gunicorn -w 4 -k uvicorn.workers.UvicornWorker -b 0.0.0.0:8000 app:app
    Not

    aliyun-instrument öneki, ARMS Python aracısının başlatılmasını ve müdahalesiz enstrümantasyonunu yönetir.

    uWSGI

    Uygulamanız uWSGI ile başlatılıyorsa bkz. uWSGI ile başlatılan Django veya Flask projesi için Python aracısını yükleme.

    gevent

    gevent coroutine'lerini kullanıyorsanız GEVENT_ENABLE ortam değişkenini true olarak ayarlayın.

    Örneğin, kodunuz şunları içeriyorsa:

    from gevent import monkey
monkey.patch_all()

    Dağıtımınızda aşağıdaki ortam değişkenini ayarlayın:

    GEVENT_ENABLE=true

    Adım 1: aliyun-bootstrap yükleyicisini indirin

    Aracı yükleyicisini Python Package Index (PyPI) üzerinden indirin.

    pip3 install aliyun-bootstrap

    Adım 2: Ortam değişkenlerini yapılandırın

    Python uygulaması için aşağıdaki ortam değişkenlerini manuel olarak ekleyin:

    # Method 1: Add environment variables for all processes in the current shell
export ARMS_APP_NAME=xxx   # The name of your application.
export ARMS_REGION_ID=xxx   # The region ID for your Alibaba Cloud account.
export ARMS_LICENSE_KEY=xxx   # Your license key.
    # Method 2: Add environment variables for a single process
ARMS_APP_NAME=xxx ARMS_REGION_ID=xxx ARMS_LICENSE_KEY=xxx aliyun-instrument xxx.py

    Lisans anahtarını bir OpenAPI işlemi çağırarak elde edebilirsiniz. Daha fazla bilgi için bkz. Lisans anahtarlarını listeleme.

    (İsteğe bağlı) Docker yükleme örneği

    Docker ortamları için Dockerfile'ınızı aşağıdaki örneğe göre güncelleyin.

    # Add environment variables
ENV ARMS_APP_NAME={YourAppName}
ENV ARMS_REGION_ID={YourRegionId}
ENV ARMS_LICENSE_KEY={YourLicenseKey}
## Original environment

    Adım 3: Python aracısını yükleyin

    1. Yüklemeyi hızlandırmak için öncelikle aşağıdaki komutu çalıştırarak paket deposunu yapılandırmanızı öneririz:

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

    2. Aracıyı yükleyin.

      aliyun-bootstrap -a install
      Not

      Python aracısının belirli bir sürümünü yüklemek için aşağıdaki komutu çalıştırın:

      # Replace ${version} with the target version number.
aliyun-bootstrap -a install -v ${version}

      Yayınlanan tüm Python aracı sürümlerinin listesi için bkz. Python aracısı sürüm notları.

    Adım 4: Uygulamayı başlatın

    ARMS Python aracısı ile başlatma

    aliyun-instrument python app.py

    Sonuçları doğrulayın

    Yaklaşık bir dakika sonra Python uygulamanız ARMS konsolu içindeki Application Monitoring > Application List sayfasında görünür ve veri gönderirse entegrasyon başarılı olmuş demektir.