Python でサポートされるコンポーネントおよびバージョン

オンラインで編集する

Instana （ Python ）パッケージが現在の環境と互換性があることを確認するには、 Instana （ Python ）パッケージのサポート対象コンポーネントおよびバージョンを確認してください。

Python アプリケーションの監視に関する詳細については、 「 Python の監視」 を参照してください。

Instana AutoTrace Webhook

オンラインで編集する

Instana の AutoTrace Webhookを使用すると、 Kubernetes クラスタ全体にわたる Python プロセスを自動的に監視できます。

Python ランタイム

オンラインで編集する
注：Instana、 Python、 2.5.4 およびそれ以前のバージョンでは、Tornado、asyncio、aiohttp ライブラリのトレース機能は、 3.10 までの Python ランタイムでのみサポートされています。
Python バージョン Instana Python パッケージのバージョン
CPython >= 3.9 かつ <= 3.14 >= 3.9.0
CPython 3.8以上3.13未満 >= 3.0.0
CPython >=3.8と<3.13 >= 2.5.0
CPython > = 3.7 および < 3.10 < 2.5.0
CPython > = 2.7 および < = 3.6 < 2.0.0

長期サポート

オンラインで編集する

Instana Python の公式な長期サポート（LTS）およびサポート終了（EOL）のスケジュールに従います。

注：Python のバージョンがサポート終了日を迎えた場合、 Instana ではさらに1年間のサポート期間を提供します。 トラブルを防ぐため、 Python のバージョンを定期的に更新してください。

サポートされる環境

オンラインで編集する

Instana Python パッケージは、幅広い環境に対応しています。

プラットフォーム

オンラインで編集する

以下のプラットフォームおよびCPUアーキテクチャがサポートされています：

プラットフォーム x86_64/amd64 ppc64le s390x aarch64/arm64
Linux ✅ ✅ ✅ ✅
Red Hat1 ✅ ✅ ✅ ✅
Windows2 ✅ ❌ ❌ ❌
AWS Fargate ✅ ❌ ❌ ❌
AWS Lambda ✅ ❌ ❌ ✅
Kubernetes ✅ ✅ ✅ ✅
Google Cloud ✅ ❌ ❌ ❌
コンテナ3 ✅ ✅ ✅ ✅
IBM AIX4 ❌ ✅ ❌ ❌
IBM i5 ❌ ✅ ❌ ❌
LinuxOne ❌ ❌ ✅ ❌
注：Instana、 Python、 3.5.0 の各パッケージでは、および s390 のサポートが ppc64le 導入され、 3.6.0 では Windows のサポートが追加されました。

トレース

オンラインで編集する

Instana の Python パッケージは、 Instana で計測対象となっている他のプラットフォーム、技術、および言語にわたる分散トレーシングをサポートしています。

注： 「 Instana Python package version」の列には、バージョンに関する制限に関する追加情報が記載されています。 「 Instana Python package version」列の値は、パッケージのバージョンが 3.0.0Any 以上であることを意味します。
注： サポートされているフレームワークやライブラリの中には、すべてのCPUアーキテクチャやプラットフォームで利用できないものがあります。

仕様の対応

オンラインで編集する

次の表は、 Instana の Python パッケージがサポートする仕様を一覧にしたものです：

仕様 サポート・ポリシー 最小バージョン 最大バージョン Instana Python パッケージのバージョン
ASGI 45 日間 2.0.0 3.0 任意
WSGI 0日 PEP 333 1.0 1.0.1 任意

HTTP

オンラインで編集する

以下の表は、 Instana の Python パッケージでサポートされている HTTP のフレームワークおよびライブラリの一覧です：

Web フレームワーク

オンラインで編集する

次の表は、 Instana の Python パッケージでサポートされている HTTP のWebフレームワークの一覧です：

フレームワーク サポート・ポリシー 最小バージョン 最大バージョン Instana Python パッケージのバージョン
Django 45 日間 1.11.0 6.0.6 任意
FastAPI 45 日間 0.51.0 0.138.0 任意
Flask 45 日間 0.12.0 3.1.3 任意
Pyramid 45 日間 1.6.5 2.1 任意
Sanic オンデマンド 21.9.0 25.12.1 任意
スターレット 45 日間 0.12.13 1.3.1 任意
Tornado 45 日間 6.0.0 6.5.7 任意
Werkzeug 45 日間 2.2.0 3.1.8 >= 3.15.0

クライアントとライブラリ

オンラインで編集する

以下の表は、 Instana の Python パッケージでサポートされている HTTP クライアントおよびライブラリの一覧です：

ライブラリー サポート・ポリシー 最小バージョン 最大バージョン Instana Python パッケージのバージョン
aiohttp 45 日間 3.1.0 3.14.1 Python が 3.9 以上であるもの
Httpx 45 日間 0.20.0 0.28.1 >= 3.5.0
要求 45 日間 2.16.1 2.34.2 任意
Urllib3 45 日間 1.26.5 2.7.0 任意

RPC

オンラインで編集する

以下の表は、 Instana の Python パッケージでサポートされている RPC ライブラリの一覧です：

ライブラリー サポート・ポリシー 最小バージョン 最大バージョン Instana Python パッケージのバージョン
grpcio 45 日間 1.14.1 1.81.1 任意
Spyne 45 日間 2.13.1a0 2.14.0 >= 3.4.0 宛て Python < 3.12

データベース

オンラインで編集する

以下の表は、 Instana の Python パッケージでサポートされているデータベースライブラリの一覧です：

ライブラリー サポート・ポリシー 最小バージョン 最大バージョン Instana Python パッケージのバージョン
AWS DynamoDB6 45 日間 1.15.0 1.43.36 任意
AWS S36 45 日間 1.15.0 1.43.36 任意
Cassandra -ドライバー 45 日間 3.20.2 3.30.0 任意
Couchbase オンデマンド 2.3.5 2.5.12 任意
mysqlclient 45 日間 1.3.14 2.2.8 任意
PyMySQL 45 日間 0.6.7 1.2.0 任意
pymongo 45 日間 3.7.0 4.17.0 任意
Psycopg2 45 日間 2.7.2 2.9.12 任意
Redis 45 日間 2.10.6 8.0.1 任意
SQLAlchemy 45 日間 1.1.5 2.0.51 任意

メッセージング

オンラインで編集する

以下の表は、 Instana の Python パッケージでサポートされているメッセージングライブラリの一覧です：

ライブラリー サポート・ポリシー 最小バージョン 最大バージョン Instana Python パッケージのバージョン
Aioamqp 45 日間 0.15.0 0.15.0 >= 3.4.0
アイオピカ 45 日間 9.1.0 9.6.2 >= 3.5.0
Confluent Kafka 45 日間 2.0.0 2.14.2 >= 3.4.0
Kafka -python 45 日間 2.0.0 2.2.15 >= 3.4.0 宛て Python < 3.12
Kafka -python-ng 45 日間 2.0.0 2.2.3 >= 3.4.0 および Python >= 3.12
pika 45 日間 1.0.0 1.4.1 任意

クラウド・サービス

オンラインで編集する

以下の表は、 Instana の Python パッケージでサポートされているクラウドサービスライブラリの一覧です：

ライブラリー サポート・ポリシー 最小バージョン 最大バージョン Instana Python パッケージのバージョン
Boto3 （ AWS SDK） 45 日間 1.15.0 1.43.36 任意
Google - cloud-pubsub7 45 日間 2.0.0 2.39.0 任意
google-cloud-storage 45 日間 1.24.0 3.12.0 任意

Python 組み込みモジュール

オンラインで編集する

以下の表は、 Instana の Python パッケージでサポートされている Python の組み込みライブラリの一覧です：

ライブラリー サポート・ポリシー 最小バージョン 最大バージョン Instana Python パッケージのバージョン
Asyncio 0日 1.4 23.7.0 任意
ロギング 0日 4.3.0 5.5.3 任意

その他のライブラリー

オンラインで編集する

以下の表は、 Instana の Python パッケージでサポートされているその他のライブラリの一覧です：

ライブラリー サポート・ポリシー 最小バージョン 最大バージョン Instana Python パッケージのバージョン
gevent オンデマンド 23.9.0.post1 26.5.0 >= 3.4.0
Celery 45 日間 4.3.0 5.6.3 任意

追跡メモと制限事項

オンラインで編集する

Instana Python Tracer の権限と制限についてご確認ください。

スレッド作成権限

オンラインで編集する

Instana Python トレーサーは、 Python threading.Timer オブジェクトを作成および起動するための権限を必要とします。 ほとんどのシステムでは、この権限はデフォルトで付与されます。 一部のネストされたコンテナ化環境（たとえば、 Docker を Docker 内に配置したコンテナ構成など）では、この権限はデフォルトでは付与されません。

RuntimeError: can't start new threadのような例外が表示される場合は、権限が不十分であることが原因である可能性が高いです。 Docker -in- Docker コンテナをアップグレードまたは変更した際、内部のアプリケーションコンテナに必要な権限が付与されていない場合は、最終手段としてこの --privileged 権限を使用してアプリケーションコンテナを起動することができます。

スレッド境界を越えてトレースする

オンラインで編集する

Instana の Python パッケージは、スレッド境界を越えたトレースをサポートしていません。 例えば、要求が最初に単一スレッドで処理され、 multiprocessing.ThreadPoolを使用してワークロードが複数の他のスレッドに分散される場合、それらの他のスレッドで発生する発信呼び出しはキャプチャーされません。 すべての出口スパンはエントリー・スパンを持つ必要があり、開始エントリー・スパンはスレッド・スコープ外であるため、このような発信呼び出しは記録されません。 これは、デフォルトの OpenTracing の固有の ThreadLocalScopeManager特性と、特定のスコープ ThreadPool マネージャーが存在しないことが原因です。

複数のトレーサーを使ったトレース

オンラインで編集する

Instana と、 New Relic トレーサーや OpenTelemetry などのサードパーティ製トレーサーを併用して、単一の Python アプリケーションをトレースすることはサポートされていません。

サポートされる Web サーバー

オンラインで編集する

Instana の Python パッケージは、以下のWebサーバーに対応しています：

  • uWSGI
  • Gunicorn
  • mod_wsgi
  • Nginx WSGI
  • uvicorn

センサー・データ収集

オンラインで編集する

Instana Python センサーは、以下のデータを収集します：

追跡対象の構成

オンラインで編集する

Instana Python センサーは、以下の構成データを収集します：

  • 名前
  • ランタイム
  • PID
  • ロードされたモジュール

メトリック

オンラインで編集する

Instana Python センサーは、以下のメトリクスを収集します：

  • GC アクティビティー
  • メモリー使用率
  • スレッド数
  • ページング
  • 入出力
  • イベント
  • コンテキスト・スイッチ

AutoProfile

オンラインで編集する

Instana Python パッケージは、以下のプロファイルを生成します：

プロファイル Python のバージョン プラットフォーム
CPU 使用率 > = 2.7 および> = 3.4 Linux および macOS
メモリー割り振り率 >= 3.4 Linux および macOS
呼び出しのブロック >= 3.4 Linux および macOS

追加情報

オンラインで編集する

  1. Instana Python パッケージは、以下の Red Hat Enterprise Linux のバージョンをサポートしています： RHEL 8.10、 RHEL 9.6、および RHEL 10.0。 ↩︎

  2. Instana の Python パッケージは、以下の Windows のバージョンをサポートしています： Windows 11および Windows Server 2025。 ↩︎

  3. Docker、 Podman、およびRancherが、サポートされているコンテナエンジンおよびコンテナ管理ツールです。↩︎

  4. Instana の Python パッケージは、以下の AIX のバージョンをサポートしています： 7.2 および 7.3。 ↩︎

  5. Instana Python パッケージは、 IBM i 7.5 をサポートしています。 ↩︎

  6. AWS DynamoDB また、 AWS S3 は、 Boto3 パッケージを通じて実装されています。 ↩︎

  7. Instana の Python パッケージは、 Google のPub/Subにおけるプル方式のメッセージ配信のみをサポートしています。 ↩︎