Azure Diagnostics のトラブルシューティング

[アーティクル]
10/15/2024

この記事では、Azure Diagnostics の使用に関連するトラブルシューティング情報について説明します。 Diagnostics の詳細については、Azure Diagnostics の概要に関する記事を参照してください。

論理コンポーネント

コンポーネントは次のとおりです。

Diagnostics プラグインランチャー (DiagnosticsPluginLauncher.exe): Diagnostics 拡張機能を起動します。エントリポイントプロセスとして機能します。
Diagnostics プラグイン (DiagnosticsPlugin.exe): 監視エージェントの有効期間を構成、起動、管理します。ランチャーによって起動されるメインプロセスです。
監視エージェント (MonAgent*.exe プロセス): 診断データを監視、収集、転送します。

ログ/アーティファクトのパス

以下は、いくつかの重要なログと成果物のパスです。この記事では、この情報を参照します。

Azure クラウドサービス

アーティファクト	Path
Azure Diagnostics 構成ファイル	%SystemDrive%\Packages\Plugins\Microsoft.Azure.Diagnostics.PaaSDiagnostics<バージョン>\Config.txt
ログファイル	C:\Logs\Plugins\Microsoft.Azure.Diagnostics.PaaSDiagnostics<バージョン>\
診断データのローカルストア	C:\Resources\Directory<クラウドサービスのデプロイ ID>.<ロール名>.DiagnosticStore\WAD0107\Tables
監視エージェント構成ファイル	C:\Resources\Directory<クラウドサービスのデプロイ ID>.<ロール名>.DiagnosticStore\WAD0107\Configuration\MaConfig.xml
Azure Diagnostics 拡張機能パッケージ	%SystemDrive%\Packages\Plugins\Microsoft.Azure.Diagnostics.PaaSDiagnostics<バージョン>
ログ収集ユーティリティのパス	%SystemDrive%\Packages\GuestAgent\
MonAgentHost ログファイル	C:\Resources\Directory<CloudServiceDeploymentID>.<RoleName>.DiagnosticStore\WAD0107\Configuration\MonAgentHost.<シーケンシャル番号>.log

仮想マシン

アーティファクト	Path
Azure Diagnostics 構成ファイル	C:\Packages\Plugins\Microsoft.Azure.Diagnostics.IaaSDiagnostics<バージョン>\RuntimeSettings
ログファイル	C:\WindowsAzure\Logs\Plugins\Microsoft.Azure.Diagnostics.IaaSDiagnostics<DiagnosticsVersion>\
診断データのローカルストア	C:\WindowsAzure\Logs\Plugins\Microsoft.Azure.Diagnostics.IaaSDiagnostics<診断のバージョン>\WAD0107\Tables
監視エージェント構成ファイル	C:\WindowsAzure\Logs\Plugins\Microsoft.Azure.Diagnostics.IaaSDiagnostics<診断のバージョン>\WAD0107\Configuration\MaConfig.xml
状態ファイル	C:\Packages\Plugins\Microsoft.Azure.Diagnostics.IaaSDiagnostics<バージョン>\Status
Azure Diagnostics 拡張機能パッケージ	C:\Packages\Plugins\Microsoft.Azure.Diagnostics.IaaSDiagnostics<診断のバージョン>
ログ収集ユーティリティのパス	C:\WindowsAzure\Logs\WaAppAgent.log
MonAgentHost ログファイル	C:\WindowsAzure\Logs\Plugins\Microsoft.Azure.Diagnostics.IaaSDiagnostics<DiagnosticsVersion>\WAD0107\Configuration\MonAgentHost.<シーケンシャル番号>.log

メトリックデータが Azure ポータルに表示されない

Diagnostics には、Azure portal に表示できるメトリックデータが用意されています。ポータルでのデータの表示に問題がある場合は、Diagnostics ストレージアカウントの WADMetrics\* テーブルを調べて、対応するメトリックレコードがそこにあるかどうかを確認し、リソースプロバイダー Microsoft.Insights を確実に登録します。

ここでは、テーブルの PartitionKey がリソース ID、仮想マシン、または仮想マシンスケールセットです。 RowKey はメトリック名です。パフォーマンスカウンター名とも呼ばれます。

リソース ID が間違っている場合は、[診断構成]>[メトリック]>[ResourceId] をチェックして、リソース ID が正しく設定されているかどうかを確認します。

特定のメトリックのデータがない場合は、 [診断構成]>、 [PerformanceCounter] で、メトリック (パフォーマンスカウンター) が含まれているかどうかを確認します。次のカウンターは、既定で有効になっています。

\Processor(_Total)% Processor Time
\Memory\Available Bytes
\ASP.NET Applications(Total)\Requests/Sec
\ASP.NET Applications(Total)\Errors Total/Sec
\ASP.NET\Requests Queued
\ASP.NET\Requests Rejected
\Processor(w3wp)% Processor Time
\Process(w3wp)\Private Bytes
\Process(WaIISHost)% Processor Time
\Process(WaIISHost)\Private Bytes
\Process(WaWorkerHost)% Processor Time
\Process(WaWorkerHost)\Private Bytes
\Memory\Page Faults/sec
.NET CLR Memory(Global)% Time in GC
\LogicalDisk(C:)\Disk Write Bytes/sec
\LogicalDisk(C:)\Disk Read Bytes/sec
\LogicalDisk(D:)\Disk Write Bytes/sec
\LogicalDisk(D:)\Disk Read Bytes/sec

構成は正しく設定されているがそれでもメトリックデータが表示されない場合、次の方針に沿って問題解決をお試しください。

Azure Diagnostics が起動しない

Azure Diagnostics が起動しない理由については、前述のログファイルの場所にある DiagnosticsPluginLauncher.log と DiagnosticsPlugin.log のファイルを参照してください。

これらのログで Monitoring Agent not reporting success after launch が示されている場合、MonAgentHost.exe の起動でエラーが発生したことを意味します。前の「仮想マシン」のセクションで MonAgentHost ログファイルに対して指定されている場所でそのログを調べます。

ログファイルの最後の行には、終了コードが含まれています。

DiagnosticsPluginLauncher.exe Information: 0 : [4/16/2016 6:24:15 AM] DiagnosticPlugin exited with code 0

終了コードが負の数の場合は、「参照」セクションにある終了コードの表を参照してください。

Diagnostics のデータが Azure Storage にログされない

データがまったく表示されないのか、一部だけ表示されるのかを確認します。

診断インフラストラクチャログ

Azure 診断では、あらゆるエラーが診断インフラストラクチャログに記録されます。 Diagnostics インフラストラクチャログの記録を有効にしていることを構成で確認してください。有効になっていれば、構成したストレージアカウントの DiagnosticInfrastructureLogsTable テーブルで、関連するエラーが表示されていないか確認できます。

データが何も表示されない

イベントデータがまったく表示されない最も一般的な理由は、ストレージアカウント情報が間違って定義されていることにあります。

解決方法:診断構成を修正し、診断を再インストールします。

ストレージアカウントが正しく構成されている場合、マシンにリモートアクセスし、DiagnosticsPlugin.exe と MonAgentCore.exe が実行されていることを確認します。実行されていない場合、「Azure Diagnostics が起動しない」のステップに従ってください。

プロセスが実行されている場合、「データがローカルでキャプチャされているか」に進み、そこの手順に従ってください。

それでも問題が解決しない場合は、次を試してください。

エージェントをアンインストールします。
ディレクトリ C:\WindowsAzure\Logs\Plugins\Microsoft.Azure.Diagnostics.IaaSDiagnostics を削除します。
エージェントをもう一度インストールします。

一部のデータが見つからない

全部ではないが一部のデータが表示される場合、データ収集や転送のパイプラインは正しく設定されています。以下、現象をさらに分類しています。これに基づいて問題を絞り込んでください。

収集は構成されているか

診断構成には、特定の型のデータを収集する指示が含まれています。構成を見直し、収集するように設定しているデータだけが調べられていることを確認してください。

ホストはデータを生成しているか

パフォーマンスカウンター: perfmon を開き、カウンターを確認します。
トレースログ: VM にリモートアクセスし、アプリケーションの構成ファイルに TextWriterTraceListener を追加します。テキストリスナーを設定するには、トレースリスナーの作成と初期化に関する記事を参照してください。 <trace> 要素が <trace autoflush="true"> になっていることを確認します。トレースログが生成されていない場合、トレースログが見つからない場合の詳細のセクションを参照してください。
Event Tracing for Windows (ETW) のトレース: VM にリモートアクセスし、PerfView ツールをインストールします。 PerfView で、 [ファイル]>[ユーザーコマンド]> の順に選択し、Listen etwprovder1> を実行します。必要に応じてさらに etwprovider2 以降に Listen コマンドを実行します。 Listen コマンドは大文字と小文字が区別され、コンマ区切りの一覧の ETW プロバイダー間にスペースを使用することはできません。コマンドを実行できない場合は、Perfview ツールの右下にある [ログ] を選択すると、実行しようとした内容とその結果を確認できます。入力が正しいとすれば、新しいウィンドウが開きます。数秒後に、ETW トレースが表示されます。
イベントログ:VM にリモートアクセスします。イベントビューアーが開いたら、イベントが存在することを確認します。

データはローカルでキャプチャされているか

次に、データがローカルでキャプチャされていることを確認します。データは、診断データのローカルストアの *.tsf ファイルにローカルに保存されます。ログは、種類ごとに異なる *.tsf ファイルに収集されます。名前は、Azure Storage のテーブル名に類似しています。

たとえば、パフォーマンスカウンターは PerformanceCountersTable.tsf で収集されます。イベントログは WindowsEventLogsTable.tsf で収集されます。「ローカルログの抽出」の手順に従って、ローカルの収集ファイルを開き、ファイルがディスク上で収集されていることを確認します。

ログがローカルで収集されておらず、ホストがデータを生成していることを確認済みの場合は、構成に問題がある可能性があります。構成を注意深く見直します。

MonitoringAgent MaConfig.xml に生成された構成も確認します。関連ログソースについて説明するセクションがあることを確認します。次に、Diagnostics の構成と監視エージェント構成の間の変換でそれが失われていないことを確認します。

データは転送されているか

ローカルでキャプチャされていることを確認済みのデータがストレージアカウントに表示されない場合、次のステップに従ってください。

正しいストレージアカウントを指定したことと、指定したストレージアカウントのキーがロールオーバーされていないことを確認します。 Azure Cloud Services では、ユーザーが useDevelopmentStorage=true を更新していない場合があります。
指定したストレージアカウントが正しいことを確認してください。コンポーネントによるパブリックストレージのエンドポイントへのアクセスがネットワーク制限で禁止されていないことを確認してください。そのための方法の 1 つとして、マシンにリモートアクセスし、同じストレージアカウントに何らかの書き込みを行います。
最後に、監視エージェントによって報告されたエラーを確認できます。監視エージェントは、診断データのローカルストアにある maeventtable.tsf にそのログを書き込みます。「ローカルログの抽出」セクションにある方法でこのファイルを開きます。ローカルファイルの読み込みやストレージへの書き込みで発生したエラーを示す errors がないか探してみてください。

ログのキャプチャとアーカイブ

サポートに問い合わせることを検討している場合、最初にマシンのログを収集するように求められることがあります。この作業を自分で行うことで時間を節約できます。ログコレクションユーティリティパスで CollectGuestLogs.exe ユーティリティを実行します。すべての関連 Azure ログを含む .zip ファイルが同じフォルダーに生成されます。

診断データテーブルが見つからない

ETW イベントを保持する Azure Storage 内のテーブルの名前には、次のコードを使います。

        if (String.IsNullOrEmpty(eventDestination)) {
            if (e == "DefaultEvents")
                tableName = "WADDefault" + MD5(provider);
            else
                tableName = "WADEvent" + MD5(provider) + eventId;
        }
        else
            tableName = "WAD" + eventDestination;

次に例を示します。

        <EtwEventSourceProviderConfiguration provider="prov1">
          <Event id="1" />
          <Event id="2" eventDestination="dest1" />
          <DefaultEvents />
        </EtwEventSourceProviderConfiguration>
        <EtwEventSourceProviderConfiguration provider="prov2">
          <DefaultEvents eventDestination="dest2" />
        </EtwEventSourceProviderConfiguration>

"EtwEventSourceProviderConfiguration": [
    {
        "provider": "prov1",
        "Event": [
            {
                "id": 1
            },
            {
                "id": 2,
                "eventDestination": "dest1"
            }
        ],
        "DefaultEvents": {
            "eventDestination": "DefaultEventDestination",
            "sinks": ""
        }
    },
    {
        "provider": "prov2",
        "DefaultEvents": {
            "eventDestination": "dest2"
        }
    }
]

このコードは 4 つのテーブルを生成します。

Event	テーブル名
provider="prov1" <Event id="1" />	WADEvent+MD5("prov1")+"1"
provider="prov1" <Event id="2" eventDestination="dest1" />	WADdest1
provider="prov1" <DefaultEvents />	WADDefault+MD5("prov1")
provider="prov2" <DefaultEvents eventDestination="dest2" />	WADdest2

References

次のリファレンスを参照してください

Diagnostics 拡張機能の構成を確認する

拡張機能の構成を確認する最も簡単な方法は、 Azure Resource Explorer に移動することです。次に、Diagnostics 拡張機能 (IaaSDiagnostics または PaaDiagnostics) がある仮想マシンまたはクラウドサービスに移動します。

または、マシンにリモートデスクトップ接続し、ログアーティファクトパスのセクションに記載されている Diagnostics 構成ファイルを確認します。

どちらの場合でも、Microsoft.Azure.Diagnostics と、xmlCfg または WadCfg フィールドを検索します。

仮想マシンで検索し、WadCfg フィールドが存在する場合、構成が JSON 形式であることを意味します。 xmlCfg フィールドが存在する場合、構成が XML であり、base64 でエンコードされていることを意味します。診断で読み込まれた XML を表示するには、これをデコードする必要があります。

クラウドサービスロールの場合、ディスクから構成を選択すると、データは base64 でエンコードされます。 Diagnostics で読み込まれた XML を表示するには、これをデコードする必要があります。

Azure Diagnostics プラグインの終了コード

プラグインにより、次の終了コードが返されます。

終了コード	説明
0	正常終了しました。
-1	一般的なエラー。
-2	rcf ファイルを読み込めませんでした。この内部エラーは、ゲストエージェントプラグインの起動ツールが VM 上で不正に手動で起動された場合にのみ発生します。
-3	Diagnostics 構成ファイルを読み込めません。解決方法:構成ファイルがスキーマ検証を渡さないことが原因です。スキーマに準拠する構成ファイルを使用してください。
-4	監視エージェント診断の別のインスタンスが既にローカルリソースディレクトリを使用しています。解決方法:LocalResourceDirectory に別の値を指定します。
-6	ゲストエージェントプラグインの起動ツールが、無効なコマンドラインを使用して Diagnostics を起動しようとしました。この内部エラーは、ゲストエージェントプラグインの起動ツールが VM 上で不正に手動で起動された場合にのみ発生します。
-10	Diagnostics プラグインがハンドルされない例外で終了しました。
-11	ゲストエージェントが、監視エージェントの起動と監視を処理するプロセスを作成できませんでした。解決方法:新しいプロセスを起動するのに十分なシステムリソースを使用できることを確認します。
-101	Diagnostics プラグインを呼び出すときの引数が無効です。この内部エラーは、ゲストエージェントプラグインの起動ツールが VM 上で不正に手動で起動された場合にのみ発生します。
-102	プラグインプロセスを初期化できません。解決方法:新しいプロセスを起動するのに十分なシステムリソースを使用できることを確認します。
-103	プラグインプロセスを初期化できません。具体的にはロガーオブジェクトを作成できません。解決方法:新しいプロセスを起動するのに十分なシステムリソースを使用できることを確認します。
-104	ゲストエージェントが指定した rcf ファイルを読み込むことができません。この内部エラーは、ゲストエージェントプラグインの起動ツールが VM 上で不正に手動で起動された場合にのみ発生します。
-105	Diagnostics プラグインが Diagnostics 構成ファイルを開くことができません。この内部エラーは、Diagnostics プラグインが VM 上で不正に手動で起動された場合にのみ発生します。
-106	Diagnostics 構成ファイルを読み取れません。構成ファイルがスキーマ検証を渡さないことが原因です。解決方法:スキーマに準拠する構成ファイルを指定してください。詳細については、「Diagnostics 拡張機能の構成を確認する」を参照してください。
-107	監視エージェントへのリソースディレクトリのパスが無効です。この内部エラーは、監視エージェントが VM 上で不正に手動で起動された場合にのみ発生します。
-108	診断構成ファイルを監視エージェント構成ファイルに変換できません。この内部エラーは、Diagnostics プラグインが無効な構成ファイルを使用して手動で起動された場合にのみ発生します。
-110	一般的な診断構成エラー。この内部エラーは、Diagnostics プラグインが無効な構成ファイルを使用して手動で起動された場合にのみ発生します。
-111	監視エージェントを開始できません。解決方法:十分なシステムリソースを使用できることを確認します。
-112	一般的なエラー。

ローカルログの抽出

監視エージェントは、ログとアーティファクトを .tsf ファイルとして収集します。 .tsf ファイルは読み取り可能ではありませんが、次の方法で .csv に変換できます。

<Azure diagnostics extension package>\Monitor\x64\table2csv.exe <relevantLogFile>.tsf

対応する .tsf ファイルと同じパスに新しいファイル <relevantLogFile>.csv が作成されます。

Note

必要なのは、メインの .tsf ファイル (PerformanceCountersTable.tsf など) に対してこのユーティリティを実行することのみです。付随するファイル (PerformanceCountersTables_\*\*001.tsf、PerformanceCountersTables_\*\*002.tsf など) は自動的に処理されます。

トレースログが見つからない場合 (詳細)

Note

以下の情報は、サービスとしてのインフラストラクチャ (IaaS) VM で実行されているアプリケーションで DiagnosticsMonitorTraceListener を構成した場合を除き、主に Azure Cloud Services に当てはまります。

DiagnosticMonitorTraceListener が web.config または app.config で構成されていることを確認します。これは既定でクラウドサービスプロジェクトで構成されます。ただし、ユーザーがこれをコメントアウトすることもあります。その場合、Diagnostics でトレースステートメントが収集されることはありません。
ログが OnStart メソッドまたは Run メソッドから書き込まれていない場合は、DiagnosticMonitorTraceListener が app.config に含まれていることを確認します。既定では、これは web.config にありますが、w3wp.exe 内で実行されているコードにのみ適用されます。そのため、WaIISHost.exe で実行されているトレースをキャプチャするために app.config で必要になります。
Diagnostics.Debug.WriteXXX ではなく Diagnostics.Trace.TraceXXX を使用していることを確認します。デバッグステートメントはリリースビルドから削除されます。
コンパイルしたコードに Diagnostics.Trace 行があることを確認します。 Reflector、ildasm、または ILSpy を使用して確認してください。条件付きコンパイルシンボルである TRACE を使用しない限り、Diagnostics.Trace コマンドはコンパイルしたバイナリから削除されます。これは MSBuild でプロジェクトを構築するときに発生する一般的な問題です。

既知の問題と軽減策

次の既知の問題には軽減策があります。

.NET 4.5 の依存関係

Windows の Azure Diagnostics 拡張機能は .NET 4.5 framework 以降にランタイムが依存します。このドキュメントの作成時点では、Azure Cloud Services 用にプロビジョニングされたすべてのマシンと Azure VM に基づくすべての公式イメージに .NET 4.5 以降がインストールされています。

.NET 4.5 以降がないマシンで Windows の Azure Diagnostics 拡張機能を実行する状況が発生することも考えられます。古いイメージやスナップショットからマシンを作成するときや、カスタムディスクを利用する状況です。

この問題は通常、DiagnosticsPluginLauncher.exe を実行すると、終了コード 255 としてマニフェストされます。次のハンドルされない例外が原因でエラーが発生します:

System.IO.FileLoadException: Could not load file or assembly 'System.Threading.Tasks, Version=1.5.11.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a' or one of its dependencies

対応策: .NET 4.5 以降をマシンにインストールします。

パフォーマンスカウンターのデータがストレージでは使用できるが、ポータルに表示されない

既定では、VM のポータルに特定のパフォーマンスカウンターが表示されます。パフォーマンスカウンターは表示されないが、データが生成されていることはわかっている (データがストレージで使用できるため) 場合、以下を確認してください。

ストレージ内のデータのカウンター名が英語であるかどうか。カウンターの名前が英語でない場合、ポータルのメトリックグラフは名前を認識できません。
- 対応策:システムアカウント用に、マシンの言語を英語に変更します。 [コントロールパネル]>[地域と言語]>[管理]>[設定のコピー] の順に選択します。次に、[ようこそ画面とシステムアカウント] の選択を解除し、カスタム言語がシステムアカウントに適用されないようにします。
パフォーマンスカウンター名にワイルドカード (*) を使用している場合、パフォーマンスカウンターが Azure Storage シンクに送られるときに、構成済みおよび収集済みのカウンターをポータルが関連付けることができません。
- 軽減策: ワイルドカード (*) を使用でき、ポータルを展開できることを確認するために、パフォーマンスカウンターを "Azure Monitor" シンクにルーティングします。

次の方法で共有

Azure Diagnostics のトラブルシューティング

論理コンポーネント

ログ/アーティファクトのパス

Azure クラウドサービス

仮想マシン

メトリックデータが Azure ポータルに表示されない

Azure Diagnostics が起動しない

Diagnostics のデータが Azure Storage にログされない

診断インフラストラクチャログ

データが何も表示されない

一部のデータが見つからない

収集は構成されているか

ホストはデータを生成しているか

データはローカルでキャプチャされているか

データは転送されているか

ログのキャプチャとアーカイブ

診断データテーブルが見つからない

References

Diagnostics 拡張機能の構成を確認する

Azure Diagnostics プラグインの終了コード

ローカルログの抽出

トレースログが見つからない場合 (詳細)

既知の問題と軽減策

.NET 4.5 の依存関係

パフォーマンスカウンターのデータがストレージでは使用できるが、ポータルに表示されない

フィードバック

その他のリソース

次の方法で共有

Azure Diagnostics のトラブルシューティング

論理コンポーネント

ログ/アーティファクトのパス

Azure クラウド サービス

仮想マシン

メトリック データが Azure ポータルに表示されない

Azure Diagnostics が起動しない

Diagnostics のデータが Azure Storage にログされない

診断インフラストラクチャ ログ

データが何も表示されない

一部のデータが見つからない

収集は構成されているか

ホストはデータを生成しているか

データはローカルでキャプチャされているか

データは転送されているか

ログのキャプチャとアーカイブ

診断データ テーブルが見つからない

References

Diagnostics 拡張機能の構成を確認する

Azure Diagnostics プラグインの終了コード

ローカル ログの抽出

トレース ログが見つからない場合 (詳細)

既知の問題と軽減策

.NET 4.5 の依存関係

パフォーマンス カウンターのデータがストレージでは使用できるが、ポータルに表示されない

フィードバック

その他のリソース

Azure クラウドサービス

メトリックデータが Azure ポータルに表示されない

診断インフラストラクチャログ

診断データテーブルが見つからない

ローカルログの抽出

トレースログが見つからない場合 (詳細)

パフォーマンスカウンターのデータがストレージでは使用できるが、ポータルに表示されない