Anleitung zur Problembehandlung für den Azure Monitor-Agent auf virtuellen Windows-Computern und Skalierungsgruppen

Artikel
01/23/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 virtuellen Windows-Computer 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 virtuellen Computer > öffnen Sie Einstellungen : Erweiterungen + Anwendungen im linken Bereich > AzureMonitorWindowsAgent sollte mit diesem Status angezeigt werden: „Bereitstellung erfolgreich“.
2. Wenn nicht, überprüfen Sie, ob der Computer Azure erreichen kann, und suchen Sie die Erweiterung zur Installation mithilfe des folgenden Befehls:
```
az vm extension image list-versions --location <machine-region> --name AzureMonitorWindowsAgent --publisher Microsoft.Azure.Monitor
```
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:\WindowsAzure\Logs\Plugins\Microsoft.Azure.Monitor.AzureMonitorWindowsAgent auf Ihrem Computer angezeigt werden
5. Wenn keine der obigen Punkte hilft, 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 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:\WindowsAzure\Resources\AMADataStore.<virtual-machine-name>\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 virtuellen Computer 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 virtuellen Computer, ob die Datei C:\WindowsAzure\Resources\AMADataStore.<virtual-machine-name>\mcs\mcsconfig.latest.xml vorhanden ist. Wenn diese Datei nicht vorhanden ist:
  - Der virtuelle Computer ist möglicherweise nicht einem DCR zugeordnet. Weitere Informationen finden Sie unter Schritt 3
  - Der virtuelle Computer hat möglicherweise keine verwaltete Identität aktiviert. Weitere Informationen zum Aktivieren finden Sie hier.
  - Der IMDS-Dienst wird vom virtuellen Computer aus nicht ausgeführt bzw. ist von ihm nicht zugänglich. Überprüfen Sie, ob Sie über den Computer auf IMDS zugreifen können. Wenn nicht, erstellen Sie ein Ticket mit der Zusammenfassung „IMDS-Dienst nicht verfügbar“ und dem Problemtyp „Ich benötige Hilfe beim Konfigurieren der Datensammlung aus einem virtuellen Computer.“.
  - AMA kann nicht auf IMDS zugreifen. Überprüfen Sie, ob IMDS-Fehler in der Datei C:\WindowsAzure\Resources\AMADataStore.<virtual-machine-name>\Tables\MAEventTable.tsf angezeigt werden. Wenn ja, erstellen Sie ein Ticket mit der Zusammenfassung „AMA kann nicht auf IMDS zugreifen“ und dem Problemtyp „Ich benötige Hilfe beim Konfigurieren der Datensammlung aus einem virtuellen Computer.“.
3. Öffnen Sie das Azure-Portal > wählen Sie Ihre Datensammlungsregel aus > öffnen Sie Konfiguration : Ressourcen im linken Bereich. Hier sollte der virtuelle Computer aufgeführt sein.
4. Falls nicht, klicken Sie auf „Hinzufügen“, und wählen Sie den virtuellen Computer über die 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:\WindowsAzure\Resources\AMADataStore.<virtual-machine-name>\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:\WindowsAzure\Resources\AMADataStore.<virtual-machine-name>\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:\WindowsAzure\Resources\AMADataStore.<virtual-machine-name>\mcs\AuthToken-MSI.json vorhanden ist.
Stellen Sie sicher, dass Datei C:\WindowsAzure\Resources\AMADataStore.<virtual-machine-name>\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:\WindowsAzure\Resources\AMADataStore.<virtual-machine-name>\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:\WindowsAzure\Resources\AMADataStore.<virtual-machine-name>\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.