Cloud Monitor:QwenPaw アプリケーションの統合

ACK および ACS

カスタムイメージを使用する場合は、まず QwenPaw が実行される Python 環境が pip3 で使用される環境と一致していることを確認してください。イメージの起動方法、実行ユーザー、または Python 環境を確認できない場合は、手動プローブ統合を使用してください。

手順 1：ack-onepilot のインストール

1. ACK コンソールにログインし、左側メニューで [Clusters] を選択します。

2. 対象のクラスターの名前をクリックします。左側メニューで [Operations & Maintenance] > [Component Management] を選択します。

3. ack-onepilot カードで [Install] をクリックします。パラメーターを設定します。既定値を使用することを推奨します。続いて [Confirm] をクリックします。

   説明

   ack-onepilot コンポーネントはバージョン 5.1.1 以降である必要があります。以前のバージョンがインストールされている場合は、[Component Management] ページで ack-onepilot をアップグレードしてください。

手順 2：AI アプリケーション監視の有効化

ack-onepilot の自動統合では、CloudMonitor 2.0 コンソールから事前に統合コマンドを取得する必要はありません。Deployment の spec.template.metadata.labels に次のラベルを追加し、アプリケーション名とワークスペースを実際の値に置き換えてください：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: qwenpaw
spec:
  template:
    metadata:
      labels:
        aliyun.com/app-language: python
        armsPilotAutoEnable: "on"
        armsPilotCreateAppName: "qwenpaw-demo"
        armsPilotAppWorkspace: "<Your-Workspace>"
    spec:
      containers:
        - name: qwenpaw
          image: agentscope-registry.ap-southeast-1.cr.aliyuncs.com/agentscope/qwenpaw:latest

ワークロードを更新した後、Pod が再作成されて起動するまで待ちます。起動ログに Aliyun python agent is started が表示される場合、Python プローブがアプリケーションプロセスにロードされています。

手動プローブ統合

この方法は、ack-onepilot を使用しない場合、カスタムイメージのインジェクション条件を確認できない場合、またはプローブのインストールプロセスをイメージビルドに含めたい場合に適しています。イメージのビルドフェーズ中、またはコンテナの起動前に、QwenPaw が実行される Python 環境から、コンソールで生成されたインストールコマンドを実行してください。

手順 1：統合パラメーターの取得

1. CloudMonitor 2.0 コンソールにログインし、対象のワークスペースを選択します。

2. 左側メニューで [Integration Center] をクリックします。

3. Observability for AI Applications セクションで、QwenPaw の統合項目を選択します。

4. パラメーター設定セクションでアプリケーション名を入力し、デプロイ環境に基づいて接続方法を選択してから、LicenseKey の横にある [Click to obtain] をクリックします。

5. Endpoint、LicenseKey、Project、Workspace、serviceName を含む、生成された統合パラメーターを記録してください。

手順 2：プローブを含むイメージのビルド

FROM agentscope-registry.ap-southeast-1.cr.aliyuncs.com/agentscope/qwenpaw:latest

RUN curl -fsSL https://arms-apm-cn-hangzhou-pre.oss-cn-hangzhou.aliyuncs.com/qwenpaw-cms-plugin/install.sh | bash -s -- \
  --python /app/venv/bin/python \
  --skip-qwenpaw-check \
  --site-bootstrap \
  --x-arms-license-key "<Your-LicenseKey>" \
  --x-arms-project "<Your-Project>" \
  --x-cms-workspace "<Your-Workspace>" \
  --serviceName "qwenpaw-demo" \
  --endpoint "https://<Endpoint>/apm/trace/opentelemetry"

コンテナの起動時にインストールコマンドを実行する場合は、qwenpaw app を起動する前にインストールが完了していることを確認してください。その後、環境変数と site 初期化設定を反映するために Pod を再作成してください。

個人 PC からの統合

この方法は、開発、デバッグ、概念実証 (PoC) の検証、問題の再現、または macOS、Linux、Windows Subsystem for Linux (WSL) などのローカルマシンでの短期検証に適しています。この方法では、ローカルの Python プロセス起動時にオブザーバビリティ機能をロードする軽量な site bootstrap を使用します。QwenPaw を ACK、ACS、コンテナイメージにデプロイしている場合、または長期運用が必要な場合は、代わりに手動プローブ統合を推奨します。

手順 1：統合コマンドの取得

1. CloudMonitor 2.0 コンソールにログインし、対象のワークスペースを選択してください。

2. 左側メニューで [Integration Center] をクリックしてください。

3. Observability for AI Applications セクションで、QwenPaw の統合項目を選択してください。

4. パラメーター設定セクションでアプリケーション名を入力し、個人 PC からの統合方法を選択してから、生成されたインストールコマンドをコピーしてください。このコマンドには、Endpoint、LicenseKey、Project、Workspace、serviceName などの情報が含まれます。

手順 2：オブザーバビリティプラグインのインストール

QwenPaw が存在するマシンでインストールコマンドを実行してください。QwenPaw を conda 環境で実行している場合は、先に conda activate qwenpaw を実行して切り替えてください。

curl -fsSL https://arms-apm-cn-hangzhou-pre.oss-cn-hangzhou.aliyuncs.com/qwenpaw-cms-plugin/install.sh | bash -s -- \
  --x-arms-license-key "<Your-LicenseKey>" \
  --x-arms-project "<Your-Project>" \
  --x-cms-workspace "<Your-Workspace>" \
  --serviceName "qwenpaw-demo" \
  --endpoint "https://<Endpoint>/apm/trace/opentelemetry"

インストールに成功すると、ターミナルに次のような出力が表示されます：

qwenpaw-cms-plugin installed successfully!

手順 3：QwenPaw アプリケーションの起動

プラグインのインストール後、環境変数を設定してから QwenPaw を起動してください：

export LOONGSUITE_PYTHON_SITE_BOOTSTRAP=true
qwenpaw app

アプリケーションがすでに実行中の場合は、停止してから再起動してください。起動後、http://127.0.0.1:8088/ にアクセスして QwenPaw Console を開き、会話またはタスクを開始してください。

ターミナルに次のメッセージが表示される場合、OpenTelemetry 自動計装が初期化されています：

loongsuite-site-bootstrap: started successfully (OpenTelemetry auto-instrumentation initialized).