Python Agent Release Notes

2026-10-19

v2.2.2

LLM Observability

Fixed LLMモードでネイティブエージェントが重複して起動する現象を修正しました。

v2.2.1で修正した重複起動の現象が、LLMモードでは引き続き発生していた問題を解消しました。

2026-09-29

v2.2.1

LLM Observability

New AWS Bedrock Runtimeの計測をサポート

bedrock-runtimeのConverse、ConverseStream、InvokeModel、InvokeModelWithResponseStreamの呼び出しをLLM APIステップとして収集します。

New アクティブトラジェクトリーの停止機能を追加

アクティブLLM画面で実行中のトラジェクトリーを停止できます。
- 進行中のLLM呼び出しを中断して該当トランザクションを終了し、その後同じトラジェクトリーで発生するLLM呼び出しもブロックします。
停止した地点はトランザクションプロファイルにWhaTap: LLM trajectory stopped by controlメッセージステップとして記録されるため、アプリケーションエラーと区別できます。

New llm_blocked_users String オプションを追加

既定値: ""
指定したユーザーIDのLLM呼び出しをブロックします。カンマで区切り、大文字と小文字は区別しません。
- 例: llm_blocked_users=u-1024,abuse@example.com
ブロックされた呼び出しは該当SDKの接続エラー(例: APIConnectionError)として返り、トランザクションプロファイルにWhaTap: LLM call blocked for user …メッセージステップが記録されます。

New llm_httpc_step_enabled Boolean オプションを追加

既定値: true
LLMワークフロー内で発生したHTTP呼び出し(MCP、RESTツール呼び出しなど)をLLMステップと併せて収集します。
falseに設定すると、LLM API呼び出しのみを収集します。

New トラジェクトリーの新規開始件数メトリクスを追加

アクティブトラジェクトリーのメトリクスに、5秒間に新しく開始されたトラジェクトリー数(new_count)を追加しました。

Fixed openai 3.x、anthropic 1.xの環境でLLM APIステップとAPIステータスコードの統計が収集されない現象を修正

Fixed 短時間で実行して終了するプロセスでLLMトランザクションが失われる現象を修正

CLI実行や子プロセスのように一度実行して終了するプロセスで、トランザクションの終了情報とLLMログが送信されない問題を解消しました。

共通

New httpx2ライブラリの計測を追加

Changed ストリーミングHTTPレスポンスの経過時間を、レスポンスの終了時点を基準に測定

SSEなどのストリーミングレスポンスは、ヘッダーを受け取った時点ではなく、レスポンスが終了した時点までをステップの経過時間として収集します。

Fixed Linuxでwhatap_code_startをtrueに設定した場合、マルチワーカー(uvicorn --workersなど)環境でネイティブエージェントがワーカー数だけ重複して起動する現象を修正しました。

2026-09-01

v2.2.0

AI Agent Observability

New LLMワークフローのトランザクション計測を追加しました。

アプリケーショントランザクション内のLLM実行区間をトランザクション単位で収集します。

New 会話座標(User / Session / Turn)の収集を追加しました。

ユーザーIDとセッションIDをHTTPヘッダーまたはLLM SDKの呼び出し引数から自動収集します。
ターンIDはトランザクション開始時に自動付与されます。

New 評価(Evaluation)の判定モデルを設定するオプションを追加しました。

New llm_prompt_default_versionオプションを追加しました。

型: String、既定値: v1

New アクティブトラジェクトリの追跡機能を追加しました。

New アクティブLLM APIの追跡機能を追加しました。

New anthropic SDKの自動計測を追加しました。

New langgraphの自動計測を追加しました。

New hermes-agentゲートウェイの自動計測を追加しました。

Changed 評価区間の指定が、全体設定およびサンプリングと独立して動作するよう改善しました。

Fixed LLM APIステップの経過時間が実際より短く収集される現象を修正しました。

Fixed LLMの同時呼び出し時にアクティブゲージが実際より少なく計上される現象を修正しました。

Fixed LLM呼び出し件数が失われる現象を修正しました。

共通

New llm_apm_txn_enabledオプションを追加しました。

型: Boolean、既定値: false
このオプションを有効にすると、APMプロジェクトでもLLMトランザクションを照会できます。

New プロセス境界(exec / spawn)をまたぐトレース伝播を追加しました。

子プロセスにトランザクションの連携情報を渡し、マルチプロセス構成でも呼び出し関係を接続します。

New ワーカースレッド(ThreadPoolExecutor)へのトレースコンテキスト伝播を追加しました。

ThreadPoolExecutor.submitで実行されたタスクが上位トランザクションに接続されます。

Fixed apm_enabledがfalseの設定でもAPM UDPソケットを生成する現象を修正しました。

Fixed hook_method_patternsなどのパターンオプションに指定したモジュール名が自動計測対象のモジュールと重なる場合、該当モジュールの計測が失われる現象を修正しました。

Fixed subprocess.Popenの呼び出し時にenvを位置引数として渡すと、アプリケーションの呼び出しが失敗する可能性がある現象を修正しました。

2026-08-18

v2.1.4

Fixed エントリモジュールが計測対象である場合にエージェントエラーが発生する現象を修正しました。

2026-08-05

v2.1.3

New hook_service_patternsオプションを追加しました。

指定したメソッドをトランザクションエントリポイントとしてラップします。

クラス単位のメソッド追跡時

hook_service_patterns="パッケージ:クラス.メソッド" # 例) myPackage:MyClass.__init__

関数単位の追跡時

hook_service_patterns="パッケージ:関数名" # 例) myPackage:my_function

New Odooフレームワークのサポートバージョンを拡大しました。

v16、v17 → v14~v19

2026-07-22

v2.1.2

Fixed エージェント2.0.0以降のバージョンでアクティブスタックが収集されない現象を修正しました。

2026-06-22

v2.1.1

LLM Observability

Fixed LiteLLM(in-process) 사용 시 LLM 호출이 실패하던 문제 수정

Fixed 스트리밍 tool_calls / reasoning 응답에서 TTFT·TPOT가 기록되지 않던 문제 수정

2026-06-10

v2.1.0

LLM Observability

New LLM呼び出しの自動評価（Evaluation）機能とオペレーションタイプ（Operation Type）計測機能を追加しました。

Changed LLMメトリクス構造を改善しました。

メトリクスカテゴリの分離
finish_reasonメトリクスの追加
リスト型メトリクスタグを並列配列フィールドへ平坦化
トークン/呼び出し統計の整理

共通

New 特定ライブラリの自動計測を選択的に無効化するオプションを追加しました。

ignore_instrumentation_set String: このオプションに登録されたライブラリは計測ロジックが有効になりません。複数の対象がある場合は,で区切ります。
デフォルト値なし、アプリケーションの再起動が必要です。
例: redis,openai

New wheel（bdist_wheel）パッケージの同時配布を追加しました。

Fixed ライセンスが未設定の場合、accesskeyへのアクセスでAttributeErrorが発生していた現象を修正しました。

Fixed profile_http_parameter_enabled使用時、一部のHTTPクライアント呼び出しで引数アクセスにより異常終了する可能性があった現象を修正しました。

2026-04-28

v2.0.2

LLM Observability

Changed LLMログシンクのUDP送信方式をシングル送信から48KB累積バッファリング方式に変更しました。

共通

New WindowsサービスのNSSMを使用したSession 0でのエージェント実行をサポートします。

New FastAPIフレームワークのBaseHTTPMiddleware追跡機能を追加しました。

Changed FastAPI追跡ロジックの安定性を改善しました。

Changed whatap.confの未設定値に対する環境変数フォールバックをサポートします。

Fixed エージェントログに不要な情報が記録されていた現象を修正しました。

2026-04-08

v2.0.1

LLM Observability

New openaiライブラリのトレーシングサポートを追加しました。

New LLM専用のMetric、Logサポートを追加しました。

New LLMコスト（Pricing）算定 — genai-prices連携によるモデルごとの入出力トークン単価計算をサポートします（失敗時は内蔵fallbackを使用）。

New vLLM互換 — openai SDK互換のvLLMサーバーに対するChat Completions / Completions APIフッキングおよびdelta.text fallbackをサポートします。

New whatap-llm-setting-config LMモード設定ファイルを自動生成・更新するコマンドを追加しました。

New LLMトレーシングオプションを追加しました。

llm_api_hosts String

このオプションに登録されたHTTCのホストはLLM APIパスとして認識されます。ホストが複数ある場合は,で区切ります。
- デフォルト値: なし
- 例: localhost:8000,api.openai.com:443
llm_model_pricing String

LLMモデルの1Mトークンあたりの価格を手動で入力します。このオプションに登録された価格が最優先で計算・保存されます。
- 形式: [モデル名]|[入力トークン]|[出力トークン]|[キャッシュトークン]
- 例: gpt-4o|2.50|10.00|1.25,gpt-4o-mini|0.15|0.60|0.075,my-custom-model|1.00|5.00

共通

New FastAPI SSEレスポンスストリーミングのトレーシングサポートを追加しました。

New LLM & APMデュアルエージェントモードを開発しました。

apm_enabled Boolean
- APMモードでエージェントを起動します
- license、whatap.server.host
注意

このライセンスとサーバーアドレスは必ずAPMプロジェクトのキーで入力してください。
llm_enabled Boolean
- LLMモードでエージェントを起動します
- llm_license、llm.whatap.server.host
注意

このライセンスとサーバーアドレスは必ずLLMプロジェクトのキーで入力してください。

2026-03-24

v1.9.2

New UDPポートの強制割り当てオプションを追加

Goモジュールとの通信に使用するUDPポートをユーザーが直接指定できるforce_net_udp_portオプションを追加

注意

Pythonエージェントプロセスを複数実行する場合、ポート競合のリスクがあるため、特定の環境でUDPポートを固定する必要がある場合のみ使用を推奨します。（デフォルト: 無効）

Feature httpx非同期トレーシングのサポートを追加

非同期HTTPクライアントであるhttpx.AsyncClientのインストゥルメンテーションを追加

Changed エージェントで必須となっていたsetuptoolsモジュールの依存関係を削除

Changed PEP 517ベースのビルドシステムのサポートを追加

Fixed DB接続再利用時の収集漏れ問題を修正

データベース接続を再利用またはシングルトンとして宣言して使用する際に、Stepで接続情報が正常に収集されなかった問題を修正

2026-01-26

v1.9.1

Fixed logging、loguru のトレースモジュールを修正

オプション値が False の場合にフックしないよう修正しました

Fixed trace_user_enabled オプションのロジックを修正

ValueError エラーが発生していた問題を修正しました

Fixed greenlet 環境におけるトレースロジックを修正

当該環境でエラーが発生した際、現在のフレームを取得できず例外オブジェクトを捕捉できなかった問題を修正しました

2025-12-23

v1.9.0

New Windows OS をサポート

Windows Server 2008 R2、Windows 7 以上

Fixed ACTIVE_STATUS モニタリングのバグ修正

マルチトランザクション発生時にデータが正常に整理されない問題を修正

Fixed HTTPC トレースのバグ修正

元の関数の戻り値が正しく渡されない問題を修正

Fixed Kubernetes コンテナ環境で Container ID が異常値として収集される問題を修正

2025-11-11

v1.8.14

Fixed psycopg_pool モジュールを修正

pool_connection を手動で呼び出した際に接続がプールに返却されない問題を修正しました。

Fixed psycopg モジュールを修正

特定のロジックで psycopg2 と競合が発生していた問題を修正しました。

Fixed ACTIVE_STATUS モニタリング機能を修正

不要な状況で ACTIVE_STATUS データが送信されていた問題を修正しました。

2025-10-01

v1.8.13

Fixed fastapi モジュールを修正

特定の関数が二回以上実行される現象を修正

Fixed httpx モジュールを修正

Streaming 方式で呼び出した際に発生するトレースエラーを修正

Fixed psycopg モジュールを修正

rowcount 属性アクセスエラーを修正
接続情報抽出ロジックの安定性を向上

Fixed Kubernetes コンテナ環境で Container ID がマッピングされない問題を修正

注意

Kubernetes エージェント v1.8.8 以上でサポート

2025-09-12

v1.8.12

New LLMログ監視に @step_id フィールドを追加

New LLMメトリクス収集機能を追加

llm_stat_enabled Boolean
- false: デフォルト
- true: このオプションと trace_llm_log_enabled、counter_thread_enabled がすべて true の場合にメトリクス収集が有効化されます
llm_stat_interval Number
- LLMメトリクス収集間隔を秒単位で設定するオプション
- 5: デフォルト

Feature counter_thread_enabled オプションを追加 Boolean

false: デフォルト
true: llm_stat と app_filedescriptor メトリクスを収集するスレッド（counter_thread）を有効化

Changed psycopg_pool トレースモジュールの安定性を向上

Changed psycopg と psycopg_pool の非同期トレース安定性を向上

Changed open_file_descriptor_enabled オプションは counter_thread の有効化に影響しなくなりました

2025-09-01

v1.8.11

New psycopg_pool モジュールのトレース機能を追加

Fixed sqlAlchemy モジュールを修正

asyncmy ドライバのクエリパラメータが置換されなかった問題を修正

2025-08-22

v1.8.10

New psycopg モジュールのトレース機能を追加

New WHATAP_PYTHON_AGENT_PATH 環境変数を使用して、whatap_python 実行ファイルのパスを指定できるようになりました

この環境変数を設定しない場合は、WHATAP_HOME が代わりに使用されます

Fixed neo4j モジュール修正

DB 接続のタイミングが正しく収集されない問題を修正

2025-08-12

v1.8.9

New sqlite3 モジュールのトレース機能を追加

Fixed DB Connection が重複表示される問題を修正

DB クエリのみを実行しても、Step に DB Connection Step が表示される現象を修正

2025-08-04

v1.8.8

New httpx モジュールのトレース機能を追加

New openai モジュールのトレース機能を追加

trace_llm_log_enabled Boolean
デフォルト: false

true に設定すると、OpenAI API のログを監視してトレースを行います

2025-07-29

v1.8.7

New whatap_code_start オプションを追加 Boolean デフォルト: false

true に設定すると、sitecustomize.py 内で import whatap の後に whatap.agent() を実行することで、whatap-start-agent コマンドなしで、通常のPython実行コマンドのみでエージェントを起動できます。

Fixed open_file_descriptor_enabled オプションを修正 Boolean

false に設定すると、ファイルディスクリプタを追跡するスレッドも無効になります。

2025-07-15

v1.8.6

New URL を正規化した場合、元の URL を step に表示するオプションを追加

step_origin_url_enabled Boolean
既定値 false

New standalone Python プロセスのトレースオプションを追加

standalone_enabled Boolean
既定値 false
standalone_type String

single-transaction: デフォルト、1 トランザクションとしてモニタリング

multiple-transaction: モジュール・クラス・メソッド単位でトランザクションを指定可能
standalone_transaction_patterns String

デフォルトなし

形式: [MODULE]:[CLASS].[FUNC] または [MODULE]:[FUNC]

例: myPackage:MyClass.__init__, myPackage:my_function

New Neo4j ドライバモジュールのトレース機能を追加（v5.0 以上）

Fixed URL を正規化した場合、レコードサマリーで元の URL が表示されない問題を修正

2025-06-18

v1.8.5

New whatap.conf にメトリクスカテゴリ app_context_stat 関連のオプションを追加

app_context_enabled Boolean

既定値 false

true に設定すると、app_context_stat の収集機能が全体的に有効になります
app_context_parser

default: デフォルトパーサー（最初のパスセグメントを抽出）

prefix: 接頭辞マッチングパーサー（最も柔軟）

match: 完全一致パーサー（正確に一致するもののみ）
app_context_parser_reset Number
既定値
0

パーサーの内部キャッシュと設定を強制的にリセットするカウンター
app_context_path_depth Number
既定値
1

URL から抽出するパスセグメントの深さを指定（default パーサーのみ使用）
app_context_path_set String

既定値なし

監視対象のパスとその名前を定義するマッピング設定（カンマ , 区切り）

例: name1@url1,name2@url2,url3,name4@url4

2025-06-09

v1.8.4

Fixed fastAPI 呼び出し時に StreamingResponse が適用されていなかった問題を修正

2025-05-19

v1.8.3

New Odooフレームワーク(v16,v17)追跡機能を追加

Fixed SQLAlchemy関連エラーを修正

現在追跡中のDBドライバーと衝突してクエリーメッセージが重複表示されていた問題を修正
クエリ文にパラメータがバインドされていなかった問題を修正
DB接続時にuser値を入力しない場合、エラーが発生した問題を修正

Fixed Flask例外オブジェクト以外の例外オブジェクトを正常に処理できなかった問題を修正

2025-04-28

v1.8.2

Fixed ignore_whatap_stdoutオプションの未適用現象を修正

2025-04-23

v1.8.1

New starlette基盤のWebSocket送信追跡機能を追加

2025-03-31

v1.7.9

New HTTPトランザクションの正常信号(Status: 2xx、3xx)収集及び表示機能を追加

2025-03-24

v1.7.8

New HTTPトランザクションのリクエストMethod収集及び表示機能を追加

New HTTPトランザクションエラー発生時、HTTP Status収集及び表示機能を追加

2025-03-11

v1.7.7

New whatap.confで、WhaTapモジュールのログ出力制御オプションを追加

ignore_whatap_stdout Boolean

既定値false

trueに設定すると、WhaTap Pythonエージェントモジュールで発生するすべての標準出力ログを非活性化します。

New whatap.confで、WhaTapモジュールのログ出力制御オプションを追加

ignore_whatap_stdout Boolean

既定値false

trueに設定すると、WhaTap Pythonエージェントモジュールで発生するすべての標準出力ログを非活性化します。

2025-03-04

v1.7.6

New ロギングモジュール(logging、loguru) モニタリングでmtid値の追跡を追加

trace_logging_mtid_enabled Boolean

既定値false

trace_logging_enabled値がtrueの場合は活性化されmtid値が存在する場合はログに出力します。
trace_loguru_mtid_enabled Boolean

既定値false

trace_loguru_enabled値がtrueの場合は活性化されmtid値が存在する場合はログに出力します。

2025-02-17

v1.7.5

New WHATAP_HOME環境変数を設定しない場合、whatap.confファイルを自動的に探索して設定するように追加

2025-01-20

v1.7.4

Fixed Redisで特定の関数のみモニタリングするように変更：GET、SET、DEL、HSET、HGET

Fixed SQLプロファイル転送エラーの修正

Fixed RabbitMQモニタリングモジュール(pika)のエラー修正

pika原本関数の実行エラーを修正しました。

2024-12-19

v1.7.3

New SQLパッチ件数の収集を追加

Fixed FastAPIの使用時にマルチトランザクションが収集されない問題を修正

2024-11-12

v1.7.2

Newプロセス別PID 基盤のopen file descriptorの使用量を収集する機能を追加

2024-10-10

v1.7.1

Fixed database connection closeでエラーが発生した時にプロファイルの収集が中断される問題を修正

2024-09-24

v1.7.0

Fixed fastapi 0.115.0バージョンのトランザクション収集エラーの修正

2024-09-05

v1.6.10

New DjangoフレームワークでASGIをサポート

DjangoでUvicorn対応のためのサポートロジックを追加しました。
非同期作業でローカルスレッドを使用する時に発生する可能性のあるデータ侵害の問題を解決するために、コンテキストを維持するロジックを追加しました。

2024-09-03

v1.6.9

New oracle-clientモジュールの追跡(tracing) 機能を追加

オラクルクライアント(oracle-client)でconnectメソッドとConnection.closeメソッドに計測機能を適用して、データベースの接続と終了時点を追跡できる機能を追加しました。

2024-08-27

v1.6.8

Newgraphql-coreの様々なバージョンに対応するためにモジュールトレーシング機能を追加

**graphql-core 3.x+**バージョンではgraphql.execution.executeモジュールに計測を追加し、graphql-core 2.xバージョンではgraphql.execution.executorモジュールをサポートします。

Changed trace_module_definition.pyファイルを修正してgraphql-coreバージョンに応じて適切なモジュール計測が行われるように変更(最新バージョンと旧バージョンの両方に対応)

2024-08-21

v1.6.7

FixedTraceContextをキューに入れる前に深いコピー(deep copy)してデータが上書きされないように防止

2024-06-07

v1.6.6

Fixed FastAPI - remoteIP収集時に発生するバグを修正

2024-05-31

v1.6.5

Fixed Python 3.6 gevent使用時、トランザクションの終了漏れを修正

2024-05-14

v1.6.4

FixedKubernetes環境コンテナでcontainerIDを探すパーシングロジックを修正

2024-04-17

v1.6.3

FixedKubernetes環境コンテナでcontainerIDを探すパーシングロジックを修正

2024-03-29

v1.6.2

Feature exit_with_parent_process_enabledオプションを追加

exit_with_parent_process_enabled bool

既定値false

PythonエージェントWHATAP_HOME経路にあるwhatap.confファイルを使用して、そのオプションの値を設定してください。モニタリング対象Pythonプロセス終了時whatap_pythonプロセスの終了可否を設定できます。オプションの値をtrueで設定する場合、モニタリング対象のアプリケーション終了時にwhatap_pythonプロセスが一緒に終了します。最大1分かかります。

2024-03-20

v1.6.1

Fixed whatap-hook.logの繰り返しログ呼び出しの問題を修正

2024-03-13

v1.6.0

Fixed FastAPIでremote hostに関する情報が見つからないとエージェントが動作しない現象を修正

2024-03-11

v1.5.9

Fixedエージェントオプション設定時に改行なしで入力される現象を修正

2024-02-18

v1.5.8

Fixed Frappe Applicationのuser(接続者数に関する) 重複集計エラーを修正

2024-02-02

v1.5.6

Changed Superset対応

2024-02-01

v1.5.5

Fixed Frappeフレームワークで開発されたアプリケーションでデータベース接続情報にインスタンス(DB) 情報がない場合、性能収集エラーが発生する現象を改善

2024-01-09

v1.5.4

Fixed Pythonエージェントv1.4.9バージョン以降で一部のPythonバージョンのモジュール依存性収集エラーを修正

Python 3.6
Python 3.7

2024-01-05

v1.5.3

Fixed Pythonエージェントv1.4.9バージョン以降で、gunicornトランザクション収集エラーを修正

2024-01-03

v1.5.2

Fixed INJECTION方式のログ収集コードエラーを修正