本文へスキップ

インストールチェックリスト

.NET エージェントのインストール後に問題が発生した場合、状況に合った項目を確認して解決できます。

Windows​

サービス動作の確認​

WhaTap.NET サービスが正常に登録されており、動作（実行中）状態であるか確認してください。

管理者権限で services.msc コマンドを実行するか、コントロールパネルのサービスアイコンをダブルクリックして Services マネージャーを開いてください。

Windows Service マネージャー

WhaTap .NET サービスは収集したモニタリングデータを WhaTap サーバーに送信します。エージェント関連のログは C:\Program Files\WhaTap .NET\logs および C:\ProgramData\WhaTap\dotnet\logs パスで確認してください。

.NET エージェントのインストール後に問題が発生した場合は、次の項目を確認して問題を解決してください。問題が解決しない場合は support@whatap.io にお問い合わせください。またはサービス画面の右上にある カスタマーサポートアイコン ボタンをクリックすると表示されるチャット画面から追加サポートを受けることができます。

ノート

エージェントのログファイルの場所

メールまたはチャット画面からお問い合わせの際、エージェントのログファイルが必要になる場合があります。

  • C:\Program Files\WhaTap .NET\logs

  • C:\ProgramData\WhaTap（このパスが存在しない場合は無視してください。）

すべてのデータが収集されない場合​

すべてのウィジェットでデータが収集されない場合は、次の事項を確認してください。

  • エージェント設定用の whatap.conf ファイルにプロジェクトのアクセスキーと収集サーバー情報が正しく入力されているか確認してください。

  • 対象サーバーのファイアウォール設定を確認してください。アウトバウンド接続のために 6600 ポートが開放されている必要があります。

ヒットマップ情報が収集されない場合​

ヒットマップ情報が正常に収集されない場合は、ユーザーのアプリケーションの対応環境を確認してください。.NET アプリケーションモニタリングの対応環境については、こちらのドキュメント を参照してください。

サーバーの .NET バージョンが対応環境に該当していても、アプリケーションのバージョンが .NET Framework 4.5 以上でない場合は、モニタリング用のデータ収集が正常に動作しないことがあります。

対応範囲が確認できない場合、または対応対象の場合​

対象アプリケーションの web.config ファイルを support@whatap.io に送付してお問い合わせください。可能であれば、プロジェクトファイル（.csproj）も送付することをお勧めします。

システム環境変数の確認​

  1. sysdm.cpl コマンドを実行してシステムのプロパティウィンドウを開いてください。

  2. 詳細設定 > 環境変数をクリックして、システム環境変数が正しく登録されているか確認してください。

    Windows システム環境変数

  3. システム環境変数はエージェントのインストール時に自動的に登録されます。次の内容が登録されているか確認してください。

    • WHATAP_APP_TYPE = 7

      WhaTap サーバーと通信するエージェントの種類を示す固定値です。

    • WHATAP_DOTNET_HOME = C:\Program Files\WhaTap .NET

      WhaTap プログラムのホームパスです。

    • WHATAP_DOTNET_TRACE = 1

      モニタリングデータ収集機能を有効化します。

GAC の確認​

エージェントのインストール時に DLL ファイルが GAC に自動的に登録されます。C:\Windows\Microsoft.NET\assembly\GAC_MSIL パスで登録されたファイルを確認してください。

📄 Sigil
📄 Microsoft.Diagnostics.NETCore.Client
📄 Microsoft.Diagnostics.Runtime
📄 System.Diagnostics.DiagnosticSource
📄 System.Memory
📄 Whatap.Startup
📄 Whatap.Loader
📄 Whatap.Tracer
ノート

GAC の手動削除

エージェントをアンインストールしても、GAC に登録されたデータは自動的には削除されません。必要な場合は、C:\Windows\Microsoft.NET\assembly\GAC_MSIL パスから直接削除してください。

Linux​

環境変数の確認​

install.sh のインストールを通じて5つの環境変数が設定されます。

  • WHATAP_DOTNET_HOME = "/usr/whatap/agent/dotnet"
  • CORECLR_ENABLE_PROFILING = "1"
  • CORECLR_PROFILER = "{21CAE18A-4E44-4578-83FD-0576AAA47E68}"
  • CORECLR_PROFILER_PATH = "/usr/whatap/agent/dotnet/Whatap.ClrProfiler.so"
  • DOTNET_STARTUP_HOOKS = "/usr/whatap/agent/dotnet/Whatap.Startup.dll"

インストールファイルの確認​

インストール後、/usr/whatap/agent/dotnet パスにファイルが生成されます。

📄 Whatap.ClrProfiler.soネイティブ CLR プロファイラー
📄 whatap_dotnetGO モジュールデーモン実行ファイル
📄 Whatap.Tracer.dll.NET トレーサー
📄 Whatap.Loader.dll.NET ローダー
📄 Whatap.Startup.dll.NET Startup Hook
📄 whatap.confエージェント設定ファイル
📄 whatap.envsystemd 用環境変数ファイル
📄 VERSIONエージェントバージョン記載用ファイル
🗂️ logs/エージェントログディレクトリ
最終修正：