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

Artikel
07/19/2023

Ü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
```
  Wenn Sie stattdessen Agent Status: Disconnected oder einen anderen Status sehen, wird von ein Ticket mit der Zusammenfassung als „Arc-Agent oder Erweiterungsdienst funktioniert nicht“ und Problemtyp als „Ich benötige Hilfe für den Azure Monitor Windows Agent“ erstellt.
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
5. Wenn keines der obigen Arbeiten funktioniert, müssen Sie ein Ticket mit Zusammenfassung als ‚AMA-Erweiterung kann nicht installiert oder bereitgestellt werden‘ und Problemtyp als Ich benötige Hilfe bei Azure Monitor Windows Agent‘ geben.
Ü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 dies, wenn ‚Benutzerdefinierte Metriken‘ das einzige Ziel im DCR 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
4. Wenn keines der obigen Arbeiten funktioniert, müssen Sie ein Ticket mit Zusammenfassung als ‚AMA-Erweiterung kann nicht installiert oder bereitgestellt werden‘ und Problemtyp als Ich benötige Hilfe bei Azure Monitor Windows Agent‘ geben.
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.
5. Sollte keiner der obigen Punkte helfen, erstellen Sie ein Ticket mit der Zusammenfassung „Datensammlungsregel nicht gefunden oder zugeordnet“ und dem Problemtyp „Ich benötige Hilfe beim Konfigurieren der Datensammlung für einen virtuellen Computer.“.
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
2. Wenn nicht, erstellen Sie ein Ticket mit Zusammenfassung als ‚AMA kann DCR-Konfiguration nicht herunterladen‘ und Problemtyp als ‚Ich benötige Hilfe bei Azure Monitor Windows Agent‘.

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. Wenn es nicht vorhanden ist, erstellen Sie ein Ticket mit Zusammenfassung als ‚AMA hat nicht lange genug ausgeführt‘, um den Problemtyp als ‚Ich benötige Hilfe bei Azure Monitor Windows Agent‘.

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

Wenn keine CounterSet-Knoten vorhanden sind, wurde der DCR nicht richtig analysiert. Erstellen Sie ein Ticket mit Zusammenfassung als ‚AMA kann DCR-Konfiguration nicht herunterladen‘ und Problemtyp als ‚Ich benötige Hilfe bei Azure Monitor Windows Agent‘.

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.
Wenn keines der obigen Arbeiten funktioniert, erstellen Sie ein Ticket mit Zusammenfassung als ‚AMA-Erweiterung kann keine benutzerdefinierten Metriken sammeln‘ und Problemtyp als Ich benötige Hilfe bei Azure Monitor Windows Agent‘.

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. Wenn es nicht vorhanden ist, erstellen Sie ein Ticket mit Zusammenfassung als ‚AMA hat nicht lange genug ausgeführt‘, um den Problemtyp als ‚Ich benötige Hilfe bei Azure Monitor Windows Agent‘.
Ö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>
```
Wenn keine Subscription-Knoten vorhanden sind, wurde der DCR nicht richtig analysiert. Erstellen Sie ein Ticket mit Zusammenfassung als ‚AMA kann DCR-Konfiguration nicht herunterladen‘ und Problemtyp als ‚Ich benötige Hilfe bei Azure Monitor Windows Agent‘.

Ticket erstellen

Öffnen Sie eine Datensammlungsregel und wählen Sie im Menü auf der linken Seite Neue Supportanfrage aus. Sie können auch den Bereich „Hilfe + Support“ öffnen und Supportanfrage erstellen auswählen.
Wählen Sie Folgendes:
- Problemtyp: Technisch.
- Abonnement: Wählen Sie das Abonnement aus, in dem sich Ihre Computer befinden.
- Diensttyp: Datensammlungsregeln und Azure Monitor-Agent.
- Hängt Ihr Problem mit einer Ressource zusammen?: Ja. Wählen Sie Ihren Computer mithilfe der Ressourcenauswahl aus.
Geben Sie die Zusammenfassung und den Problemtyp ein, die in den Schritten zur Problembehandlung angegeben sind. Genaue Informationen ermöglichen eine schnellere Auflösung des Problems.
Wählen Sie Weiter aus und überprüfen Sie, ob die empfohlenen Lösungen weiterhelfen.
Falls nicht, wählen Sie Weiter aus und geben die nächsten Details ein.
Wählen Sie Weiter aus, überprüfen Sie die letzten Details, und wählen Sie Erstellen aus.