Richtlijnen voor probleemoplossing voor de Azure Monitor-agent op virtuele Linux-machines en schaalsets

Artikel
11/14/2024

Overzicht voor Azure Monitor-agent

Voordat u verder leest, moet u bekend zijn met azure Monitor-agent en regels voor gegevensverzameling.

Terminologie

Naam	Acroniem	Beschrijving
Azure Monitor-agent	AMA	De nieuwe Azure Monitor-agent
Gegevensverzamelingsregels	DCR	Regels voor het configureren van het verzamelen van gegevens door de agent, bijvoorbeeld wat moet worden verzameld, waar naar moet worden verzonden en meer
Azure Monitor Configuration Service	AMCS	Regionale service die wordt gehost in Azure, waarmee het verzamelen van gegevens voor deze agent en andere onderdelen van Azure Monitor wordt beheerd. De agent roept deze service aan om DCR's op te halen.
Eindpunt van logboeken	--	Eindpunt voor het verzenden van gegevens naar Log Analytics-werkruimten
Eindpunt voor metrische gegevens	--	Eindpunt voor het verzenden van gegevens naar metrische azure Monitor-databases.
Service voor exemplaarmetagegevens en hybride	IMDS en HIMDS	Services die worden gehost in Azure die informatie bieden over momenteel actieve virtuele machines, schaalsets (via IMDS) en servers met Arc (via HIMDS) respectievelijk
Log Analytics-werkruimte	WET	De bestemming in Azure Monitor waarnaar u logboeken kunt verzenden die door de agent zijn verzameld
Aangepaste metrische gegevens	--	De bestemming in Azure Monitor waarnaar u metrische gegevens van gasten kunt verzenden die door de agent zijn verzameld

Basisstappen voor probleemoplossing

Volg de onderstaande stappen om problemen op te lossen met de nieuwste versie van de Azure Monitor-agent die wordt uitgevoerd op uw virtuele Linux-machine:

Bekijk hier zorgvuldig de vereisten.
Controleer of de extensie is geïnstalleerd en ingericht, waarmee de binaire bestanden van de agent op uw computer worden geïnstalleerd:
1. Open Azure Portal > selecteer de instellingen voor openen van uw virtuele machine >: Extensies en toepassingen in het deelvenster aan de linkerkant > 'AzureMonitorLinuxAgent' moet worden weergegeven met de status: 'Inrichten voltooid'
2. Als u de extensie niet ziet, controleert u of de machine Azure kan bereiken en zoekt u de extensie die u wilt installeren met behulp van de onderstaande opdracht:
```
az vm extension image list-versions --location <machine-region> --name AzureMonitorLinuxAgent --publisher Microsoft.Azure.Monitor
```
3. Wacht 10-15 minuten als verlenging mogelijk in de overgangsstatus. Als deze nog steeds niet wordt weergegeven zoals hierboven, verwijdert en installeert u de extensie opnieuw.
4. Controleer of er fouten worden weergegeven in extensielogboeken op /var/log/azure/Microsoft.Azure.Monitor.AzureMonitorLinuxAgent/ uw computer
Controleer of de agent wordt uitgevoerd:
1. Controleer of de agent heartbeatlogboeken verzendt naar de Log Analytics-werkruimte met behulp van de onderstaande query. Overslaan als 'Aangepaste metrische gegevens' de enige bestemming is in de DCR:
```
Heartbeat | where Category == "Azure Monitor Agent" and Computer == "<computer-name>" | take 10
```
2. Controleren of de agentservice wordt uitgevoerd
```
systemctl status azuremonitoragent
```
3. Controleer of er fouten worden weergegeven in de kernagentlogboeken op /var/opt/microsoft/azuremonitoragent/log/mdsd.* uw computer
Controleer of de DCR bestaat en is gekoppeld aan de virtuele machine:
1. Als u Log Analytics-werkruimte als doel gebruikt, controleert u of DCR bestaat in dezelfde fysieke regio als de Log Analytics-werkruimte.
2. Open Azure Portal > selecteer uw regel > voor het verzamelen van gegevens: Resources in het deelvenster aan de linkerkant>. U ziet de virtuele machine die hier wordt vermeld.
3. Als deze niet wordt weergegeven, klikt u op Toevoegen en selecteert u de virtuele machine in de resourcekiezer. Herhaal dit voor alle DCR's.
Controleer of de agent de gekoppelde DCR(s) kan downloaden van de AMCS-service:
1. Controleer of u de meest recente DCR ziet die op deze locatie is gedownload /etc/opt/microsoft/azuremonitoragent/config-cache/configchunks/

Problemen met het verzamelen van Syslog

Zie hier voor meer informatie over het oplossen van syslog-problemen met de Azure Monitor-agent.

Het QoS-bestand /var/opt/microsoft/azuremonitoragent/log/mdsd.qos (Quality of Service) biedt 15 minuten aggregaties met CSV-indeling van de verwerkte gebeurtenissen en bevat de informatie over de hoeveelheid verwerkte syslog-gebeurtenissen in de opgegeven periode. Dit bestand is handig bij het bijhouden van syslog-gebeurtenisopnamen.

In het onderstaande fragment ziet u bijvoorbeeld dat de agent in de 15 minuten voorafgaand aan 2022-02-28T19:55:23.5432920Z 77 syslog-gebeurtenissen met facility daemon en niveaugegevens heeft ontvangen en 77 van deze gebeurtenissen naar de uploadtaak heeft verzonden. Daarnaast heeft de uploadtaak van de agent 77 ontvangen en alle 77 van deze daemon.info berichten geüpload.

#Time: 2022-02-28T19:55:23.5432920Z
#Fields: Operation,Object,TotalCount,SuccessCount,Retries,AverageDuration,AverageSize,AverageDelay,TotalSize,TotalRowsRead,TotalRowsSent
...
MaRunTaskLocal,daemon.debug,15,15,0,60000,0,0,0,0,0
MaRunTaskLocal,daemon.info,15,15,0,60000,46.2,0,693,77,77
MaRunTaskLocal,daemon.notice,15,15,0,60000,0,0,0,0,0
MaRunTaskLocal,daemon.warning,15,15,0,60000,0,0,0,0,0
MaRunTaskLocal,daemon.error,15,15,0,60000,0,0,0,0,0
MaRunTaskLocal,daemon.critical,15,15,0,60000,0,0,0,0,0
MaRunTaskLocal,daemon.alert,15,15,0,60000,0,0,0,0,0
MaRunTaskLocal,daemon.emergency,15,15,0,60000,0,0,0,0,0
...
MaODSRequest,https://e73fd5e3-ea2b-4637-8da0-5c8144b670c8_LogManagement,15,15,0,455067,476.467,0,7147,77,77

Stappen voor probleemoplossing

Bekijk eerst de algemene stappen voor het oplossen van problemen met Linux AMA. Als de agent heartbeats verzendt, gaat u verder met stap 2.
De geparseerde configuratie wordt opgeslagen op /etc/opt/microsoft/azuremonitoragent/config-cache/configchunks/. Controleer of de Syslog-verzameling is gedefinieerd en of de logboekbestemmingen hetzelfde zijn als die zijn gemaakt in de DCR-gebruikersinterface/DCR JSON.
1. Zo ja, ga dan verder met stap 3. Als dat niet het probleem is, bevindt het zich in de configuratiewerkstroom.
2. Onderzoek mdsd.err,mdsd.warn, mdsd.info bestanden onder /var/opt/microsoft/azuremonitoragent/log voor mogelijke configuratiefouten.
Valideer de indeling van de Syslog-verzamelingswerkstroom om ervoor te zorgen dat alle benodigde onderdelen aanwezig zijn en toegankelijk zijn:
1. Controleer rsyslog voor gebruikers of het /etc/rsyslog.d/10-azuremonitoragent.conf bestand aanwezig is, niet leeg is en toegankelijk is voor de rsyslog daemon (syslog-gebruiker).
  1. Controleer uw rsyslog-configuratie op /etc/rsyslog.conf en /etc/rsyslog.d/* om te zien of er invoer is gebonden aan een niet-standaardregelset, omdat berichten van deze invoer niet worden doorgestuurd naar de Azure Monitor-agent. Berichten van een invoer die is geconfigureerd met een niet-standaardregelset, worden input(type="imtcp" port="514" ruleset="myruleset") bijvoorbeeld niet doorgestuurd.
2. Controleer syslog-ng voor gebruikers of het /etc/syslog-ng/conf.d/azuremonitoragent.conf bestand aanwezig is, niet leeg is en toegankelijk is voor de syslog-ng daemon (syslog-gebruiker).
3. Zorg ervoor dat het bestand /run/azuremonitoragent/default_syslog.socket bestaat en toegankelijk is voor rsyslog of syslog-ng respectievelijk.
4. Controleer of de syslog-daemon-wachtrij niet overloopt, waardoor het uploaden mislukt door de richtlijnen hier te verwijzen: Rsyslog-gegevens die niet zijn geüpload vanwege een probleem met volledige schijfruimte in de AMA Linux-agent

Als u de opname van syslog-gebeurtenissen verder wilt opsporen, kunt u traceringsvlag -T 0x2002 toevoegen aan het einde van MDSD_OPTIONS in het bestand /etc/default/azuremonitoragenten de agent opnieuw starten:

export MDSD_OPTIONS="-A -c /etc/opt/microsoft/azuremonitoragent/mdsd.xml -d -r $MDSD_ROLE_PREFIX -S $MDSD_SPOOL_DIRECTORY/eh -L $MDSD_SPOOL_DIRECTORY/events -e $MDSD_LOG_DIR/mdsd.err -w $MDSD_LOG_DIR/mdsd.warn -o $MDSD_LOG_DIR/mdsd.info -T 0x2002"

Nadat het probleem is gereproduceerd met de traceringsvlag, vindt u meer informatie over foutopsporing in /var/opt/microsoft/azuremonitoragent/log/mdsd.info. Controleer het bestand op de mogelijke oorzaak van het probleem met de syslog-verzameling, zoals parseren/verwerken/configureren/uploadfouten.

Waarschuwing

Zorg ervoor dat u de instelling voor traceringsvlaggen -T 0x2002 na de foutopsporingssessie verwijdert, omdat er veel traceringsinstructies worden gegenereerd die de schijf sneller kunnen vullen of het logboekbestand visueel kunnen parseren.

Problemen met server met Arc oplossen

Als u na het controleren van de basisstappen voor probleemoplossing de Azure Monitor-agent geen logboeken ziet verzenden of de fouten 'MSI-token niet ophalen van IMDS-eindpunt' in het logboekbestand vindt, is de gebruiker waarschijnlijk syslog geen lid van de groephimds/var/opt/microsoft/azuremonitoragent/log/mdsd.err. Voeg syslog een gebruiker toe aan himds de gebruikersgroep als de gebruiker geen lid is van deze groep. Maak indien nodig een gebruiker syslog en de groep syslogen zorg ervoor dat de gebruiker zich in die groep bevindt. Raadpleeg hier de vereisten voor serververificatie met Azure Arc voor meer informatie.

Delen via