APMインサイト .NET トラブルシューティングガイド
作成日:2017年9月25日 | 更新日:2020年5月21日
- 1)使用するエージェントのバージョンについて
- 2)エージェントをインストールした後はどうすればよいですか?
- 3)エージェントが実際にアプリケーションプロセスを監視していることを確認するには?
- 4)エージェントがApplications Managerにメトリックを送信するのにどれくらい時間がかかりますか?
- 5)いつエージェントサービスを再起動する必要がありますか?
- 6)エージェントが正しくインストールされて実行されているかどうかを確認するにはどうすればよいですか?
- 7).NETエージェントのログはどこで確認できますか?
- 8)イベントビューアログに0x80070002 HRESULT が出ている。
- 9) エージェントが正しくインストールされていないか、エージェントが正しく起動していないか、起動中にエラーが表示されます。
- 10)データが適切に収集されていることを確認するにはどうすればよいですか?
- 11)Windowsサービスログに"500 Internal error"が表示される
- 12)「パイプラインが閉鎖されました」ログで例外が発生したらどうすればよいですか?
- 13)エージェントが適切にアンインストールできません。
- 14).NETエージェントのログレベルを変更するにはどうすればよいですか。
- 15)Windows Server 2003またはHRESULTにエージェントをインストールする手順中に、イベントログに0x8007007eが表示される
- 16)「設定の編集」ダイアログで、起動/保存中にエラーメッセージが表示されるのはなぜですか?
- 17)「アプリケーションフィルタ」タブにIISアプリケーションが表示されないのはなぜですか?
- 18) "Apm Insight keys"テキストボックスが無効になっているのはなぜですか?
- 19)アプリケーションフィルタタブの変更がIISに保存されないのはなぜですか?
- 20)選択の変更が再開時に保存されないのはなぜですか?
- 21)Windows Server 2003 / IIS 6.0でアプリケーションフィルタタブにアプリケーションが表示されないのはなぜですか?
1)使用するエージェントのバージョンについて
エージェントは、監視する必要があるアプリケーションに基づいて選択する必要があります。32ビットアプリケーションをIISで監視する場合は、32ビットエージェントをインストールします。
64ビットアプリケーションをIISで監視する場合は、64ビットエージェントをインストールします。
ただし、32ビットと64ビットの両方のエージェントを同じサーバーにインストールすることはできません。
2)エージェントをインストールした後はどうすればよいですか?
正しいエージェントをインストールしたら、監視するアプリケーションにいくつかのトランザクションを実行します。.NETプロファイラがCLRの初期化中にのみアプリケーションプロセスをフックするためです。エージェントはアプリケーションでトランザクションが行われたときにのみ動作します。
3)エージェントが実際にアプリケーションプロセスを監視していることを確認するには?
エージェントは、初期化中に.NetAgentNative ...ログファイルにログを作成します。ログがログフォルダに作成されるのは、エージェントがアプリケーションプロセスに正常にフックしている場合となります。
ファイル名.NetAgentNativeで始まるログファイルは、エージェントプロファイラのログファイルです。このログファイルが作成されている場合に、正常な動作をしているとこのログファイルは、トランザクションが完了した後にのみ作成されます。
4)エージェントがApplications Managerにメトリックを送信するのにどれくらい時間がかかりますか?
エージェントは、1分ごとにApplications Managerへメトリクスを送信します。
5)いつエージェントサービスを再起動する必要がありますか?
設定ダイアログの設定が変更した際に、エージェントサービスを再起動する必要があります。エージェントを最初にApplications Managerに接続すると、programData / dotnetagent /(x86またはx64)フォルダにapminsight.net.infoファイルが作成されます。この情報ファイルは、再起動後に削除する必要があります。また、再起動後、エージェントが再度プロセスをフックするためには、いくつかのトランザクションを実行する必要があります。
6)エージェントが正しくインストールされて実行されているかどうかを確認するにはどうすればよいですか?
インストール後、Windowsサービスの「ManageEngine .NET Agent x64またはx86」サービスを確認します。このサービスのステータスは「実行中」である必要があります。
ホストとApplications Managerの間の接続が確立されているかどうかを確認するには、Windowsサービスログに記録される "Connection Successful"情報メッセージを探します。
接続が成功するとAPM Insightでアプリケーションが表示されます。
7).NETエージェントのログはどこで確認できますか?
.NETエージェントのログは、共通のアプリケーションフォルダ(通常はVistaのC:ProgramData以降は隠しフォルダ)にのみ存在します。
64ビットOSの場合: DotNetAgentdAgentLogs
32ビットOSの場合: DotNetAgent AgentLogs
1.8.2からAPMInsight .NetAgentのバージョンでは、エージェントインストールにバンドルされているAPMInsight .NetAgent Health Monitorユーティリティを使用できます。
Health Monitorユーティリティを実行し、診断情報を収集します。(スタート - >プログラム - > ManageEngineDotnet Agent)
1.)サービスとプロセスが実行されているかどうかを確認します。
2.)エージェント側から必要なすべてのログを含むDiagnostics Zipファイルを作成します。
3.)このzipファイル内のイベントログエントリを取得することもできます。
8)イベントビューアログに0x80070002 HRESULT が出ている。
これは、プロファイラが正しく登録されていないことを意味します。
手動で登録するには:
- [管理者として実行]オプションを使用してコマンドプロンプトを開きます。
- regsvr32 "profilerのパス"と入力します(Profilerのdllパスは... Agent Installation PathDotNetAgentClrProfilerAgent.dll)
- "iisreset"と入力してIISをリセットする
その後すぐにWebトランザクションを実行します。リクエストが完了したら、アプリケーションログが利用可能かどうかを.Netエージェントログで確認します。それらが利用可能な場合、すぐにApplications Managerにデータが表示されます。
9) エージェントが正しくインストールされていないか、エージェントが正しく起動していないか、起動中にエラーが表示されます。
- ManageEngine .NET Agentサービスを停止します。
- "管理者として実行"オプションを使用してコマンドプロンプトを開きます。
- 「regsvr32 "プロファイラーのパス"」(Profilerのdllパスは、エージェントインストールフォルダ\PathDotNetAgentClrProfilerAgent.dll)を入力します。
- "iisreset"を入力し、IISを再起動します。
- ManageEngine .NET Agentサービスを開始します。
その後すぐにWebトランザクションを実行します。リクエストが完了したら、アプリケーションログが利用可能かどうかを.Netエージェントログで確認します。それらが利用可能な場合、すぐにApplications Managerにデータが表示されます。
10)データが適切に収集されていることを確認するにはどうすればよいですか?
エージェントのインストールが正常に完了したら、エージェントログが作成されているかどうかを確認します。
Webアプリケーションログは、1つ以上のトランザクションが実行された場合にのみ表示されます。ログが利用可能な場合は、Applications Managerの[APM Insight]タブを確認します。設定されたアプリケーション名が[概要]タブに表示されます。概要タブには、トランザクションのapdexスコアも表示されます。
11)Windowsサービスログに"500 Internal error"が表示される
「500内部エラー」は、エージェントのインスタンスIDが変更または削除されたために発生します。
これを修正するには、C:Programdata\dotnetagentdorx86\apminsight.net.infoから情報ファイルを削除してください。
サービスがApplications Managerに再接続するまで1分間待ちます。再接続すると、データが利用可能になるはずです。
12)「パイプラインが閉鎖されました」ログで例外が発生したらどうすればよいですか?
この例外が発生した場合は、ホストが停止しているか、障害状態であることを示します。エージェントを再起動する必要があります。
13)エージェントが適切にアンインストールできません。
インストーラがエージェントを適切にアンインストールしない場合は、管理者モードでコマンドプロンプトを開き、次のコマンドを貼り付けます。
msiexec -i {D6871C70-0C3B-4C39-BABC-946D399550D1} REINSTALL=ALL REINSTALLMODE=vomus for x64
msiexec -i {6C198BBF-CACA-4631-A5D3-5F44C92ACB3E} REINSTALL=ALL REINSTALLMODE=vomus for x86
これでエージェントがアンインストールされます。
14).NETエージェントのログレベルを変更するにはどうすればよいですか。
「ログレベル」コンボボックスで、ログレベルを「デバッグ」に変更します。
15)Windows Server 2003またはHRESULTにエージェントをインストールする手順中に、イベントログに0x8007007eが表示される
1. ClrProfilerAgent.dllをエージェントのインストールディレクトリからコピーします。(デフォルトではC:Program FilesManageEngineAPM Insight .NETAgent(x86)DotNetAgentClrProfilerAgent.dllです)
2.%SystemRoot%System32にdllを貼り付けます。
3. ClrProfilerAgent.dllの登録を解除します。コマンドプロンプトでDotNetAgentのインストールフォルダーに移動し、コマンドを入力します。DLLが未登録である旨のメッセージが表示されます。
regsvr32 -u ClrProfilerAgent.dll
4.以下のコマンドを入力して%SystemRoot%system32(エージェントdllをコピーした場所)に移動し、agent dllを登録します。dllにdllが登録されたというメッセージが表示されます。
regsvr32 ClrProfilerAgent.dll
5. アプリケーションのトランザクションを実行します。次に、ログフォルダを確認します。
ファイル名.NetAgentNative.w3wp.exe.796.logのようなログファイルを確認してください。
16)「設定の編集」ダイアログで、起動/保存中にエラーメッセージが表示されるのはなぜですか?
設定ダイアログには、次のディレクトリに対する読み取り/書き込み権限が必要です。
APM Insight .NETエージェントのインストールパスとすべてのサブディレクトリ
%WINDIR%ProgramDataDotnetAgentとすべてのサブディレクトリ
IISアプリケーションディレクトリとそれぞれの "web.config"ファイル
現在のユーザーがこれらすべてのディレクトリにアクセスできるかどうかを確認します。それでも問題が解決しない場合は、管理者としてダイアログを起動して(右クリック - >管理者として実行)、確認してください。
注:エラーが発生すると、エラーウィンドウにキャプチャされ、そのリンクは設定ダイアログの一番下に表示されます。
17)「アプリケーションフィルタ」タブにIISアプリケーションが表示されないのはなぜですか?
設定ダイアログには、IISアプリケーションの読み取り権限とそれぞれの "web.config"ファイルの読み取り/書き込みアクセス権が必要です。web.config、applicationHost.config、redirection.configファイルの現在のユーザーのアクセス許可の設定を確認してください。
ロード/セーブにエラーが発生すると、設定ウィンドウの下部に「エラーを表示するにはここをクリック」というリンクが表示されます。これをクリックすると、「構成の編集」ダイアログで見つかったすべてのエラーをリストするダイアログが表示されます。同じ情報がAgentLogsフォルダ(%WINDIR%ProgramDataDotNetAgentd)に記録されます。
18) "Apm Insight keys"テキストボックスが無効になっているのはなぜですか?
AppFilterタブの[APM Insightキー]テキストボックスは、次のシナリオでは無効になります。
・アプリケーションが監視対象として選択されていない
・APM Insight .NETエージェントWindowsサービスが実行されている場合。この場合、エージェントサービスを停止し、[構成の編集]ダイアログを再度開きます。
19)アプリケーションフィルタタブの変更がIISに保存されないのはなぜですか?
2つのアプリケーションのアプリケーション設定に競合がある場合に発生します。
例:2つのアプリケーションに同じ名前が付けられている場合
そのうちの1つが監視のために選択されている
もう1つが監視されていない場合 等
このような場合、監視のために選択されたアプリケーションが優先されます。また、FAQ#1に記載されているアクセス設定が正しく構成されていることを確認してください。
20)選択の変更が再開時に保存されないのはなぜですか?
上記のFAQ#19を参照してください。「Use ApmInsight keys」が選択されていない場合、すべてのルートアプリケーション(viz、sites /)にはドメイン名が「ROOT」となります。したがって、1つのルートアプリケーションが監視のために選択され、他のルートアプリケーションがスキップされても、すべてのルートアプリケーションが選択されたものとして表示されます。
21)Windows Server 2003 / IIS 6.0でアプリケーションフィルタタブにアプリケーションが表示されないのはなぜですか?
設定UIのApp Filtersを介して監視するWebアプリケーションのフィルタリングは、IIS 7.0以上で動作するアプリケーションでサポートされています。IIS 6.0でアプリケーションをフィルタ処理するには、上記の「Webアプリケーションを手動でフィルタする」を参照してください。