Hibaelhárítási útmutató linuxos virtuális gépeken és méretezési csoportokon futó Azure Monitor-ügynökhöz

Cikk
06/28/2023

Az Azure Monitor-ügynök áttekintése

Mielőtt tovább olvas, ismernie kell az Azure Monitor-ügynököt és az adatgyűjtési szabályokat.

Terminológia

Name	Betűszó	Description
Azure Monitor-ügynök	AMA	Az új Azure Monitor-ügynök
Adatgyűjtési szabályok	DCR	Az ügynök által végzett adatgyűjtés konfigurálására vonatkozó szabályok, azaz a gyűjtendő adatok, a küldés helye és egyebek
Azure Monitor konfigurációs szolgáltatás	AMCS	Az Azure-ban üzemeltetett regionális szolgáltatás, amely az ügynök és az Azure Monitor más részei adatgyűjtését szabályozza. Az ügynök meghívja ezt a szolgáltatást a DCRs lekéréséhez.
Naplóvégpont	--	Végpont adatok Log Analytics-munkaterületekre való küldéséhez
Metrikák végpontja	--	Végpont adatok Azure Monitor Metrics-adatbázisokba való küldéséhez.
Példány metaadat-szolgáltatása és hibrid	IMDS és HIMDS	Az Azure-ban üzemeltetett szolgáltatások, amelyek információt nyújtanak a jelenleg futó virtuális gépekről, méretezési csoportokról (IMDS-en) és Arc-kompatibilis kiszolgálókról (HIMDS-en keresztül)
Log Analytics-munkaterület	TÖRVÉNY	Az Azure Monitor célhelye, amellyel az ügynök által gyűjtött naplókat küldheti el a következő címre:
Egyéni metrikák	--	Az Azure Monitor célhelye, amellyel elküldheti az ügynök által gyűjtött vendégmetrikákat a következő címre:

Alapvető hibaelhárítási lépések

Kövesse az alábbi lépéseket a Linux rendszerű virtuális gépen futó Azure Monitor-ügynök legújabb verziójának hibaelhárításához:

Alaposan tekintse át az előfeltételeket itt.
Ellenőrizze, hogy a bővítmény telepítése és kiépítése sikeresen megtörtént-e, amely telepíti az ügynök bináris fájljait a gépére:
1. Nyissa meg Azure Portal > válassza ki a virtuális gépet > a Beállítások megnyitása: Bővítmények + alkalmazások elem kiválasztásával a bal oldali > panelen az "AzureMonitorLinuxAgent" állapottal: "Sikeres üzembe helyezés"
2. Ha nem látja a bővítményt a listában, ellenőrizze, hogy a gép eléri-e az Azure-t, és keresse meg a telepítéshez szükséges bővítményt az alábbi paranccsal:
```
az vm extension image list-versions --location <machine-region> --name AzureMonitorLinuxAgent --publisher Microsoft.Azure.Monitor
```
3. Várjon 10–15 percet, mivel a bővítmény átmeneti állapotban lehet. Ha továbbra sem jelenik meg a fenti módon, távolítsa el és telepítse újra a bővítményt .
4. Ellenőrizze, hogy lát-e hibákat a számítógépen található /var/log/azure/Microsoft.Azure.Monitor.AzureMonitorLinuxAgent/ bővítménynaplókban
5. Ha a fentiek egyike sem segít, küldjön egy"AMA-bővítmény telepítése vagy kiépítése sikertelen" és "Segítségre van szükségem az Azure Monitor Linux-ügynökkel" típusú jegyet.
Ellenőrizze, hogy az ügynök fut-e:
1. Ellenőrizze, hogy az ügynök az alábbi lekérdezéssel küld-e szívverési naplókat a Log Analytics-munkaterületre. Hagyja ki, ha az "Egyéni metrikák" az egyetlen cél a DCR-ben:
```
Heartbeat | where Category == "Azure Monitor Agent" and Computer == "<computer-name>" | take 10
```
2. Ellenőrizze, hogy az ügynökszolgáltatás fut-e
```
systemctl status azuremonitoragent
```
3. Ellenőrizze, hogy lát-e hibákat a gépen található /var/opt/microsoft/azuremonitoragent/log/mdsd.* alapvető ügynöknaplókban
4. Ha a fentiek közül egyik sem segít, küldjön be egy jegyetaz Summary as "AMA extension provisioned de not running" (Az AMA-bővítmény kiépített, de nem fut) és a Probléma típusa "Segítségre van szükségem az Azure Monitor Linux-ügynökkel" beállítással.
Ellenőrizze, hogy a DCR létezik-e, és a virtuális géphez van-e társítva:
1. Ha a Log Analytics-munkaterületet használja célként, ellenőrizze, hogy a DCR ugyanabban a fizikai régióban található-e, mint a Log Analytics-munkaterület.
2. Nyissa meg Azure Portal > válassza ki az adatgyűjtési szabályt>: Konfiguráció megnyitása: Erőforrások a bal oldali > panelen Itt láthatja a virtuális gépet.
3. Ha nem szerepel a listában, kattintson a Hozzáadás gombra, és válassza ki a virtuális gépet az erőforrás-választóból. Ismételje meg az összes DCR-t.
4. Ha a fentiek egyike sem segít, küldjön egy "DCR nem található vagy társított" és "Segítségre van szükségem az adatgyűjtés virtuális gépről történő konfigurálásához" típusú jegyet.
Ellenőrizze, hogy az ügynök le tudta-e tölteni a társított DCR-eket az AMCS szolgáltatásból:
1. Ellenőrizze, hogy megjelenik-e a legújabb DCR letöltve erre a helyre /etc/opt/microsoft/azuremonitoragent/config-cache/configchunks/
2. Ha nem, küldjön egy "AMA nem tudja letölteni a DCR-konfigurációt" és a Probléma típusa "Segítségre van szükségem az Azure Monitor Linux-ügynökkel" típusú jegyet.

A Syslog gyűjtésével kapcsolatos problémák

Az Azure Monitor-ügynökkel kapcsolatos syslog-problémák elhárításáról itt talál további információt.

A szolgáltatásminőségi (QoS-) fájl /var/opt/microsoft/azuremonitoragent/log/mdsd.qos CSV formátumú, 15 perces összesítéseket biztosít a feldolgozott eseményekhez, és tartalmazza a feldolgozott syslog-események mennyiségére vonatkozó információkat az adott időkeretben. Ez a fájl hasznos a Syslog eseménybetöltési csökkenéseinek nyomon követéséhez.

Az alábbi töredék például azt mutatja, hogy a 2022-02-28T19:55:23.5432920Z előtti 15 percben az ügynök 77 syslog eseményt kapott létesítmény démonnal és szintinformációval, és 77 ilyen eseményt küldött a feltöltési feladatnak. Emellett az ügynök feltöltési feladata 77-et kapott, és sikeresen feltöltötte mind a 77 ilyen daemon.info üzenetet.
```
#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
```

Hibaelhárítási lépések

Először tekintse át a Linux AMA általános hibaelhárítási lépéseit . Ha az ügynök szívveréseket bocsát ki, folytassa a 2. lépésvel.
Az elemezt konfiguráció a következő helyen található: /etc/opt/microsoft/azuremonitoragent/config-cache/configchunks/. Ellenőrizze, hogy a Syslog-gyűjtemény definiálva van-e, és hogy a naplócélok megegyeznek-e a DCR felhasználói felületén /DCR JSON-ban létrehozott célhelyekkel.
1. Ha igen, folytassa a 3. lépésben. Ha nem, a probléma a konfigurációs munkafolyamatban van.
2. Vizsgálja meg a ()mdsd.warn fájlokat, és vizsgálja meg mdsd.erra mdsd.info következő fájlokat/var/opt/microsoft/azuremonitoragent/log: lehetséges konfigurációs hibák.
3. Ha a fentiek egyike sem segít, küldjön egy "Syslog DCR nem érhető el" és "Segítségre van szükségem az adatgyűjtés virtuális gépről történő konfigurálásához" típusú jegyet.
Ellenőrizze a Syslog-gyűjtemény munkafolyamatának elrendezését, hogy az összes szükséges elem rendelkezésre álljon és elérhető legyen:
1. A felhasználók esetében rsyslog győződjön meg arról, hogy a /etc/rsyslog.d/10-azuremonitoragent.conf fájl jelen van, nem üres, és a rsyslog démon (syslog-felhasználó) is elérhető.
  1. Ellenőrizze az rsyslog konfigurációját a címen /etc/rsyslog.conf , és /etc/rsyslog.d/* ellenőrizze, hogy van-e olyan bemenete, amely nem alapértelmezett szabálykészlethez van kötve, mivel az ezekből a bemenetekből érkező üzenetek nem lesznek továbbítva az Azure Monitor-ügynöknek. Például egy nem alapértelmezett szabálykészlettel input(type="imtcp" port="514" ruleset="myruleset") konfigurált bemenet üzenetei nem lesznek továbbítva.
2. A felhasználók esetében syslog-ng győződjön meg arról, hogy a /etc/syslog-ng/conf.d/azuremonitoragent.conf fájl jelen van, nem üres, és a syslog-ng démon (syslog-felhasználó) is elérhető.
3. Győződjön meg arról, hogy a fájl /run/azuremonitoragent/default_syslog.socket létezik, és elérhető rsyslog a vagy syslog-ng az által.
4. Ellenőrizze, hogy van-e megfelelő csökkenés a feldolgozott syslog-események számában a fájlban /var/opt/microsoft/azuremonitoragent/log/mdsd.qos. Ha az ilyen csökkenés nem szerepel a fájlban, küldjön egy "Syslog-adatok a folyamatban elvetett syslog-adatok" és "Segítségre van szükségem az Azure Monitor Linux-ügynökkel" típusú jegyet.
5. Ellenőrizze, hogy a syslog démonsor nem túlcsordul-e, ami a feltöltés meghiúsulását okozza. Ehhez tekintse meg az alábbi útmutatót: Az Rsyslog-adatok feltöltése nem történt meg az AMA Linux-ügynök teljes lemezterületével kapcsolatos probléma miatt

A syslog-események betöltésének további hibakereséséhez fűzze hozzá a - T 0x2002 nyomkövetési jelzőt a fájl/etc/default/azuremonitoragentMDSD_OPTIONS végén, majd indítsa újra az ügynököt:

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"

Miután a probléma reprodukálódott a nyomkövetési jelzővel, további hibakeresési információkat talál a fájlban /var/opt/microsoft/azuremonitoragent/log/mdsd.info. Vizsgálja meg a fájlban a syslog-gyűjteménysel kapcsolatos probléma lehetséges okát, például elemzési/ feldolgozási/ konfigurációs/ feltöltési hibákat.

Figyelmeztetés

A hibakeresési munkamenet után távolítsa el a -T 0x2002 nyomkövetési jelzőbeállítást, mivel számos olyan nyomkövetési utasítást generál, amelyek gyorsabban kitölthetik a lemezt, vagy megnehezíthetik a naplófájl vizuális elemzését.
Ha a fentiek egyike sem segít, küldjön egy"AMA nem gyűjti a syslog-eseményeket" és a problématípust "Segítségre van szükségem az Azure Monitor Linux-ügynökkel" szöveggel.

Az Arc-kompatibilis kiszolgálón felmerülő problémák elhárítása

Ha az alapvető hibaelhárítási lépések ellenőrzése után nem látja a naplókat kibocsátó Azure Monitor-ügynököt, vagy a naplófájlban a "Nem sikerült lekérni az MSI-jogkivonatot az IMDS-végpontról" hibaüzenet jelenik meg, akkor valószínűsyslog, hogy a felhasználó nem tagja a csoportnakhimds./var/opt/microsoft/azuremonitoragent/log/mdsd.err Felhasználó hozzáadása syslog a felhasználói csoporthoz himds , ha a felhasználó nem tagja ennek a csoportnak. Szükség esetén hozza létre a felhasználót syslog és a csoportot syslog, és győződjön meg arról, hogy a felhasználó az adott csoportban van. További információt itt talál az Azure Arc-kompatibilis kiszolgálóhitelesítési követelményekről.

Jegy küldése

Nyisson meg egy adatgyűjtési szabályt, és a bal oldali menüben válassza az Új támogatási kérelem lehetőséget. A Súgó és támogatás panelt is megnyithatja, és kiválaszthatja a Támogatási kérelem létrehozása lehetőséget.
A következők szerint válasszon:
- Probléma típusa: Műszaki.
- Előfizetés: Válassza ki azt az előfizetést, amelyben a gépek találhatók.
- Szolgáltatás típusa: Adatgyűjtési szabályok és Azure Monitor-ügynök.
- A probléma egy erőforráshoz kapcsolódik?: Igen. Válassza ki a gépet az erőforrás-választóval.
Adja meg az Összefoglalás és a Probléma típusa kifejezést a hibaelhárítási lépésekben leírtak szerint. A pontos információk a probléma gyorsabb megoldásához vezetnek.
Válassza a Tovább lehetőséget, és tekintse át az ajánlott megoldásokat, és ellenőrizze, hogy segítenek-e.
Ha nem segítenek, válassza a Tovább lehetőséget, és töltse ki a következő részleteket.
Válassza a Tovább lehetőséget, tekintse át a végső részleteket, majd válassza a Létrehozás lehetőséget.