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
Publisher	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 Gépház területén 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 Gépház területén 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 stopOnMultiple Csatlakozás ions értékét 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.