AI Agent Observability対応環境
このドキュメントはAI Agent Observabilityエージェントの言語別対応環境とバージョン要件を案内します。エージェントをインストールする前に、アプリケーション環境が対応範囲に該当するか確認してください。
Pythonエージェントの動作環境
WhaTap Pythonモニタリングエージェントをインストールする前に、サポート環境を確認してください。
最終更新日: 2026-09-07
サポートバージョン
| アプリケーションタイプ | Pythonバージョン |
|---|---|
| WSGIアプリケーション | 3.7 ~ 3.13 |
| ASGIアプリケーション | 3.7 ~ 3.13 |
オペレーティングシステム
| OS | 最小バージョン | アーキテクチャ |
|---|---|---|
| Ubuntu | 12.04 | 64bit |
| Red Hat / CentOS | 6.x | 64bit |
| macOS | 10.15 Catalina | - |
| Windows | Windows Server 2008 R2, Windows 7 | 64bit |
アプリケーションサーバー
| フレームワーク | サポートバージョン |
|---|---|
| Bottle | - |
| Celery | - |
| CherryPy | - |
| Django | - |
| FastAPI | 0.84.0 |
| Flask | - |
| Frappe | - |
| Nameko | - |
| Odoo | v14 ~ v19 |
| Tornado | - |
ライブラリ
| カテゴリ | ライブラリ |
|---|---|
| 外部呼び出し | HttpLib, HttpLib2, Requests, Urllib, HTTPX, HTTPX2 |
| データ処理 | SQL Alchemy, GraphQL |
| ロギング | smtplib, logging, loguru |
| メッセージング | Kombu, Pika |
| LLM SDK | OpenAI, Anthropic, Amazon Bedrock |
| Agent Orchestration | Hermes, LangGraph |
データベース
| データベース | ドライバー |
|---|---|
| MongoDB | pymongo |
| MySQL | MySQLdb, pymysql |
| Neo4j | neo4j |
| Oracle | cxOracle |
| PostgreSQL | psycopg2, psycopg, psycopg_pool |
| Redis | redis |
| SQLite | sqlite3 |
whatap-python[llm]パッケージは、外部ライブラリdatasketches>=5.2.0、genai-pricesを必要とします。
LLMプロバイダー別の収集範囲
Python SDKは、LLMプロバイダーを呼び出す処理をトランザクションのLLM APIステップとして収集します。プロバイダーSDKのバージョンや呼び出し方式によって収集条件が異なるため、以下の内容を確認してください。
OpenAI・Anthropic
openai 3.0.0以上とanthropic 1.0.0以上は、HTTP転送ライブラリとしてhttpxの代わりにhttpx2を使用します。このバージョンのプロバイダーSDKでLLM APIステップとAPIステータスコード統計を収集するには、Python SDK 2.2.1以上を使用してください。
Amazon Bedrock
Amazon Bedrock RuntimeのConverse、ConverseStream、InvokeModel、InvokeModelWithResponseStream呼び出しをLLM APIステップとして収集します。Python SDK 2.2.1以上でサポートし、llm_enabled=trueに設定すると計装が動作します。
Bedrock RuntimeはREST APIであるため、アプリケーションごとに呼び出し経路が異なります。Python SDKが収集する呼び出し経路は次のとおりです。
| Path | Description |
|---|---|
boto3 | langchain-awsのChatBedrockConverse・ChatBedrockを含む |
aioboto3・aiobotocore | 非同期クライアントの呼び出し |
| LiteLLMなどのHTTP直接呼び出し | httpx・httpx2・requestsでBedrock Runtime REST経路（POST /model/{modelId}/converseなど）を呼び出す処理 |
AnthropicBedrock | anthropicパッケージのBedrockクライアント |
| OpenAI互換エンドポイント | base_urlにbedrock-runtimeまたはbedrock-mantleが含まれるクライアント |
- プロバイダーは、呼び出し経路に関係なく
bedrockとして収集します。 - 1つの呼び出しが複数の階層を経由しても、LLM APIステップは1つだけ記録します。
us.、jp.、apac.のようなクロスリージョン推論プロファイルのモデルIDもコストを計算します。- トラジェクトリーの停止とLLM呼び出しブロックユーザー（
llm_blocked_users）の設定は、Bedrock呼び出しにも適用されます。
Bedrockの計装のみを無効にするには、whatap.confにignore_instrumentation_set=bedrockを追加してください。boto3、aioboto3・aiobotocore、HTTP直接呼び出し経路の収集を停止します。AnthropicBedrockとOpenAI互換エンドポイントの呼び出しは、それぞれanthropic、openaiの計装で収集するため、この設定の影響を受けません。オプションの説明はPythonエージェント機能の制御ドキュメントを参照してください。
今後サポート予定
| SDKタイプ | 状態 |
|---|---|
| Node.js | 今後サポート予定 |
| Others (Go, PHP, .NETなど) | 今後サポート予定 |
共通サポート環境
サービス提供形態
WhaTapモニタリングは、SaaSまたはオンプレミス（インストール型）方式でご利用いただけます。どちらを選択しても、同じエージェントで同じモニタリング機能をご利用いただけます。
| Deployment | Support | Description |
|---|---|---|
| SaaS | ✅ | WhaTapが運用する収集サーバーに接続。リージョン別アドレスはファイアウォール項目を参照 |
| オンプレミス（インストール型） | ✅ | 収集サーバーを自社で構築して運用（閉域網環境に対応）。導入範囲は営業担当者と協議 |
インターネットに接続しない閉域網環境でも、オンプレミスで構築できます。
提供形態による機能の違い
どの形態を選択しても、モニタリング機能は同じです。モバイルアプリのみが例外で、service.whatap.io SaaSでのみご利用いただけます。
オンプレミス環境で一部の機能をご利用いただくには、別途契約が必要です。
対応ブラウザ
WhaTapモニタリングサービスは、ウェブブラウザとモバイルアプリで利用できます。
| Webブラウザ | 推奨 | 対応バージョン |
|---|---|---|
| Google Chrome | ✅ | 111以降 |
| Mozilla FireFox | ❌ | 最新バージョン |
| Edge | ❌ | 最新バージョン |
| Safari | ❌ | 最新バージョン |
サポート案内
- ブラウザの互換性および性能の観点から、Chrome の最新バージョンの使用を推奨します。
- ユーザーインターフェース（User Interface, UI）は HTML5 標準技術で実装されているため、Internet Explorer はサポートしていません。
制約事項
WhaTap の Web インターフェースはモバイルブラウザをサポートしていません。モバイル端末から WhaTap にアクセスするには、Android または iOS 用の WhaTap アプリをインストールしてください。WhaTap モバイルアプリはモバイル環境に最適化されています。WhaTap モバイルアプリの詳細については、こちらのドキュメント を参照してください。
ファイアウォール
WhaTap エージェントは、収集サーバーの TCP 6600 ポートにアクセスできる必要があります。監視対象に最も近い収集サーバーのアドレスを許可してください。
出発地：WhaTapエージェント
| クラウド | 目的地 | 目的地IP | ポート番号 |
|---|---|---|---|
| AWS | WhaTapソウル収集サーバー | 13.124.11.223 / 13.209.172.35 | TCP 6600 |
| WhaTap東京収集サーバー | 52.68.36.166 / 52.193.60.176 | TCP 6600 | |
| WhaTapシンガポール収集サーバー | 18.138.0.93 / 18.139.67.236 | TCP 6600 | |
| WhaTapジャカルタ収集サーバー | 108.136.91.69 / 108.137.158.44 | TCP 6600 | |
| WhaTapタイ収集サーバー | 43.209.109.219 / 43.209.48.86 | TCP 6600 | |
| WhaTapムンバイ収集サーバー | 13.127.125.69 / 13.235.15.118 | TCP 6600 | |
| WhaTapカリフォルニア収集サーバー | 52.8.223.130 / 52.8.239.99 | TCP 6600 | |
| WhaTapバージニア収集サーバー | 107.23.220.101 / 54.236.221.105 | TCP 6600 | |
| WhaTapフランクフルト収集サーバー | 3.125.142.162 / 3.127.76.140 | TCP 6600 | |
| Azure | WhaTapソウル収集サーバー | 52.231.66.38 / 20.194.5.115 | TCP 6600 |
| WhaTap東京収集サーバー | 52.246.169.54 / 20.210.27.232 | TCP 6600 | |
| Kakao | WhaTapソウル収集サーバー | 61.109.237.237 / 61.109.238.166 | TCP 6600 |
インバウンド遮断ポリシーを使用する場合は、応答トラフィックを確認します。
エージェントが収集サーバーへ接続を開始するため、エージェントホストでインバウンドの6600ポートを開放する必要はありません。ただし、収集サーバーが送る応答パケットはエージェントホストに届く必要があります。インバウンドポリシーで、すでに確立されたセッションの応答トラフィック（established、related）まで遮断していないかを確認します。
応答トラフィックを遮断しなければならない場合は、例外を一つ設定します。収集サーバーIPの6600ポートからエージェントホストのエフェメラルポート範囲へ入るトラフィックのみを許可します。
エージェントから収集サーバーに直接接続できない場合は、提供するProxyモジュールを使用して経由します。
