Windows Arc 対応サーバー上の Azure Monitor エージェントのトラブルシューティングガイダンス

[アーティクル]
07/19/2023

Azure Monitor エージェントの概要

詳細を確認する前に、Azure Monitor エージェントとデータ収集ルールについて理解しておく必要があります。

用語

名前	頭字語	説明
Azure Monitor エージェント	AMA	新しい Azure Monitor エージェント
データ収集ルール	DCR	エージェントによるデータの収集を構成するためのルール (収集対象、送信先など)
Azure Monitor 構成サービス	AMCS	Azure でホストされるリージョンサービス。このエージェントのデータ収集と Azure Monitor の他の部分を制御します。エージェントは、このサービスを呼び出して DCR をフェッチします。
ログエンドポイント	--	Log Analytics ワークスペースにデータを送信するためのエンドポイント
メトリックエンドポイント	--	Azure Monitor メトリックデータベースにデータを送信するためのエンドポイント。
Instance Metadata Service とハイブリッド	IMDS と HIMDS	現在実行中の仮想マシン、スケールセット (IMDS 経由)、Arc 対応サーバー (HIMDS 経由) に関する情報を提供する、Azure でホストされているサービス
Log Analytics ワークスペース	LAW	エージェントによって収集されたログを送信できる Azure Monitor の宛先
カスタムメトリック	--	エージェントによって収集されたゲストメトリックを送信できる Azure Monitor の宛先

基本的なトラブルシューティング手順 (インストール、エージェントが実行されていない、構成の問題)

Windows Arc 対応サーバーで実行されている Azure Monitor エージェントの最新バージョンをトラブルシューティングするには、次の手順に従います。

前提条件をこちらで注意深く確認します。
拡張機能が正常にインストールされ、プロビジョニングされたことを確認します。これにより、マシンにエージェントバイナリがインストールされます。
1. Azure portal を開き、ご使用の Arc 対応サーバーを選択し、左側のペインから [設定] : [拡張機能] を開くと、"AzureMonitorWindowsAgent" が "成功" の状態で表示されます
2. そうでない場合は、Arc エージェント (Connected Machine エージェント) が Azure に接続でき、拡張機能サービスが実行されているかどうかを確認します。
```
azcmagent show
```
  次の出力が表示されます。
```
Resource Name                           : <server name>
[...]
Dependent Service Status
  Agent Service (himds)                 : running
  GC Service (gcarcservice)             : running
  Extension Service (extensionservice)  : running
```
  代わりに Agent Status: Disconnected またはその他の状態が表示された場合は、概要を "Arc エージェントまたは拡張機能サービスが機能しません" とし、問題の種類を "Azure Monitor Windows エージェントに関するヘルプが必要です" として、チケットを提出します。
3. 拡張機能が移行中の状態の場合があるので、10 分から 15 分待ちます。それでも表示されない場合は、拡張機能をアンインストールして再度インストールし、検証を繰り返して拡張機能が表示されるかどうか確認します。
4. されない場合、マシンの C:\ProgramData\GuestConfig\extension_logs\Microsoft.Azure.Monitor.AzureMonitorWindowsAgent にある拡張機能のログにエラーが表示されているかどうかを確認します
5. 上のいずれの方法でも問題が解決しない場合は、概要を "AMA 拡張機能のインストールまたはプロビジョニングに失敗しました" とし、問題の種類を "Azure Monitor Windows エージェントに関するヘルプが必要です" としてチケットを提出します。
エージェントが実行されていることを確認する:
1. 次のクエリを使用して、エージェントが Log Analytics ワークスペースにハートビートログを出力しているかどうかを確認します。 "カスタムメトリック" が DCR の唯一の宛先の場合はスキップします。
```
Heartbeat | where Category == "Azure Monitor Agent" and Computer == "<computer-name>" | take 10
```
2. そうでない場合は、タスクマネージャーを開き、"MonAgentCore.exe" プロセスが実行されているかどうかを確認します。実行されている場合は、ハートビートが表示されるまで 5 分間待ちます。
3. 実行されていない場合は、マシンの C:\Resources\Directory\AMADataStore\Configuration にあるコアエージェントのログにエラーが表示されているかどうかを確認します
4. 上のいずれの方法でも問題が解決しない場合は、概要を "AMA 拡張機能がプロビジョニングされたが実行されない" とし、問題の種類を "Azure Monitor Windows エージェントに関するヘルプが必要です" としてチケットを提出します。
DCR が存在し、Arc 対応サーバーに関連付けられていることを確認します:
1. 宛先として Log Analytics ワークスペースを使用している場合は、DCR が Log Analytics ワークスペースと同じ物理リージョンに存在することを確認します。
2. Arc 対応サーバーで、ファイル C:\Resources\Directory\AMADataStore\mcs\mcsconfig.latest.xml が存在することを確認します。このファイルが存在しない場合は、Arc 対応サーバーが DCR に関連付けられていない可能性があります。
3. Azure portal を開き、ご使用のデータ収集ルールを選択し、左側のペインから [構成: リソース] を開くと、ここに Arc 対応サーバーが表示されます
4. 表示されていない場合は、[追加] をクリックし、リソースピッカーから Arc 対応サーバーを選択します。すべての DCR で繰り返します。
5. 上のいずれでも解決しない場合は、概要を "DCR が見つからないか関連付けられていない" とし、問題の種類を "VM からのデータ収集の構成で支援が必要です" としてチケットを提出します。
エージェントが関連付けられている DCR を AMCS サービスからダウンロードできたことを確認します:
1. 最新の DCR が次の場所にダウンロードされているかどうかを確認します C:\Resources\Directory\AMADataStore\mcs\configchunks
2. されていない場合は、概要を "AMA で DCR 構成をダウンロードできない" とし、問題の種類を "Azure Monitor Windows エージェントに関するヘルプが必要です" として、チケットを提出します。

パフォーマンスカウンターの収集に関する問題

DCR JSON に "performanceCounters" のセクションが含まれていることを確認します。そうでない場合は、DCR を修正します。 DCR の作成方法またはサンプル DCR のセクションを参照してください。
ファイル C:\Resources\Directory\AMADataStore\mcs\mcsconfig.lkg.xml が存在することを確認してください。存在しない場合は、概要を "AMA が十分に実行されずにマークされなかった" とし、問題の種類を "Azure Monitor Windows エージェントに関するヘルプが必要です" としてチケットを提出します。
ファイルを開き、次の例に示すように CounterSet ノードが含まれているかどうかを確認します。
```
<CounterSet storeType="Local" duration="PT1M" 
    eventName="c9302257006473204344_16355538690556228697" 
    sampleRateInSeconds="15" format="Factored">
    <Counter>\Processor(_Total)\% Processor Time</Counter>
    <Counter>\Memory\Committed Bytes</Counter>
    <Counter>\LogicalDisk(_Total)\Free Megabytes</Counter>
    <Counter>\PhysicalDisk(_Total)\Avg. Disk Queue Length</Counter>
</CounterSet>
```
CounterSet ノードがない場合、DCR は正しく解析されまていません。概要を "AMA で DCR 構成を解析できない" とし、問題の種類を "Azure Monitor Windows エージェントに関するヘルプが必要です" として、チケットを提出します。

"カスタムメトリック" を宛先として使用する場合の問題

こちらの前提条件を慎重に確認します。
関連付けられている DCR が、パフォーマンスカウンターを収集し、Azure Monitor メトリックに送信するように正しく作成されていることを確認します。 DCR に次のセクションがあります。
```
"destinations": {  
"azureMonitorMetrics": {  
    "name":"myAmMetricsDest" 
    } 
}
```
Powershell コマンドを実行します。
```
Get-WmiObject Win32_Process -Filter "name = 'MetricsExtension.Native.exe'" | select Name,ExecutablePath,CommandLine | Format-List
```
出力の CommandLine パラメーターに引数 "-TokenSource MSI" が含まれていることを確認します。
C:\Resources\Directory\AMADataStore\mcs\AuthToken-MSI.json ファイルが存在することを確認します。
C:\Resources\Directory\AMADataStore\mcs\CUSTOMMETRIC_<subscription>_<region>_MonitoringAccount_Configuration.json ファイルが存在することを確認します。
コマンド C:\Packages\Plugins\Microsoft.Azure.Monitor.AzureMonitorWindowsAgent\<version-number>\Monitoring\Agent\table2csv.exe C:\Resources\Directory\AMADataStore\Tables\MaMetricsExtensionEtw.tsf を実行してログを収集します
1. コマンドによってファイル 'MaMetricsExtensionEtw.csv' が生成されます。
2. それを開き、レベル 2 のエラーを探して修正を試みます。
上のいずれの方法でも問題が解決しない場合は、概要を "AMA でカスタムメトリックを収集できない" とし、問題の種類を "Azure Monitor Windows エージェントに関するヘルプが必要です" としてチケットを提出します。

Windows イベントログの収集に関する問題

DCR JSON に "windowsEventLogs" のセクションが含まれていることを確認します。そうでない場合は、DCR を修正します。 DCR の作成方法またはサンプル DCR のセクションを参照してください。
ファイル C:\Resources\Directory\AMADataStore\mcs\mcsconfig.lkg.xml が存在することを確認してください。存在しない場合は、概要を "AMA が十分に実行されずにマークされなかった" とし、問題の種類を "Azure Monitor Windows エージェントに関するヘルプが必要です" としてチケットを提出します。
ファイルを開き、次の例に示すように Subscription ノードが含まれているかどうかを確認します。
```
<Subscription eventName="c9302257006473204344_14882095577508259570" 
query="System!*[System[(Level = 1 or Level = 2 or Level = 3)]]">
    <Column name="ProviderGuid" type="mt:wstr" defaultAssignment="00000000-0000-0000-0000-000000000000">
      <Value>/Event/System/Provider/@Guid</Value>
    </Column>
    ...

    </Column>
</Subscription>
```
Subscription ノードがない場合、DCR は正しく解析されまていません。概要を "AMA で DCR 構成を解析できない" とし、問題の種類を "Azure Monitor Windows エージェントに関するヘルプが必要です" として、チケットを提出します。

チケットを提出する

データ収集規則を開き、左側のメニューで [新しいサポートリクエスト] を選択します。 [ヘルプとサポート] ペインを開き、[サポートリクエストの作成] を選択することもできます。
選択:
- [問題の種類]: 技術的。
- [サブスクリプション]: マシンが存在するサブスクリプションを選択します。
- [サービスの種類]: データ収集規則と Azure Monitor エージェント。
- [お客様の問題はリソースに関係していますか?]: はい。リソースピッカーを使用してマシンを選択します。
トラブルシューティングの手順で示されているように、概要と問題の種類を入力します。正確な情報は、問題の迅速な解決につながります。
[次へ] を選択し、推奨される解決策が役に立つかどうかを確認します。
役に立たない場合は、[次へ] を選択し、詳細の次のセットを入力します。
[次へ] を選択し、最終的な詳細を確認して、[作成] を選択します。

Windows Arc 対応サーバー上の Azure Monitor エージェントのトラブルシューティング ガイダンス

Azure Monitor エージェントの概要

用語

基本的なトラブルシューティング手順 (インストール、エージェントが実行されていない、構成の問題)

パフォーマンス カウンターの収集に関する問題

"カスタム メトリック" を宛先として使用する場合の問題

Windows イベント ログの収集に関する問題

チケットを提出する

その他のリソース

Windows Arc 対応サーバー上の Azure Monitor エージェントのトラブルシューティングガイダンス

パフォーマンスカウンターの収集に関する問題

"カスタムメトリック" を宛先として使用する場合の問題

Windows イベントログの収集に関する問題