Dela via

Log Analytics-tillägg för virtuella datorer för Linux

  • Artikel

Översikt

Azure Monitor-loggar tillhandahåller funktioner för övervakning, avisering och aviseringsreparation i molnresurser och lokala tillgångar. Log Analytics-tillägget för virtuella datorer för Linux publiceras och stöds av Microsoft. Tillägget installerar Log Analytics-agenten på virtuella Azure-datorer och registrerar virtuella datorer i en befintlig Log Analytics-arbetsyta. Det här dokumentet beskriver de plattformar, konfigurationer och distributionsalternativ som stöds för Log Analytics-tillägget för virtuella datorer för Linux.

Kommentar

Med Azure Arc-aktiverade servrar kan du distribuera, ta bort och uppdatera Log Analytics-agentens VM-tillägg till datorer som inte är Azure Windows- och Linux-datorer, vilket förenklar hanteringen av hybriddatorn genom deras livscykel. Mer information finns i Hantering av VM-tillägg med Azure Arc-aktiverade servrar.

Förutsättningar

Operativsystem

Mer information om de Linux-distributioner som stöds finns i artikeln Översikt över Azure Monitor-agenter .

Agent- och VM-tilläggsversion

Följande tabell innehåller en mappning av versionen av Log Analytics VM-tillägget och Log Analytics-agentpaketet för varje version. En länk till viktig information för Log Analytics-agentsamlingsversionen ingår. Viktig information innehåller information om felkorrigeringar och nya funktioner som är tillgängliga för en viss agentversion.

Log Analytics Linux VM-tilläggsversion Log Analytics Agent-paketversion
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

Microsoft Defender för molnet etablerar automatiskt Log Analytics-agenten och ansluter den till en standardarbetsyta för Log Analytics som skapats av Defender för molnet i din Azure-prenumeration. Om du använder Microsoft Defender för molnet ska du inte gå igenom stegen i det här dokumentet. Detta skriver över den konfigurerade arbetsytan och bryter anslutningen med Microsoft Defender för molnet.

Internet-anslutning

Log Analytics-agenttillägget för Linux kräver att den virtuella måldatorn är ansluten till Internet.

Tilläggsschema

Följande JSON visar schemat för Log Analytics-agenttillägget. Tillägget kräver arbetsyte-ID och arbetsytenyckel från log analytics-målarbetsytan. Dessa värden finns i Log Analytics-arbetsytan i Azure-portalen. Eftersom arbetsytenyckeln ska behandlas som känsliga data bör den lagras i en konfiguration för skyddad inställning. Azure VM-tilläggsskyddade inställningsdata krypteras och dekrypteras endast på den virtuella måldatorn. Observera att workspaceId och workspaceKey är skiftlägeskänsliga.

Kommentar

Eftersom containerövervakningslösningen dras tillbaka använder följande dokumentation den valfria inställningen "skipDockerProviderInstall": true.

{
  "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"
    }
  }
}

Kommentar

Schemat ovan förutsätter att det placeras på mallens rotnivå. Om du placerar den i den virtuella datorresursen i mallen type bör egenskaperna och name ändras enligt beskrivningen längre ned.

Egenskapsvärden

Name Värde/exempel
apiVersion 2018-06-01
Publisher Microsoft.EnterpriseCloud.Monitoring
type OmsAgentForLinux
typeHandlerVersion 1.16
workspaceId (t.ex.) 6f680a37-00c6-41c7-a93f-1437e3462574
workspaceKey (t.ex.) z4bU3p1/GrnWpQkky4gdabWXAhbWSTz70hm4m2Xt92XI+rSRgE8qVvRhsGo9TXffbrTahyrwv35W0pOqQAU7uQ==

Malldistribution

Kommentar

Vissa komponenter i Log Analytics VM-tillägget levereras också i tillägget för den virtuella diagnostikdatorn. På grund av den här arkitekturen kan konflikter uppstå om båda tilläggen instansieras i samma ARM-mall. Undvik dessa konflikter vid installationstid genom att använda dependsOn direktivet för att säkerställa att tilläggen installeras sekventiellt. Tilläggen kan installeras i båda ordningarna.

Azure VM-tillägg kan distribueras med Azure Resource Manager-mallar. Mallar är idealiska när du distribuerar en eller flera virtuella datorer som kräver konfiguration efter distributionen, till exempel registrering till Azure Monitor-loggar. En Resource Manager-exempelmall som innehåller log analytics-agentens VM-tillägg finns i Azure-snabbstartsgalleriet.

JSON-konfigurationen för ett tillägg för en virtuell dator kan kapslas i den virtuella datorresursen eller placeras på rot- eller toppnivå i en Resource Manager JSON-mall. Placeringen av JSON-konfigurationen påverkar värdet för resursnamnet och typen. Mer information finns i Ange namn och typ för underordnade resurser.

I följande exempel förutsätts att VM-tillägget är kapslat i den virtuella datorresursen. När du kapslade tilläggsresursen placeras JSON i objektet för den "resources": [] virtuella datorn.

{
  "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"
    }
  }
}

När du placerar tilläggets JSON i mallens rot innehåller resursnamnet en referens till den överordnade virtuella datorn, och typen återspeglar den kapslade konfigurationen.

{
  "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-distribution

Azure CLI kan användas för att distribuera Log Analytics-agentens VM-tillägg till en befintlig virtuell dator. Ersätt myWorkspaceKey-värdet nedan med din arbetsytenyckel och värdet myWorkspaceId med ditt arbetsyte-ID. Dessa värden finns i Log Analytics-arbetsytan i Azure-portalen under Avancerad Inställningar. Ersätt värdet latestVersion med en version från Log Analytics Linux VM-tilläggsversion.

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-distribution

Azure Powershell-cmdletarna kan användas för att distribuera Log Analytics-agentens VM-tillägg till en befintlig virtuell dator. Ersätt myWorkspaceKey-värdet nedan med din arbetsytenyckel och värdet myWorkspaceId med ditt arbetsyte-ID. Dessa värden finns i Log Analytics-arbetsytan i Azure-portalen under Avancerad Inställningar. Ersätt värdet latestVersion med en version från Log Analytics Linux VM-tilläggsversion.

Set-AzVMExtension \
  -ResourceGroupName myResourceGroup \
  -VMName myVM \
  -ExtensionName OmsAgentForLinux \
  -ExtensionType OmsAgentForLinux \
  -Publisher Microsoft.EnterpriseCloud.Monitoring \
  -TypeHandlerVersion latestVersion \
  -ProtectedSettingString '{"workspaceKey":"myWorkspaceKey"}' \
  -SettingString '{"workspaceId":"myWorkspaceId","skipDockerProviderInstall": true}'

Felsökning och support

Felsöka

Data om tillståndet för tilläggsdistributioner kan hämtas från Azure-portalen och med hjälp av Azure CLI eller Azure Powershell. Om du vill se distributionstillståndet för tillägg för en viss virtuell dator kör du följande kommando om du använder Azure CLI.

az vm extension list --resource-group myResourceGroup --vm-name myVM -o table

Utdata för tilläggskörning loggas i följande fil:

/var/log/azure/Microsoft.EnterpriseCloud.Monitoring.OmsAgentForLinux/extension.log

Om du vill hämta OMS-tilläggsversionen som är installerad på en virtuell dator kör du följande kommando om du använder Azure CLI.

az vm extension show --resource-group myResourceGroup --vm-name myVM --instance-view

Om du vill hämta OMS-tilläggsversionen som är installerad på en virtuell dator kör du följande kommando om du använder Azure PowerShell.

Get-AzVMExtension -ResourceGroupName my_resource_group  -VMName my_vm_name -Name OmsAgentForLinux -Status

Felkoder och deras betydelser

Felkod Innebörd Möjlig åtgärd
9 Aktivera anropad i förtid Uppdatera Azure Linux-agenten till den senaste tillgängliga versionen.
10 Den virtuella datorn är redan ansluten till en Log Analytics-arbetsyta Om du vill ansluta den virtuella datorn till den arbetsyta som anges i tilläggsschemat anger du stopOnMultiple Anslut ions till false i offentliga inställningar eller tar bort den här egenskapen. Den här virtuella datorn debiteras en gång för varje arbetsyta som den är ansluten till.
11 Ogiltig konfiguration som angetts för tillägget Följ föregående exempel för att ange alla egenskapsvärden som krävs för distributionen.
17 Installationsfel för Log Analytics-paket
18 Installationen av OMSConfig-paketet misslyckades. Titta igenom kommandoutdata för rotfelet.
19 Installationsfel för OMI-paket
20 Installationsfel för SCX-paket
33 Det gick inte att generera metakonfiguration för omsconfig. Ange ett GitHub-problem med information från utdata.
51 Det här tillägget stöds inte i den virtuella datorns åtgärdssystem
52 Det här tillägget misslyckades på grund av ett beroende eller behörighet som saknas Kontrollera utdata och loggar för mer information om vilket beroende eller behörighet som saknas.
53 Det här tillägget misslyckades på grund av saknade eller felaktiga konfigurationsparametrar Kontrollera utdata och loggar för mer information om vad som gick fel. Kontrollera dessutom att arbetsyte-ID:t är korrekt och kontrollera att datorn är ansluten till Internet.
55 Det går inte att ansluta till Azure Monitor-tjänsten eller nödvändiga paket som saknas eller dpkg-pakethanteraren är låst Kontrollera att systemet antingen har internetåtkomst eller att en giltig HTTP-proxy har angetts. Kontrollera dessutom att arbetsyte-ID:t är korrekt och kontrollera att curl- och tjärverktyg är installerade.

Ytterligare felsökningsinformation finns i felsökningsguiden för Log Analytics-Agent-for-Linux.

Support

Om du behöver mer hjälp när som helst i den här artikeln kan du kontakta Azure-experterna på MSDN Azure- och Stack Overflow-forumen. Du kan också skapa en Azure-supportincident. Gå till Azure-supportwebbplatsen och välj Hämta support. Information om hur du använder Azure Support finns i Vanliga frågor och svar om Microsoft Azure-support.