Log Analytics virtuális gépi bővítmény Linuxhoz
Áttekintés
Az Azure Monitor-naplók monitorozási, riasztási és riasztás-szervizelési képességeket biztosítanak a felhőben és a helyszíni objektumokban. A Linuxhoz készült Log Analytics virtuálisgép-bővítményt a Microsoft közzéteszi és támogatja. A bővítmény telepíti a Log Analytics-ügynököt az Azure-beli virtuális gépekre, és regisztrálja a virtuális gépeket egy meglévő Log Analytics-munkaterületre. Ez a dokumentum a LinuxHoz készült Log Analytics virtuálisgép-bővítmény támogatott platformjait, konfigurációit és üzembehelyezési lehetőségeit ismerteti.
Feljegyzés
Az Azure Arc-kompatibilis kiszolgálók lehetővé teszik a Log Analytics-ügynök virtuálisgép-bővítményének üzembe helyezését, eltávolítását és frissítését nem Azure-beli Windows- és Linux-gépekre, leegyszerűsítve a hibrid gép felügyeletét az életciklusuk során. További információ: Virtuálisgép-bővítmények kezelése Azure Arc-kompatibilis kiszolgálókkal.
Előfeltételek
Operációs rendszer
A támogatott Linux-disztribúciókkal kapcsolatos részletekért tekintse meg az Azure Monitor-ügynökök áttekintését ismertető cikket.
Ügynök és virtuálisgép-bővítmény verziója
Az alábbi táblázat az egyes kiadásokhoz tartozó Log Analytics virtuálisgép-bővítmény és Log Analytics-ügynökcsomag verziójának leképezését tartalmazza. A csomag tartalmazza a Log Analytics-ügynök csomagverziójának kibocsátási megjegyzéseire mutató hivatkozást. A kibocsátási megjegyzések tartalmazzák az adott ügynök kiadásához elérhető hibajavítások és új funkciók részleteit.
Log Analytics Linux rendszerű virtuálisgép-bővítmény verziója | A Log Analytics-ügynök csomagverziója |
---|---|
1.19.0 | 1.19.0 |
1.18.1 | 1.18.1 |
1.17.2 | 1.17.2 |
1.17.1 | 1.17.1 |
1.16.0 | 1.16.0 |
1.14.23 | 1.14.23 |
1.14.20 | 1.14.20 |
1.14.19 | 1.14.19 |
1.14.16 | 1.14.16 |
1.14.13 | 1.14.13 |
1.14.11 | 1.14.11 |
1.14.9 | 1.14.9 |
1.13.40 | 1.13.40 |
1.13.35 | 1.13.35 |
1.13.33 | 1.13.33 |
1.13.27 | 1.13.27 |
1.13.15 | 1.13.9-0 |
1.12.25 | 1.12.15-0 |
1.11.15 | 1.11.0-9 |
1.10.0 | 1.10.0-1 |
1.9.1 | 1.9.0-0 |
1.8.11 | 1.8.1-256 |
1.8.0 | 1.8.0-256 |
1.7.9 | 1.6.1-3 |
1.6.42.0 | 1.6.0-42 |
1.4.60.2 | 1.4.4-210 |
1.4.59.1 | 1.4.3-174 |
1.4.58.7 | 14.2-125 |
1.4.56.5 | 1.4.2-124 |
1.4.55.4 | 1.4.1-123 |
1.4.45.3 | 1.4.1-45 |
1.4.45.2 | 1.4.0-45 |
1.3.127.5 | 1.3.5-127 |
1.3.127.7 | 1.3.5-127 |
1.3.18.7 | 1.3.4-15 |
Microsoft Defender for Cloud
Felhőhöz készült Microsoft Defender automatikusan kiépíteni a Log Analytics-ügynököt, és egy alapértelmezett Log Analytics-munkaterülethez csatlakoztatja, amelyet Felhőhöz készült Defender hozott létre az Azure-előfizetésében. Ha Felhőhöz készült Microsoft Defender használ, ne futtassa végig a dokumentum lépéseit. Ezzel felülírja a konfigurált munkaterületet, és megszakítja a kapcsolatot Felhőhöz készült Microsoft Defender.
Internetkapcsolat
A Linuxhoz készült Log Analytics-ügynökbővítményhez a cél virtuális gépnek csatlakoznia kell az internethez.
Bővítményséma
Az alábbi JSON a Log Analytics-ügynök bővítmény sémáját mutatja be. A bővítményhez szükség van a munkaterület azonosítójára és a munkaterület kulcsára a cél Log Analytics-munkaterületről; ezek az értékek az Azure Portal Log Analytics-munkaterületén találhatók. Mivel a munkaterületkulcsot bizalmas adatokként kell kezelni, védett beállításkonfigurációban kell tárolni. Az Azure-beli virtuálisgép-bővítmények által védett beállításadatok titkosítva lesznek, és csak a cél virtuális gépen lesznek visszafejtve. Vegye figyelembe, hogy a workspaceId és a workspaceKey megkülönbözteti a kis- és nagybetűket.
Feljegyzés
Mivel a tárolómonitorozási megoldás kivonása folyamatban van, az alábbi dokumentáció a "skipDockerProviderInstall" opcionális beállítást használja: igaz.
{
"type": "Microsoft.Compute/virtualMachines/extensions",
"name": "OMSExtension",
"apiVersion": "2018-06-01",
"location": "<location>",
"dependsOn": [
"[concat('Microsoft.Compute/virtualMachines/', <vm-name>)]"
],
"properties": {
"publisher": "Microsoft.EnterpriseCloud.Monitoring",
"type": "OmsAgentForLinux",
"typeHandlerVersion": "1.16",
"autoUpgradeMinorVersion": true,
"settings": {
"workspaceId": "myWorkspaceId",
"skipDockerProviderInstall": true
},
"protectedSettings": {
"workspaceKey": "myWorkSpaceKey"
}
}
}
Feljegyzés
A fenti séma feltételezi, hogy a sablon gyökérszintjén lesz elhelyezve. Ha a sablonban a virtuálisgép-erőforrásba helyezi, a tulajdonságokat és name
a type
tulajdonságokat módosítani kell, a további leírásnak megfelelően.
Tulajdonságértékek
Név | Érték/ Példa |
---|---|
apiVersion | 2018-06-01 |
kiadó | Microsoft.EnterpriseCloud.Monitoring |
típus | OmsAgentForLinux |
typeHandlerVersion | 1.16 |
workspaceId (pl. | 6f680a37-00c6-41c7-a93f-1437e3462574 |
workspaceKey (pl. | z4bU3p1/GrnWpQky4gdabWXAhbWSTz70hm4m2Xt92XI+rSRgE8qVvRhsGo9TXffbrTahyrwv35W0pOqQAU7uQ== |
Sablonalapú telepítés
Feljegyzés
A Log Analytics virtuálisgép-bővítmény egyes összetevőit a Diagnosztikai virtuális gép bővítményben is szállítjuk. Az architektúra miatt ütközések léphetnek fel, ha mindkét bővítményt ugyanabban az ARM-sablonban példányosítjuk. A telepítési idő ütközéseinek elkerülése érdekében az dependsOn
irányelv használatával győződjön meg arról, hogy a bővítmények egymás után vannak telepítve. A bővítmények bármelyik sorrendben telepíthetők.
Az Azure-beli virtuálisgép-bővítmények Azure Resource Manager-sablonokkal telepíthetők. A sablonok ideálisak egy vagy több olyan virtuális gép üzembe helyezésekor, amelyek üzembe helyezés utáni konfigurációt igényelnek, például az Azure Monitor-naplókba való előkészítéshez. A Log Analytics-ügynök virtuálisgép-bővítményét tartalmazó Resource Manager-mintasablon az Azure rövid útmutatógyűjteményében található.
A virtuálisgép-bővítmény JSON-konfigurációja beágyazható a virtuálisgép-erőforrásba, vagy elhelyezhető egy Resource Manager JSON-sablon gyökér- vagy legfelső szintjén. A JSON-konfiguráció elhelyezése befolyásolja az erőforrás nevét és típusát. További információ: A gyermekerőforrások nevének és típusának beállítása.
Az alábbi példa feltételezi, hogy a virtuálisgép-bővítmény a virtuálisgép-erőforrásba van ágyazva. A bővítményerőforrás beágyazásakor a JSON a "resources": []
virtuális gép objektumába kerül.
{
"type": "extensions",
"name": "OMSExtension",
"apiVersion": "2018-06-01",
"location": "<location>",
"dependsOn": [
"[concat('Microsoft.Compute/virtualMachines/', <vm-name>)]"
],
"properties": {
"publisher": "Microsoft.EnterpriseCloud.Monitoring",
"type": "OmsAgentForLinux",
"typeHandlerVersion": "1.16",
"settings": {
"workspaceId": "myWorkspaceId",
"skipDockerProviderInstall": true
},
"protectedSettings": {
"workspaceKey": "myWorkSpaceKey"
}
}
}
Amikor a JSON bővítményt a sablon gyökerénél helyezi el, az erőforrás neve hivatkozik a szülő virtuális gépre, és a típus a beágyazott konfigurációt tükrözi.
{
"type": "Microsoft.Compute/virtualMachines/extensions",
"name": "<parentVmResource>/OMSExtension",
"apiVersion": "2018-06-01",
"location": "<location>",
"dependsOn": [
"[concat('Microsoft.Compute/virtualMachines/', <vm-name>)]"
],
"properties": {
"publisher": "Microsoft.EnterpriseCloud.Monitoring",
"type": "OmsAgentForLinux",
"typeHandlerVersion": "1.16",
"settings": {
"workspaceId": "myWorkspaceId",
"skipDockerProviderInstall": true
},
"protectedSettings": {
"workspaceKey": "myWorkSpaceKey"
}
}
}
Azure CLI üzemelő példány
Az Azure CLI használatával üzembe helyezheti a Log Analytics-ügynök virtuálisgép-bővítményét egy meglévő virtuális gépen. Cserélje le az alábbi myWorkspaceKey értéket a munkaterületkulcsra és a myWorkspaceId értékre a munkaterület-azonosítóra. Ezek az értékek a Log Analytics-munkaterületen, az Azure Portal Speciális beállítások csoportjában találhatók. Cserélje le a legújabbVersion értéket a Log Analytics Linux virtuálisgép-bővítményének verziójára.
az vm extension set \
--resource-group myResourceGroup \
--vm-name myVM \
--name OmsAgentForLinux \
--publisher Microsoft.EnterpriseCloud.Monitoring \
--protected-settings '{"workspaceKey":"myWorkspaceKey"}' \
--settings '{"workspaceId":"myWorkspaceId","skipDockerProviderInstall": true}' \
--version latestVersion
Azure PowerShell üzembe helyezése
Az Azure PowerShell-parancsmagok a Log Analytics-ügynök virtuálisgép-bővítményének üzembe helyezésére használhatók egy meglévő virtuális gépen. Cserélje le az alábbi myWorkspaceKey értéket a munkaterületkulcsra és a myWorkspaceId értékre a munkaterület-azonosítóra. Ezek az értékek a Log Analytics-munkaterületen, az Azure Portal Speciális beállítások csoportjában találhatók. Cserélje le a legújabbVersion értéket a Log Analytics Linux virtuálisgép-bővítményének verziójára.
Set-AzVMExtension \
-ResourceGroupName myResourceGroup \
-VMName myVM \
-ExtensionName OmsAgentForLinux \
-ExtensionType OmsAgentForLinux \
-Publisher Microsoft.EnterpriseCloud.Monitoring \
-TypeHandlerVersion latestVersion \
-ProtectedSettingString '{"workspaceKey":"myWorkspaceKey"}' \
-SettingString '{"workspaceId":"myWorkspaceId","skipDockerProviderInstall": true}'
Hibaelhárítás és támogatás
Hibaelhárítás
A bővítménytelepítések állapotával kapcsolatos adatok az Azure Portalról, valamint az Azure CLI vagy az Azure PowerShell használatával kérhetők le. Egy adott virtuális gép bővítményeinek üzembehelyezési állapotának megtekintéséhez futtassa az alábbi parancsot, ha az Azure CLI-t használja.
az vm extension list --resource-group myResourceGroup --vm-name myVM -o table
A bővítmény-végrehajtás kimenetét az alábbi fájlba naplózza a rendszer:
/var/log/azure/Microsoft.EnterpriseCloud.Monitoring.OmsAgentForLinux/extension.log
A virtuális gépen telepített OMS-bővítményverzió lekéréséhez futtassa a következő parancsot, ha Azure CLI-t használ.
az vm extension show --resource-group myResourceGroup --vm-name myVM --instance-view
A virtuális gépen telepített OMS-bővítményverzió lekéréséhez futtassa az alábbi parancsot, ha az Azure PowerShellt használja.
Get-AzVMExtension -ResourceGroupName my_resource_group -VMName my_vm_name -Name OmsAgentForLinux -Status
Hibakódok és jelentésük
Hibakód | Értelmezés | Lehetséges művelet |
---|---|---|
9 | Idő előtti meghívás engedélyezése | Frissítse az Azure Linux-ügynököt a legújabb elérhető verzióra. |
10 | A virtuális gép már csatlakozik egy Log Analytics-munkaterülethez | Ha a virtuális gépet a bővítménysémában megadott munkaterülethez szeretné csatlakoztatni, állítsa a stopOnMultipleConnections beállítást hamisra a nyilvános beállításokban, vagy távolítsa el ezt a tulajdonságot. Ez a virtuális gép minden egyes csatlakoztatott munkaterület után egyszer lesz számlázva. |
11 | Érvénytelen konfigurációt adott meg a bővítmény | Kövesse az előző példákat az üzembe helyezéshez szükséges összes tulajdonságérték beállításához. |
17 | A Log Analytics-csomag telepítési hibája | |
18 | Az OMSConfig-csomag telepítése nem sikerült. | Tekintse át a gyökérhiba parancskimenetét. |
19 | OMI-csomag telepítési hibája | |
20 | SCX-csomag telepítési hibája | |
33 | Hiba történt az omsconfig metakonfigurációjának létrehozásakor. | Küldjön egy GitHub-problémát a kimenet részleteivel. |
51 | Ez a bővítmény nem támogatott a virtuális gép operációs rendszerében | |
52 | Ez a bővítmény egy hiányzó függőség vagy engedély miatt meghiúsult | A kimenetben és a naplókban további információt talál arról, hogy melyik függőség vagy engedély hiányzik. |
53 | Ez a bővítmény hiányzó vagy helytelen konfigurációs paraméterek miatt meghiúsult | A kimenetben és a naplókban további információt talál arról, hogy mi történt. Emellett ellenőrizze a munkaterület-azonosító helyességét, és ellenőrizze, hogy a gép csatlakozik-e az internethez. |
55 | Nem lehet csatlakozni az Azure Monitor szolgáltatáshoz, vagy a szükséges csomagok hiányoznak, vagy a dpkg-csomagkezelő zárolva van | Ellenőrizze, hogy a rendszer rendelkezik-e internet-hozzáféréssel, vagy hogy rendelkezik-e érvényes HTTP-proxyval. Emellett ellenőrizze a munkaterület-azonosító helyességét, és ellenőrizze, hogy telepítve vannak-e a curl és a tar segédprogramok. |
További hibaelhárítási információk a Log Analytics-Agent-for-Linux hibaelhárítási útmutatójában találhatók.
Támogatás
Ha a cikk bármely pontján további segítségre van szüksége, forduljon az Azure szakértőihez az MSDN Azure és a Stack Overflow fórumain. Másik lehetőségként Azure-támogatás incidenst is beszedhet. Lépjen a Azure-támogatás webhelyre, és válassza a Támogatás kérése lehetőséget. Az Azure-támogatás használatáról a Microsoft Azure-támogatás GYIK-ben talál további információt.