.NET Agent Release Notes

2026

2026-11-02

v2.5.7

Fixed OSが異常なCPU累積値を返した後、エージェントを再起動するまでホストリソースのメトリクスが収集されなかった問題を修正しました。

2026-08-03

v2.5.6

Fixed IL再作成時、複数の分岐が共有する戻り地点で戻り値の保存命令がスキップされ、無効なILが生成されていたバグを修正しました。

2026-07-10

v2.5.5

New SqlDataAdapter.Fill 計装を追加

New SqlDataAdapter.Update 計装を追加

• 件数は実際に反映された行数(RecordsAffected)として記録し、既存のExecuteNonQueryフックと重複しません。

Changed ログファイル名を{日付}-{PID}.logから{日付}-{GUID}.logに変更

Fixed ネイティブプロファイラーの安定性を改善

Fixed ロギングロジックの安定性を改善

2026-06-09

v2.5.4

Feature HTTP レスポンスステータスコードの収集を追加

• すべてのトランザクションのレスポンスコード(2xx-5xx)を表示

2026-04-21

v2.5.3

New trace_user_using_ip Boolean オプション追加

• デフォルト値 true
• false に設定すると、クッキーベースのトラッキングを有効化

Fixed IIS AppPoolIdentity Global Mutex 権限エラー

• MutexSecurityでEveryoneにFullControlを付与し、低権限プロセスでもGlobal Mutexの作成・取得が可能

2026-02-24

v2.5.2

New Linux OS サポート

• Ubuntu 20.04 以降

Feature DB Step で Commit、Rollback の追跡を追加

Fixed .NET Framework 未提供のアセンブリのリダイレクトによるロード失敗を修正

2026-01-26

v2.5.1

Fixed ドメインデータ収集時に、非標準ポートもあわせて収集されるよう修正しました

2026-01-13

v2.5.0

New .NET Core 9.0 をサポート

Feature MongoDB（MongoDB.Driver.Core）モニタリング対応を追加

Feature モジュール依存関係確認機能を追加

Feature Web フレームワーク対応

• WCF
• WebService
• Web API

Changed 安定性および拡張性を確保するためのエージェント内部アーキテクチャのリファクタリング

Fixed AppDomain リロード時にメモリリークが発生していた問題を修正

2025

2025-07-22

v2.4.4

Fixed 循環呼び出し発生時に、トランザクションが正常に終了していても Lost Connection と表示される問題を修正しました。

2025-06-25

v2.4.3

New メトリクス照会で app_context_stat カテゴリを追加

• app_context_enabled Boolean

  • 既定値：false

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

• app_context_parser

  • default, prefix, match のいずれかを使用

  • 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

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

• step_origin_url_enabled Boolean

  • 既定値：false

  • URLを正規化した場合でも、元のURLがstepで表示されます。

Fixed URLを正規化した場合に、レコード要約で元のURLが表示されなかった問題を修正

2025-04-26

v2.4.2

Newインストールされるサーバーの.NETランタイムバージョンに従って自動的にバージョンが選択されるように修正

2025-03-21

v2.4.1

New Added the ISAPI filter-based transaction tracing feature.

2025-03-04

v2.4.0

New ISAPIフィルターを活用してWCF、ASP、CGI、ISAPIなどのトランザクションモニタリングに対応

2025-01-15

v2.3.8

New LINQ to SQL(System.Data.Linq)モニタリングの支援

Newモニタリングで除外するsection名を設定できるエージェントオプションを追加

2025-01-02

v2.3.7

New .NET CoreにMySQLドライバー対応を追加

ADO.NETを通じたMySQLのドライバーだけでなくMySQL Connector/Netのような直接的なMySQLのデータプロバイダーにも対応します。

Fixed .NET CoreでクライアントのIPアドレスが0.0.0.0と表示されるエラーを修正

2024

2024-11-25

v2.3.6

Newエージェントオプションの追加

webservice_method_prefix_realtime Boolean

Changed webservice_method_prefixオプションで収集するトランザクション処理方式の変更

• 再帰的な呼び出しによるエラーの発生を防止するために、トランザクション内で収集される他のwebservice_method_prefixメソッドは無視するように修正

• 完了していないトランザクションは無視するように修正

Changed個別にダウンロードを提供していた.NET Frameworkと.NET Core環境のインストーラの併合

2024-11-04

v2.3.5

New .NET CoreでUser Transaction機能を追加

• 次の例を参照してください。 接続者数のモニタリングが必要ない場合は、ユーザー識別項目に空の文字列を入力します。

  using System;
  
  class Program
  {
      static void Main(string[] args)
      {
          //トレース開始(ドメイン、Url、ユーザー識別)
          WhatapDiagnostic.TraceStart("127.0.0.1", "/api/test", "user123");
  
          try
          {
              //ステップ開始
              WhatapDiagnostic.StepStart("test Step");
  
              //ユーザーコード領域
              //ステップ終了
              WhatapDiagnostic.StepStop();
          }
          catch (Exception ex)
          {
              //例外発生時の診断情報に例外を記録
              WhatapDiagnostic.SetExceptionForTrace(ex);
          }
          finally
          {
              //トレース終了
              WhatapDiagnostic.TraceStop();
          }
      }
  }
  
  ノート

  .NET Frameworkは準備中です。

• WhatapDiagnosticコードは次の通りです。 形式に関係なくdiagnosticSource.Write(…)内容だけ正確であればいいです。

  using System.Diagnostics;å
  
  public static class WhatapDiagnostic
  {
      private static readonly DiagnosticSource diagnosticSource = new DiagnosticListener("WhatapDiagnosticListener");
  
      public static void TraceStart(string host, string url, string userId)
      {
          if (diagnosticSource.IsEnabled("Whatap.Diagnostic.Trace.Start"))
          {
              diagnosticSource.Write("Whatap.Diagnostic.Trace.Start", new { Host = host, Url = url, UserId = userId });
              Console.WriteLine("Whatap.Diagnostic.Trace.Start!");
          }
      }
  
      public static void SetExceptionForTrace(Exception exception)
      {
          if (diagnosticSource.IsEnabled("Whatap.Diagnostic.Trace.Exception"))
          {
              diagnosticSource.Write("Whatap.Diagnostic.Trace.Exception", exception);
          }
      }
  
      public static void StepStart(string message)
      {
          diagnosticSource.Write("Whatap.Diagnostic.Step.Start", message);
      }
  
      public static void StepStop()
      {
          diagnosticSource.Write("Whatap.Diagnostic.Step.Stop", new { });
      }
  
      public static void TraceStop()
      {
          if (diagnosticSource.IsEnabled("Whatap.Diagnostic.Trace.Stop"))
          {
              diagnosticSource.Write("Whatap.Diagnostic.Trace.Stop", new { });
          }
      }
  
      public static void UserLog(string message)
      {
          if (diagnosticSource.IsEnabled("Whatap.Diagnostic.UserLog"))
          {
              diagnosticSource.Write("Whatap.Diagnostic.UserLog", message);
          }
      }
  }

New Method hookのサポート

• メソッド名を指定してモニタリングできます。 次の設定を参照してください。

  hook_methods_enabled=true
  hook_methods_prefix=System.Net.Http.HttpClient., System.Net.WebRequest., System.Data., System.Net.Http.
  hook_methods_ignores=get,set

  • hook_methods_enabledオプションの値をtrueに設定します。

  • hook_methods_prefixオプションの値は、先頭の一致時にモニタリングの対象となります。 コンマ(,)で分離します。

  • hook_methods_ignoreオプションの値は、先頭の一致時にモニタリング対象から除外されます。

New WebClient.DownloadStringメソッドモニタリングサポートの追加

Changed response bodyのオプション処理

• 文字列エンコードに関連するエラーが発見され、デフォルト設定の代わりに有効オプションが追加されました。

• profile_http_response_body_enabledオプションの既定値はfalseです。

Changed .NET FrameworkバージョンのRedis出力フォーマットの変更

• .Net Coreの出力方式と統一して飾り効果が適用されました。

Deprecate trace_db_command_methodsオプションの削除

• モニタリング対象の自動処理により、現在そのオプションは必要ありません。

• モニタリング対象から除外されたメソッドは、Method hookを利用して処理できます。

  hook_methods_enabled=true
  hook_methods_prefix=System.Data., ...

2024-10-02

v2.3.4

Fixed最近追加されたモニタリング対象の中でCancellationToken関連メソッドを一時削除

New .NET Coreでexpand_transaction_level設定サポートの追加

• expand_transaction_level Boolean

  既定値 false

  そのオプションをtrueに設定すると、トランザクションの外部から発生するSQLおよびHTTPの呼び出しをトランザクションと見なし、ヒットマップに表示します。

• expand_transaction_basetime Int

  既定値 1000ms (1秒)

  expand_transaction_level オプションが trueに設定されている場合、指定した時間よりも応答時間のかかるリクエストのみがデータを収集します。 毎秒最大100件のデータを収集します。 最小値は 100 msで0.1秒です。

NewDesktop applicationモニタリング対応を追加

• expand_transaction_levelオプションの値をtrueに設定します。

• アプリケーションを実行する前に、次のコマンドをプロンプトに入力します。

  SET COR_PROFILER={D76F1D76-A9E0-4C87-874F-C0AD93D4229B}
  SET COR_ENABLE_PROFILING=1
  
  SET CORECLR_PROFILER={21CAE18A-4E44-4578-83FD-0576AAA47E68}
  SET CORECLR_ENABLE_PROFILING=1
  SET DOTNET_STARTUP_HOOKS=C:\Program Files\WhaTap .NET\core\Whatap.Startup.NetCore.dll
  
  SET WHATAP_TRACE_IIS_ONLY=0
  SET EXPAND_TRANSACTION_LEVEL=1
  SET EXPAND_TRANSACTION_BASETIME=100

• コマンドの実行後、対象アプリケーションを実行します。

2024-09-25

v2.3.3

New .NET CoreからSQLパラメータモニタリング対応を追加

New .NET CoreからStored Procedureモニタリング対応を追加

New System.Net.Http.HttpClient.SendAsyncモニタリング対応を追加

Fixed .NET Coreバージョンのエージェントをインストールした後、削除しない状態で、.NET Frameworkバージョンを追加インストールするとアクティブスタックが収集されないバグを修正

2024-09-05

v2.3.2

Newランザクションの収集から除外するURL形式(suffix)を設定できるエージェントオプションを追加

trace_ignore_url_suffix String

FixedParameterized Queryの追跡機能を追加

FixedREST APIトランザクションのステータスコード(status code) 表示で発生するエラーを修正

FixedSystem.Data.Common.DbCommandの関連メソッドの中でモニタリングに含まれていなかったメソッドを追加

次の非同期メソッドの中で、オーバーロードされたメソッドの一部が漏れて追加されました。

2024-08-26

v2.3.1

Newトランザクション外部で発生するトレース情報の収集機能を追加

• expand_transaction_level Boolean

  既定値false

  オプション値をtrueに設定すると、トランザクションの外部から発生するSQL、HTTPの呼び出しをトランザクションとして扱い、ヒットマップに表示します。

• expand_transaction_basetime Int

  既定値1000(1秒)/最小値100(0.1秒)

  expand_transaction_levelオプションがtrueである場合、設定した時間より応答時間が長くかかる場合にのみデータを収集します。 毎秒最大100件まで収集します。

New DB接続情報の表示：データベースを使用するトランザクションは、データベース接続情報を表示する機能を追加

Changedエラーでない場合でもトランザクションのステータスコードを表示するように修正

2024-07-31

v2.3.0

Fixed v2.2.9でSQL、HTTPモニタリングが漏れる問題を修正

Fixedパケット処理が遅延した時にUDPパケットが変調される問題を改善

2024-07-05

v2.2.9

Featureマルチトランザクションのモニタリングに対応: WhaTapモニタリングプラットフォームのプロジェクトとして登録されたアプリケーションサービス間の呼び出しを追跡できます。

2024-06-19

v2.2.8

New .NET 6、7、8バージョンの追加対応

• ASP.NET core対応

• HTTP Call、Redis、WCF client、ユーザーログ、Active Stack、SQL対応

• 別のインストールリンクでダウンロードします。 whatap_dotnet_core.exe

Changed trace_http_client_ip_header_keyオプションの既定値をX-Forwarded-Forに変更

2024-06-10

v2.2.7

Changed対応環境の分析ツール(WhaTapDotnetScan.exe)改善

• ドットネットが設置されていない環境でも実行できるように改善

• 旧バージョンのドットネットランタイムを使用したり、ドットネットランタイムがインストールされていない場合に発生するエラーを修正

Fixed処理許容量を超えたトランザクションを除去する過程で、開始時点だけが残り、終了時点が削除されるバグを修正

2024-05-24

v2.2.6

Featureエージェントオプションの追加

• trace_ignore_url_set String

  トランザクションの追跡から除外するURLを設定します。 2つ以上の値を設定するには、コンマ (,)を区切り文字として利用します。

• trace_ignore_url_prefix String

  トランザクション収集の例外URL prefixを設定します。 設定した値と前の部分が一致するurlは、トランザクション性能を収集しません。 2つ以上の値を設定するには、コンマ (,)を区切り文字として利用します。

Changed System.Data.Common.DbCommandモニタリング可否をエージェント設定オプションとして選択するように変更

• 一部の顧客の場合、古いアセンブリの影響でエラーが発生する現象が見つかりました。 エラーを再現する完璧な原因が見つからなかったため、モニタリングの対象から除外しました。

• モニタリングの対象に追加するには、次のエージェントオプションを設定してIISを再起動します。

  Tips

  trace_db_command_methods String

  モニタリングするメソッド名を入力します。 2つ以上の値を設定するには、コンマ (,)を区切り文字として利用します。 すべてのメソッドをモニタリングするには、以下のように適用します。

  whatap.conf

  trace_db_command_methods=ExecuteReader, ExecuteReaderAsync, ExecuteNonQuery, ExecuteNonQueryAsync, ExecuteScalar, ExecuteScalarAsync

2024-05-08

v2.2.5

FixedサーバーのCPU性能に余裕がない時、モニタリングメッセージが遅延して蓄積され、ボトルネックを加速する不具合を修正

2024-04-24

v2.2.3

Fixed Rest APIモニタリング中に特定条件でCPU使用率が増加するバグを修正

• 特定の顧客からCPU使用量が増加する問題が発生したため、該当バグを修正します。

• トラブルが発生しない顧客でも、エージェントをアップグレードすることをお勧めします。 性能向上に役立ちます。

2024-04-18

v2.2.2

New DataAdapter.Fill() メソッドモニタリングを追加

New WebFormモニタリングに対応、ページ移動イベントをトランザクションとして処理

Featureエージェントオプションtrace_http_client_ip_header_key追加、詳しい内容は、次の文書を参照してください。

Fixed IPアドレスの表示エラーで同時接続者が正しく表示されない現象を修正

Deprecatedエージェントがボディを読み込んでいる間に衝突が起こる可能性があるのでprofile_http_body_enabledオプションの対応を中止

2024-04-09

v2.2.1

Featureエージェントオプションの追加

• prepend_app_pool_name Boolean

  既定値false

  オプション値をtrueに設定すると、トランザクションのURLの前にアプリケーションのフルネームを表示します。

Changed古いバージョンの互換性を高めるためにインストールファイルを分離

• .NET 4.6.1バージョン以降のランタイムを使用する場合: whatap_dotnet.exe

• .NET 4.6.1バージョン未満のランタイムを使用するか、Windows Server 2012未満の場合: whatap_dotnet_450.exe

  ノート

  Windows Server 2008 R2から対応します。

Fixed webservice_method_enabledオプション：メソッドが重複して実行される場合にモニタリングされないバグを修正

Fixed32ビットドットネットランタイムでwhatap.confファイルが見つからない問題を修正

2024-03-30

v2.2.4

Featureバイトコードの処理プロセス性能を改善

Featureログの処理プロセス性能を改善

FeatureUDPパケットプロセス性能を改善

Feature ASP.NETMVCライブラリの処理プロセス性能を改善