Anleitung zur Problembehandlung für den Azure Monitor-Agent auf Windows Arc-fähigen Server

Artikel
11/14/2024

Übersicht für den Azure Monitor-Agent

Bevor Sie weiterlesen, müssen Sie mit Azure Monitor-Agent und Datensammlungsregeln vertraut sein.

Begriff

Name	Akronym	BESCHREIBUNG
Azure Monitor-Agent	AMA	Der neue Azure Monitor-Agent
Datensammlungsregeln	DCR	Regeln zum Konfigurieren der Datenerfassung durch den Agent (was gesammelt werden soll, wohin es gesendet werden soll usw.)
Azure Monitor-Konfigurationsdienst	AMCS	Der in Azure gehostete regionale Dienst steuert die Datensammlung für diesen Agent und andere Teile von Azure Monitor. Der Agent ruft diesen Dienst auf, um Datensammlungsregeln abzurufen.
Protokollendpunkt	--	Endpunkt zum Senden von Daten an Log Analytics-Arbeitsbereiche
Metrikendpunkt	--	Endpunkt zum Senden von Daten an Azure Monitor-Metrikdatenbanken.
Instance Metadata Service und Hybrid Instance Metadata Service	IMDS und HIMDS	In Azure gehostete Dienste, die Informationen zu derzeit ausgeführten virtuellen Computern, zu Skalierungsgruppen (über IMDS) und zu Servern mit Arc-Unterstützung (über HIMDS) bereitstellen
Log Analytics-Arbeitsbereich	LAW	Das Ziel in Azure Monitor, an das Sie vom Agent gesammelte Protokolle senden können
Benutzerdefinierte Metriken	--	Das Ziel in Azure Monitor, an das Sie vom Gastmetriken gesammelte Protokolle senden können

Grundlegende Schritte zur Problembehandlung (Installation, Agent nicht ausgeführt, Konfigurationsprobleme)

Führen Sie die folgenden Schritte aus, um die neueste Version des Azure Monitor-Agents zu beheben, der auf Ihrem Windows Arc-aktivierten Server ausgeführt wird:

Überprüfen Sie sorgfältig die Voraussetzungen hier.
Vergewissern Sie sich, dass die Erweiterung erfolgreich installiert und bereitgestellt wurde. Dadurch werden die Agent-Binärdateien auf Ihrem Computer installiert:
1. Öffnen Sie das Azure-Portal > wählen Sie Ihren Arc-fähigen Server aus > öffnen Sie Einstellungen : Erweiterungen im linken Bereich > AzureMonitorWindowsAgent sollte mit diesem Status angezeigt werden: „Erfolgreich“.
2. Wenn nicht, überprüfen Sie, ob der Arc-Agent (Verbundener Computer-Agent) eine Verbindung mit Azure herstellen kann und der Erweiterungsdienst ausgeführt wird.
```
azcmagent show
```
  Sie sollten die folgende Ausgabe sehen:
```
Resource Name                           : <server name>
[...]
Dependent Service Status
  Agent Service (himds)                 : running
  GC Service (gcarcservice)             : running
  Extension Service (extensionservice)  : running
```
3. Warten Sie 10-15 Minuten, da die Erweiterung möglicherweise im Übergangsstatus angezeigt wird. Wenn die Erweiterung weiterhin nicht angezeigt wird, deinstallieren Sie die Erweiterung erneut und wiederholen die Überprüfung, um die Erweiterung anzuzeigen.
4. Wenn nicht, überprüfen Sie, ob Fehler in Erweiterungsprotokollen bei C:\ProgramData\GuestConfig\extension_logs\Microsoft.Azure.Monitor.AzureMonitorWindowsAgent auf Ihrem Computer angezeigt werden
Überprüfen Sie, ob der Agent ausgeführt wird:
1. Überprüfen Sie mithilfe der folgenden Abfrage, ob der Agent Heartbeatprotokolle an den Log Analytics-Arbeitsbereich sendet. Überspringen Sie diese Überprüfung, wenn „Benutzerdefinierte Metriken“ das einzige Ziel in der Datensammlungsregel ist:
```
Heartbeat | where Category == "Azure Monitor Agent" and Computer == "<computer-name>" | take 10
```
2. Wenn nicht, öffnen Sie den Task-Manager und überprüfen Sie, ob der Prozess ‚MonAgentCore.exe‘ ausgeführt wird. Wenn es so ist, warten Sie 5 Minuten, bis der Takt angezeigt wird.
3. Wenn nicht, überprüfen Sie, ob Fehler in Erweiterungsprotokollen bei C:\Resources\Directory\AMADataStore\Configuration auf Ihrem Computer angezeigt werden
Stellen Sie sicher, dass der DCR vorhanden und dem Arc-aktivierten Server zugeordnet ist:
1. Wenn Sie den Log Analytics-Arbeitsbereich als Ziel verwenden, stellen Sie sicher, dass DCR in derselben physischen Region wie der Log Analytics-Arbeitsbereich vorhanden ist.
2. Überprüfen Sie auf Ihrem Arc-fähigen Server das Vorhandensein der Datei C:\Resources\Directory\AMADataStore\mcs\mcsconfig.latest.xml. Wenn diese Datei nicht vorhanden ist, ist der Arc-aktivierte Server möglicherweise keinem DCR zugeordnet.
3. Öffnen Sie das Azure-Portal > wählen Sie Ihre Datensammlungsregel aus > öffnen Sie Konfiguration : Ressourcen im linken Bereich. Hier sollte der Arc-fähige Server aufgeführt sein.
4. Wenn diese Option nicht aufgeführt ist, klicken Sie auf ‚Hinzufügen‘ und wählen Sie den Arc-aktivierten Server aus der Ressourcenauswahl aus. Wiederholen Sie alle DCRs.
Vergewissern Sie sich, dass der Agent die zugeordneten Datensammlungsregeln aus dem AMCS-Dienst herunterladen konnte:
1. Überprüfen Sie, ob der neueste DCR an diesem Speicherort heruntergeladen wird C:\Resources\Directory\AMADataStore\mcs\configchunks

Fehler bei gesammelten Leistungsindikatoren

Überprüfen Sie, ob Ihr DCR-JSON einen Abschnitt für ‚performanceCounters‘ enthält. Wenn nicht, beheben Sie Ihren DCR. Erfahren Sie, wie Sie DCR oder Beispiel-DCR erstellen.
Überprüfen Sie, ob die Datei C:\Resources\Directory\AMADataStore\mcs\mcsconfig.lkg.xml vorhanden ist.

Öffnen Sie die Datei und überprüfen Sie, ob sie Knoten enthält CounterSet, wie im folgenden Beispiel gezeigt:

<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>

Probleme bei der Verwendung von ‚Benutzerdefinierte Metriken‘ als Ziel

Überprüfen Sie sorgfältig die Voraussetzungen hier.
Stellen Sie sicher, dass der zugeordnete DCR ordnungsgemäß erstellt wird, um Leistungsindikatoren zu sammeln und sie an Azure Monitor-Metriken zu senden. Dieser Abschnitt sollte in Ihrem DCR angezeigt werden:
```
"destinations": {  
"azureMonitorMetrics": {  
    "name":"myAmMetricsDest" 
    } 
}
```
Führen Sie den PowerShell-Befehl aus:
```
Get-WmiObject Win32_Process -Filter "name = 'MetricsExtension.Native.exe'" | select Name,ExecutablePath,CommandLine | Format-List
```
Stellen Sie sicher, dass der CommandLine-Parameter in der Ausgabe das Argument „-TokenSource MSI" enthält
Stellen Sie sicher, dass Datei C:\Resources\Directory\AMADataStore\mcs\AuthToken-MSI.json vorhanden ist.
Stellen Sie sicher, dass Datei C:\Resources\Directory\AMADataStore\mcs\CUSTOMMETRIC_<subscription>_<region>_MonitoringAccount_Configuration.json vorhanden ist.
Sammeln Sie Protokolle durch Ausführen des Befehls C:\Packages\Plugins\Microsoft.Azure.Monitor.AzureMonitorWindowsAgent\<version-number>\Monitoring\Agent\table2csv.exe C:\Resources\Directory\AMADataStore\Tables\MaMetricsExtensionEtw.tsf
1. Der Befehl generiert die Datei ‚MaMetricsExtensionEtw.csv‘
2. Öffnen Sie sie und suchen Sie nach allen Fehlern der Ebene 2 und versuchen Sie, sie zu beheben.

Probleme beim Sammeln von Windows Ereignisprotokollen

Überprüfen Sie, ob Ihr DCR-JSON einen Abschnitt für „windowsEventLogs" enthält. Wenn nicht, beheben Sie Ihren DCR. Erfahren Sie, wie Sie DCR oder Beispiel-DCR erstellen.
Überprüfen Sie, ob die Datei C:\Resources\Directory\AMADataStore\mcs\mcsconfig.lkg.xml vorhanden ist.

Öffnen Sie die Datei und überprüfen Sie, ob sie Knoten enthält Subscription, wie im folgenden Beispiel gezeigt:

<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>

Freigeben über