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

Azure Monitor エージェントの概要

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

用語

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

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

1. 前提条件をこちらで注意深く確認します。

2. 拡張機能が正常にインストールされ、プロビジョニングされたことを確認します。これにより、マシンにエージェント バイナリがインストールされます。

   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
      

   3. 拡張機能が移行中の状態の場合があるので、10 分から 15 分待ちます。 それでも表示されない場合は、拡張機能をアンインストールして再度インストールし、検証を繰り返して拡張機能が表示されるかどうか確認します。
   4. されない場合、マシンの C:\ProgramData\GuestConfig\extension_logs\Microsoft.Azure.Monitor.AzureMonitorWindowsAgent にある拡張機能のログにエラーが表示されているかどうかを確認します

3. エージェントが実行されていることを確認する:

   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. 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 を AMCS サービスからダウンロードできたことを確認します:

   1. 最新の DCR が次の場所にダウンロードされているかどうかを確認します C:\Resources\Directory\AMADataStore\mcs\configchunks

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

1. DCR JSON に "performanceCounters" のセクションが含まれていることを確認します。 そうでない場合は、DCR を修正します。 DCR の作成方法またはサンプル DCR のセクションを参照してください。
2. ファイル C:\Resources\Directory\AMADataStore\mcs\mcsconfig.lkg.xml が存在することを確認してください。
3. ファイルを開き、下の例に示すように 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>
   

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

1. こちらの前提条件を慎重に確認します。

2. 関連付けられている DCR が、パフォーマンス カウンターを収集し、Azure Monitor メトリックに送信するように正しく作成されていることを確認します。 DCR に次のセクションがあります。

   "destinations": {  
   "azureMonitorMetrics": {  
       "name":"myAmMetricsDest" 
       } 
   }
   

3. Powershell コマンドを実行します。

   Get-WmiObject Win32_Process -Filter "name = 'MetricsExtension.Native.exe'" | select Name,ExecutablePath,CommandLine | Format-List
   

   出力の CommandLine パラメーターに引数 "-TokenSource MSI" が含まれていることを確認します。

4. C:\Resources\Directory\AMADataStore\mcs\AuthToken-MSI.json ファイルが存在することを確認します。

5. C:\Resources\Directory\AMADataStore\mcs\CUSTOMMETRIC_<subscription>_<region>_MonitoringAccount_Configuration.json ファイルが存在することを確認します。

6. コマンド 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 のエラーを探して修正を試みます。

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

1. DCR JSON に "windowsEventLogs" のセクションが含まれていることを確認します。 そうでない場合は、DCR を修正します。 DCR の作成方法またはサンプル DCR のセクションを参照してください。
2. ファイル C:\Resources\Directory\AMADataStore\mcs\mcsconfig.lkg.xml が存在することを確認してください。
3. ファイルを開き、下の例に示すように 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>